Add decompose + orchestrate skills with operational improvements

New skills for container agent task orchestration:
- /decompose: break tasks into subtasks with dependency graph, write .agent-tasks.json
- /orchestrate: check task state, launch container agents in git worktrees, poll for completion

Updated with learnings from first real run (agent-runtimes M3, 9 tasks):
- Prompts must end with "run pytest and fix failures"
- State import conventions explicitly in prompts
- Warn about uncommitted files before decomposing (worktrees need committed content)
- Copy dependency outputs into downstream worktrees before launching

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Paul O'Reilly
2026-03-24 23:29:43 +13:00
parent c10bbacb64
commit e8e572e0af
6 changed files with 335 additions and 2 deletions

View File

@@ -13,8 +13,15 @@ custom-claude-skills/
├── scripts/
│ └── install.sh # Symlinks all skills into ~/.claude/skills/
└── skills/
── reflect/
└── SKILL.md # Milestone reflection skill
── context-load/SKILL.md # Reload project context
├── decompose/SKILL.md # Task decomposition for container agents
├── distill-best-practices/SKILL.md # Cross-project best practices
├── housekeeping/SKILL.md # Cross-project health check
├── linter/SKILL.md # Format/lint audit and execution
├── log/SKILL.md # End-of-session logging
├── orchestrate/SKILL.md # Container agent dispatch with git worktrees
├── reflect/SKILL.md # Milestone reflection
└── reflect-logs/SKILL.md # Process logs into memory
```
## Conventions