Skip to content

Conversation

@agent-relay
Copy link
Contributor

@agent-relay agent-relay bot commented Jan 8, 2026

Summary

Refactored lead agent guidelines to be more concise while incorporating practical insights from coordinating complex multi-agent sessions.

Key Improvements

  1. Consolidated Core Principles (4→6)

    • Added emphasis on isolation (separate branches/PRs prevent chaos)
    • Added documentation strategy (trails/beads for future context)
    • Added communication cadence importance
    • Added key insight: "Investigate blockers deeply, but delegate the fix"
  2. New Section: When to Spawn vs Assign

    • Clear guidance on when to spawn specialized agents
    • Blocker investigation strategy
    • Agent release process
  3. Streamlined Workflow

    • Reduced from 6 detailed steps to 6 concise bullets
    • Removed redundant examples and duplicate patterns
    • More actionable, less prescriptive
  4. Anti-Patterns with Examples

    • Simplified to concrete ❌→✅ comparisons
    • Easier to remember and apply
  5. File Size Reduction

    • 179 lines → 120 lines (reduced by 33%)
    • Clearer focus without losing guidance

Learnings Incorporated

  • Delegation effectiveness: Proper delegation enables parallel work and quality
  • Documentation matters: Trails/beads help future agents understand context
  • Isolation prevents chaos: Separate branches/PRs keep work clean and reviewable
  • Blocker strategy: Investigate root cause, propose solution, spawn agent to implement
  • Communication: Regular check-ins keep team aligned

Changes

  • .claude/agents/lead.md: Consolidated and improved guidelines

- Consolidated core principles from 4 to 6 (added isolation & documentation)
- Added key insight: investigate blockers deeply, but delegate the fix
- Added blocker investigation strategy (spawning agents for complex fixes)
- Removed redundant workflow details, streamlined to 6-step process
- Improved anti-patterns with concrete examples
- Simplified decision framework and escalation criteria
- Removed duplicate session summary patterns
- Reduced file by ~100 lines while adding practical insights
- Better focus on delegation and not getting deep into implementation

Key learnings from session:
- Proper delegation enables parallel work and better quality
- Documentation (trails/beads) helps future agents understand context
- Isolation prevents chaos and keeps work reviewable
- Investigate blockers but spawn agents for fixes
@khaliqgant
Copy link
Collaborator

@willwashburn want to build out more of the these, but the most important right now IMO is the Lead.

@khaliqgant khaliqgant merged commit 2cbdc03 into main Jan 8, 2026
6 checks passed
@khaliqgant khaliqgant deleted the improve/lead-agent-guidelines branch January 8, 2026 23:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants