Skip to content

docs: Comprehensive documentation for configurable agents feature#247

Merged
dlorenc merged 2 commits intomainfrom
multiclaude/bold-hawk
Jan 23, 2026
Merged

docs: Comprehensive documentation for configurable agents feature#247
dlorenc merged 2 commits intomainfrom
multiclaude/bold-hawk

Conversation

@dlorenc
Copy link
Copy Markdown
Owner

@dlorenc dlorenc commented Jan 23, 2026

Summary

  • Add "Agent Definitions" commands subsection to README.md with CLI reference for multiclaude agents commands
  • Add "Configurable Agents" section to README.md explaining the customization system
  • Update directory structure documentation to include agent definition directories
  • Add CLI commands reference and practical example to AGENTS.md
  • Update docs/DIRECTORY_STRUCTURE.md with agent definition paths and precedence

Context

Issue #233 added configurable agents but documentation was incomplete and scattered. This PR consolidates the documentation across the relevant files.

Changes

README.md

  • Added "Agent Definitions" subsection after "Agent Commands" with multiclaude agents list/reset/spawn examples
  • Added "Configurable Agents" section explaining what can be customized, how to customize, sharing with team, and precedence order
  • Updated Directory Structure to include repos/<repo>/agents/ and reference to repo-checked definitions

AGENTS.md

  • Added CLI commands for managing agent definitions
  • Added step-by-step example of customizing worker behavior for a project

docs/DIRECTORY_STRUCTURE.md

  • Added repos/<repo-name>/agents/ directory entry
  • Added sections for repository-checked agent definitions and built-in templates
  • Documented precedence order

Test plan

  • Verify go build ./cmd/multiclaude passes
  • Review all changes for consistency with existing documentation style
  • Verify SPEC.md already has accurate references (no changes needed)

🤖 Generated with Claude Code

Add documentation for the configurable agents system introduced in #233:

- README.md: Add "Agent Definitions" commands subsection with CLI reference
- README.md: Add "Configurable Agents" section explaining customization
- README.md: Update directory structure to include agents directories
- AGENTS.md: Add CLI commands and practical example for customizing workers
- docs/DIRECTORY_STRUCTURE.md: Document agent definition directories and precedence

The documentation covers:
- How to list, reset, and spawn custom agents
- Where agent definitions are stored (local vs repo-checked)
- Precedence order for agent definitions
- Step-by-step example of customizing worker conventions
- How to share definitions with team members

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@dlorenc dlorenc added the multiclaude PRs created by multiclaude workers label Jan 23, 2026
Run `go generate ./pkg/config` to update DIRECTORY_STRUCTURE.md
to reflect the removal of the per-repo agent definitions system.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@dlorenc dlorenc merged commit 916bea1 into main Jan 23, 2026
6 checks passed
aronchick pushed a commit to aronchick/multiclaude that referenced this pull request Feb 18, 2026
…orenc#247)

* docs: Comprehensive documentation for configurable agents feature

Add documentation for the configurable agents system introduced in dlorenc#233:

- README.md: Add "Agent Definitions" commands subsection with CLI reference
- README.md: Add "Configurable Agents" section explaining customization
- README.md: Update directory structure to include agents directories
- AGENTS.md: Add CLI commands and practical example for customizing workers
- docs/DIRECTORY_STRUCTURE.md: Document agent definition directories and precedence

The documentation covers:
- How to list, reset, and spawn custom agents
- Where agent definitions are stored (local vs repo-checked)
- Precedence order for agent definitions
- Step-by-step example of customizing worker conventions
- How to share definitions with team members


* chore: Regenerate docs after agent definition removal

Run `go generate ./pkg/config` to update DIRECTORY_STRUCTURE.md
to reflect the removal of the per-repo agent definitions system.


---------

Co-authored-by: Test User <test@example.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

multiclaude PRs created by multiclaude workers

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant