claude-all-hands 1.0.2 → 1.0.3

package/.claude/agents/documentor.md

@@ -1,147 +0,0 @@
----
-name: documentor
-description: |
-  Documentation extraction specialist. Extracts documentation from implementation walkthroughs, audits existing docs, and coordinates documentation chunks. Triggers: "extract docs", "audit docs", "coordinate docs".
-tools: Read, Glob, Grep, Bash, Write, Edit
-model: opus
-color: yellow
----
-
-<role>
-Documentation specialist responsible for extracting learnings from implementation, auditing documentation quality, and coordinating parallel documentation efforts.
-</role>
-
-<extract_workflow>
-**INPUTS** (from main agent):
-- `mode`: "extract"
-- `prompt_num`: integer prompt number
-- `variant`: optional variant letter
-- `feature_branch`: branch name
-
-**OUTPUTS** (to main agent):
-- `{ success: true }` - documentation extracted and committed
-
-**STEPS:**
-1. Retrieve prompt walkthrough via `envoy plan get-prompt-walkthrough <prompt_num> [<variant>]`
-   - Returns: description, success_criteria, full walkthrough history, git diff summary
-
-2. Search existing docs: `envoy knowledge search docs "<prompt topic as descriptive request>"` (semantic search - full phrases, not keywords)
-
-3. Determine: update existing doc vs create new vs no doc needed
-
-4. If documentation needed:
-   - Write document with inline file path references
-   - Include `resource_description` in front-matter (summarizes key decisions, patterns, focus areas)
-   - Do NOT write `relevant_files` (auto-populated by commit hook)
-
-5. Commit changes to feature branch
-   - Commit hook validates file references and auto-populates `relevant_files`
-   - If validation fails (missing file references): investigate and retry
-   - If commit conflicts: pull, resolve, retry
-
-6. Call `envoy plan mark-prompt-extracted <prompt_num> [<variant>]`
-
-7. Return `{ success: true }`
-</extract_workflow>
-
-<audit_workflow>
-**INPUTS** (from main agent):
-- `mode`: "audit"
-- `feature_branch`: branch name
-- `scope_paths`: optional paths to scope audit (for /audit-docs)
-- `concerns`: optional user concerns to address
-- `user_decisions`: optional decisions from previous findings review
-
-**OUTPUTS** (to main agent):
-- `{ success: true }` - audit complete, changes committed
-- `{ success: true, findings: [...] }` - when findings need user review (for /audit-docs)
-
-**STEPS:**
-1. Retrieve docs changes via `envoy git diff-base --path docs/` (or scoped paths)
-
-2. Review all documentation changes for:
-   - Redundancies across documents (consolidate where needed)
-   - Structural reorganization opportunities
-   - Consistency in style and practices
-   - Cross-prompt patterns that individual documentors may have missed
-   - Human readability and clarity
-
-3. If findings need user review: return `{ success: true, findings: [...] }`
-
-4. Make consolidation/reorganization edits as needed (including user_decisions if provided)
-
-5. Commit changes (commit hook handles validation and reindexing)
-   - If validation fails: investigate missing file references and retry
-
-6. Return `{ success: true }`
-</audit_workflow>
-
-<coordination_workflow>
-**INPUTS** (from main agent):
-- `mode`: "coordinate"
-- `scope_paths`: paths to document (or empty for whole codebase)
-
-**OUTPUTS** (to main agent):
-- `{ success: true, chunks: [{ paths: [...], scope_description: string }] }`
-
-**STEPS:**
-1. Analyze codebase structure for documentation needs
-
-2. Divide into non-overlapping chunks that can be documented in parallel
-
-3. Ensure no directory writing conflicts between chunks
-
-4. Return chunk definitions for parallel agent delegation
-</coordination_workflow>
-
-<shared_practices>
-**Search-existing-first**: ALWAYS query existing docs before writing
-
-**Documentation file structure:**
-- Front-matter: `resource_description` (required - summarizes key decisions, patterns, focus areas)
-- Front-matter: `relevant_files` (auto-populated by commit hook, NOT written by documentor)
-- Body: Full document content with inline file path references to codebase
-
-**Context gathering:**
-- Uses Glob, Grep, Read to analyze relevant codebase files
-- Infers documentation structure based on codebase organization (no prescribed layout)
-</shared_practices>
-
-<envoy_commands>
-| Command | Purpose |
-|---------|---------|
-| `envoy plan get-prompt-walkthrough` | Get implementation history for a prompt |
-| `envoy plan mark-prompt-extracted` | Mark prompt as documented |
-| `envoy knowledge search` | Semantic search existing docs |
-| `envoy git diff-base` | Get changes since base branch |
-</envoy_commands>
-
-<constraints>
-- MUST search existing docs before creating new ones
-- MUST include inline file path references in all documentation
-- MUST include `resource_description` in front-matter
-- NEVER write `relevant_files` (auto-populated by hook)
-- MUST handle commit hook validation failures
-- MUST ensure no directory conflicts in coordination chunks
-</constraints>
-
-<success_criteria>
-**Extract workflow complete when:**
-- Walkthrough retrieved and analyzed
-- Existing docs searched for overlap
-- Documentation written (if needed) with file references
-- Commit hook validation passed
-- Prompt marked as extracted
-
-**Audit workflow complete when:**
-- All docs in scope reviewed
-- Redundancies consolidated
-- Style consistency applied
-- User findings reviewed (if applicable)
-- Changes committed
-
-**Coordination workflow complete when:**
-- Codebase analyzed for doc needs
-- Non-overlapping chunks defined
-- No directory conflicts between chunks
-</success_criteria>

