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

@@ -20,6 +20,11 @@ The install script creates symlinks from `~/.claude/skills/` to this repo, makin
| log | `/log` | End-of-session logging — captures decisions, gotchas, open questions to `memory/log/`. Prunes old reflected logs. |
| reflect-logs | `/reflect-logs` | Processes session logs into topic memory files, deduplicates, flags stale entries. Run periodically. |
| distill-best-practices | `/distill-best-practices` | Cross-project best practices distillation into `claude-foundations/best-practices/`. Interactive — proposes changes for approval. |
| context-load | `/context-load` | Reload project context (CLAUDE.md, MEMORY.md, etc.) after `/clear` or mid-session context loss |
| linter | `/linter` | Audit and manage project formatters/linters. Scan mode checks setup; run mode formats all files. |
| housekeeping | `/housekeeping` | Cross-project health check: git status, unreflected logs, skill validation, pipeline recommendations |
| decompose | `/decompose <task>` | Break a task into subtasks with dependency graph. Writes `.agent-tasks.json` for container agent orchestration. |
| orchestrate | `/orchestrate` | Check task state, launch container agents in git worktrees. Use `/loop 2m /orchestrate` for auto-polling. |
## Adding a New Skill