plan-execution
Plan Execution
Execute plans by detecting the right mode from context, dispatching agents, and verifying results.
Mode Detection
| Mode | When to Use | Details |
|---|---|---|
| Subagent (default) | Plan directory with manifest.json, independent tasks, current session | Fresh agent per task, two-stage review. See references/execution-modes.md |
| Batch | User wants separate session, or plan has 10+ tasks | Checkpoint-based execution, 3 tasks per batch. See references/execution-modes.md |
| Parallel dispatch | 2+ independent tasks, no formal plan needed (e.g., multiple unrelated test failures) | One agent per problem domain, no plan required. See references/execution-modes.md |
| Team | User says "team", tasks need ongoing collaboration | Named agents, wave-based coordination. See references/execution-modes.md |
Model Selection
| Tier | Model | Use For |
|---|---|---|
| Heavy | Opus | Implementation, complex debugging, architecture |
| Medium | Sonnet | Code review, analysis, planning |
| Light | Haiku | Formatting, simple lookups, validation checks |
Universal Rules
- Max 4 concurrent agents to avoid resource contention
- Explicit file ownership per agent -- no two agents modify the same file
- Agents read briefing files from disk -- never paste full briefing content inline
- Re-read manifest.json at wave boundaries to recover state after context compaction
- Include return format constraint in every spawn prompt (token budget + structure)
- Stop and ask when blocked -- don't guess. See references/guardrails.md
Prompt Templates
- prompts/implementer.md -- dispatch template for implementation agents
- prompts/spec-reviewer.md -- spec compliance review template
- prompts/code-quality-reviewer.md -- code quality review template
References
- references/execution-modes.md -- detailed process for each mode
- references/orchestration-patterns.md -- agent spawn rules, templates, common mistakes
- references/guardrails.md -- stop conditions, cleanup, stale plan detection
Integration
Required skills: git-workflow (worktrees, stack), writing-plans (creates plans this skill executes)
More from hjewkes/agent-skills
self-improve
Use when a session produced reusable insights, when the user says "learn from this", "remember this", or "improve yourself", or after completing a complex task where patterns were discovered
65md-render
Use when asked to render, preview, or view a markdown file in the browser. Triggers on "render markdown", "preview this", "show me this document", "open in browser".
21code-review
Unified code review system — dispatches the right review agents for the situation. Use when reviewing code for quality, bugs, compliance, or before merging.
17skills-management
Use when creating, finding, installing, reviewing, or managing Claude Code skills — covers skill authoring, discovery, conventions, and lifecycle management
14github-pr
GitHub PR workflow — creating PRs, posting automated review comments, managing PR feedback cycles. Use when code is reviewed and ready for GitHub.
14buildkite
Buildkite CI/CD integration. Use when the user needs to check build status, trigger builds, read build logs, debug failures, manage pipelines, or any Buildkite workflow. Triggers include "buildkite", "build", "pipeline", "CI", "deploy", "build log", "build failed".
14