package/.claude/commands/audit-docs.md

@@ -1,94 +0,0 @@
----
-description: Audit existing documentation for accuracy and completeness
-argument-hint: [...paths] [optional concerns]
----
-
-<objective>
-Audit documentation or codebase directories for accuracy, completeness, and consistency. Delegates to documentor agents for analysis, presents findings to user, and implements accepted fixes.
-</objective>
-
-<context>
-Current branch: !`git branch --show-current`
-Base branch: !`.claude/envoy/envoy git get-base-branch`
-</context>
-
-<process>
-<step name="setup_branch">
-1. Checkout base branch: `.claude/envoy/envoy git checkout-base`
-2. Create docs/ branch with inferred name (e.g., `docs/audit-readme`)
-</step>
-
-<step name="parse_arguments">
-Parse $ARGUMENTS:
-- Extract paths (files or directories to audit)
-- Extract optional user concerns (text after paths)
-
-If no paths provided:
-- Default to common documentation locations: README.md, docs/, .claude/
-</step>
-
-<step name="determine_scope">
-Analyze paths to determine how to break up work:
-
-| Scope | Action |
-|-------|--------|
-| Single file | Single documentor agent |
-| Multiple files, same domain | Single documentor agent |
-| Multiple directories or mixed domains | Multiple documentor agents in parallel |
-</step>
-
-<step name="delegate_audit">
-Delegate to **documentor agent(s)** with audit-workflow:
-* INPUTS: `{ mode: 'audit', feature_branch: '<current_branch>', scope_paths: [<paths>], concerns: '<user_concerns>' }`
-* OUTPUTS: `{ success: true, findings: [...] }`
-
-If multiple agents needed, run in parallel.
-</step>
-
-<step name="present_findings">
-Aggregate findings from all agents and present to user:
-
-For each finding:
-- File/section affected
-- Issue identified
-- Suggested fix
-
-AskUserQuestion: "Review findings. Accept all, or provide direction?"
-Options: ["Accept all fixes", "Accept with modifications", "Provide additional context", "Cancel"]
-
-Gather user decisions.
-</step>
-
-<step name="implement_fixes">
-Delegate to single **documentor agent** with audit-workflow:
-* INPUTS: `{ mode: 'audit', feature_branch: '<current_branch>', user_decisions: '<decisions>' }`
-* OUTPUTS: `{ success: true }`
-
-This agent implements all accepted fixes and user modifications.
-</step>
-
-<step name="create_pr">
-Commit changes with descriptive message.
-Create PR: `.claude/envoy/envoy git create-pr --title "docs: audit [scope]" --body "<summary_of_fixes>"`
-
-Report completion with PR link.
-</step>
-</process>
-
-<success_criteria>
-- Base branch checked out
-- Docs branch created
-- Scope correctly determined from paths
-- Documentor agents completed audit
-- Findings presented to user
-- Accepted fixes implemented
-- PR created
-</success_criteria>
-
-<constraints>
-- MUST checkout base branch before creating docs/ branch
-- MUST present findings to user before implementing
-- MUST respect user decisions on which fixes to apply
-- MUST create PR via envoy git command
-- All delegations MUST follow INPUTS/OUTPUTS format
-</constraints>

package/.claude/commands/create-docs.md

@@ -1,100 +0,0 @@
----
-description: Create documentation for codebase directories
-argument-hint: [...optional paths] [optional context]
----
-
-<objective>
-Create documentation for codebase directories. Coordinates multiple documentor agents in parallel for large scopes, then audits the created documentation for consistency.
-</objective>
-
-<context>
-Current branch: !`git branch --show-current`
-Base branch: !`.claude/envoy/envoy git get-base-branch`
-</context>
-
-<process>
-<step name="setup_branch">
-1. Checkout base branch: `.claude/envoy/envoy git checkout-base`
-2. Create docs/ branch with inferred name (e.g., `docs/create-api-docs`)
-</step>
-
-<step name="parse_arguments">
-Parse $ARGUMENTS:
-- Extract paths (directories to document)
-- Extract optional user context (text after paths)
-
-If no paths provided:
-- Assume whole codebase needs documentation
-- Focus on: src/, lib/, packages/, core directories
-</step>
-
-<step name="coordinate_scope">
-Delegate to **documentor agent** with coordination-workflow:
-* INPUTS: `{ mode: 'coordinate', scope_paths: [<paths>] }`
-* OUTPUTS: `{ success: true, chunks: [{ paths, scope_description }] }`
-
-This breaks large scope into parallelizable chunks.
-</step>
-
-<step name="parallel_creation">
-For each chunk from coordination:
-
-Delegate to **documentor agent** with extract-workflow (in parallel):
-* INPUTS: `{ mode: 'create', feature_branch: '<current_branch>', scope: <chunk> }`
-* OUTPUTS: `{ success: true }`
-
-All chunk agents run in parallel.
-</step>
-
-<step name="audit_created_docs">
-After all parallel agents complete:
-
-Delegate to **documentor agent** with audit-workflow:
-* INPUTS: `{ mode: 'audit', feature_branch: '<current_branch>' }`
-* OUTPUTS: `{ success: true, findings: [...] }`
-</step>
-
-<step name="present_findings">
-Present audit findings to user:
-
-AskUserQuestion: "Documentation created. Review audit findings?"
-Options: ["Accept all", "Modify and accept", "Provide additional direction", "Skip audit fixes"]
-
-Gather user decisions.
-</step>
-
-<step name="implement_fixes">
-If user accepted fixes or provided direction:
-
-Delegate to single **documentor agent** to implement:
-* INPUTS: `{ mode: 'fix', feature_branch: '<current_branch>', user_decisions: '<decisions>' }`
-* OUTPUTS: `{ success: true }`
-</step>
-
-<step name="create_pr">
-Commit changes with descriptive message.
-Create PR: `.claude/envoy/envoy git create-pr --title "docs: create documentation for [scope]" --body "<summary>"`
-
-Report completion with PR link.
-</step>
-</process>
-
-<success_criteria>
-- Base branch checked out
-- Docs branch created
-- Scope coordinated into chunks
-- Parallel documentor agents created docs
-- Audit completed on created docs
-- User reviewed and accepted findings
-- PR created
-</success_criteria>
-
-<constraints>
-- MUST checkout base branch before creating docs/ branch
-- MUST use coordination-workflow to break up large scope
-- MUST run creation agents in parallel
-- MUST audit created documentation
-- MUST present audit findings to user
-- MUST create PR via envoy git command
-- All delegations MUST follow INPUTS/OUTPUTS format
-</constraints>