execplan-implement
ExecPlan implementation workflow. Use when implementing ExecPlans and you are the parent agent. Do not use if you are a subagent being delegated to.
- License 许可
- MIT
- 所属仓库
- japurcell/skills
- 最近更新
- 2026-11-11
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- execplan-implement
- description
- ExecPlan implementation workflow. Use when implementing ExecPlans and you are the parent agent. Do not use if you are a subagent being delegated to.
- compatibility
- Requires subagent dispatch with model controls and effort controls when the route requires explicit effort.
02 资源文件 3
- 参考文档evals/evals.json21.9 KB
- 参考文档evals/README.md782 B
- 参考文档references/message.md1.3 KB
03 SKILL.md 正文
You have been provided an ExecPlan. This plan should have tasks and milestones associated with it, describing how to implement the plan.
The goal is the entire plan implemented on a single integration branch, with every task and milestone resolved.
The tasks are not a list of steps. They are a task graph with blocking relationships between them. This means there is always a frontier of tasks which are ready to be grabbed.
Subagent management rules:
- Activate the
subagent-model-routerskill. - For every subagent dispatch, use
subagent-model-routerto obtain its final dispatchable route, and apply its model and effort policy through dispatch controls. Stop on a named blocker. - Use the router’s model unless the user explicitly names an exact model; do not ask them to choose. Authorization is not model selection. Separately check task authorization, control permissions, and live acceptance of the model and required effort (only under
explicitpolicy). Report specific blockers without confusing permission with capability or bypassing router policy. - Implementer subagents should be run in the background where possible for maximum concurrency.
- Communication to and from subagents should be sparse. Communicate primarily through context pointers: to the plan, tasks, research notes, and previous commits. Don't duplicate information already available via pointers.
- Delegate integration to one persistent integration coordinator subagent. Reuse it across merge waves, progress updates, and final checks. The coordinator should also handle deterministic commits and status checks directly when safe.
Enforce limits for exploration, implementation, review, and fixes. An agent is idle only with no outstanding assignment; dependency waits remain active.
All commits must follow commit message guidelines.
Runtime enforcement
- Record each background assignment you dispatch, including reuse. Before dispatch, set a deadline based on expected effort and complexity. Record the routed model and its exact explicit effort or host-default omission. Track task and agent IDs, start time, extension count (initially zero), and enforcement handle as available.
- Arm enforcement before waiting. Use a host timeout or parent-owned scheduler bounded by the nearest assignment or checkpoint deadline. Independently time out blocking operations. Recheck deadlines whenever control returns, including after user interruptions.
- At expiry, request status, completed work, blockers, and updated ETA by a bounded checkpoint deadline. Keep overdue work under a deadline. On timely status, confirm completion, stop the worker, or grant its only ETA-based extension. If extended, record the new deadline, increment the count, and re-arm enforcement. Preserve the count across follow-ups. Stop the worker on a missed checkpoint or expired extension.
- Before transferring ownership, confirm the worker and its write-producing operations have stopped, then route and dispatch a fresh replacement. If shutdown is unconfirmed, report the blocker and continue independent work. Cancel enforcement on completion.
Steps
-
Activate the
exec-plansskill, then read the plan, milestones, and tasks to understand the task graph. -
(optional) Use an exploration subagent to conduct any exploration required by the tasks - relevant codebase files or external documentation. Brief it with the needed context, acceptance criteria, and known negative cases, using context pointers where those facts are already available. Ensure the exploration subagent can save files - it should save its markdown notes in a directory next to the plan, accessible by all future subagents. This lets implementer subagents focus on implementation rather than exploration.
-
If current branch is
mainormaster, create a new integration branch. Start the integration coordinator subagent, instructing it to activate theexec-plansskill and reconcile its required plan sections before reporting a checkpoint complete. -
Use implementer subagents to implement each task, each in its own worktree on its own branch. Follow the router’s final dispatchable route and runtime enforcement as specified above. Each implementer subagent:
- confirms its worktree is based on the integration branch before starting, and resets onto it if not;
- calls the Skill tool with
tddto build the task; - merges the integration branch tip into its own branch before reporting done
-
Once an implementer subagent completes, have the same integration coordinator subagent merge its work to the integration branch.
-
If this changes the frontier of available tasks, kick off more implementer subagents to work on the new tasks. This allows for maximum concurrency.
-
Once all tickets are complete, follow the code review fix cycle.
-
Ensure all tasks and milestones are resolved and report the integration branch.
-
Clean up all implementer subagent worktrees and their related branches.
Code review fix cycle
Call the Skill tool with code-review-biaxis on the integration branch. Track all issues raised by the code review as new tasks in the ExecPlan frontier, then fix them in a single implementer subagent. Repeat code review → fix cycle until no issues remain for a maximum of three iterations. Report all unresolved issues.
For each repeat of the cycle, prefer reusing the code review and implementer subagents from the previous iteration when they match the final dispatchable route: the same model with no original effort override for host_default, or the exact model/effort pair for explicit. Otherwise, dispatch a fresh agent.
Gotchas
- Do not create worktrees anywhere within the main project directory because agents will automatically discover files like
AGENTS.mdcausing context window bloat. Recommend creating them in../<project name>.worktrees.
04 同仓库更多 Skills
spec-create
Create or revise a portable behavioral SPEC for a feature or whole product. Use when specifying a new idea, documenting an existing system for reimplementation, or defining a change while preserving compatibility. Implementation planning is a separate task.
prd-ralph
Complete at most one eligible unfinished PRD task, verify it, log progress, and optionally create one scoped commit.
fsdp-style-guide
Mandatory for all UI/UX design, implementation, review, audit, or visual regression tasks. Always use for any work that affects user-facing appearance, behavior, accessibility, branding, layout, navigation, forms, dialogs, alerts, tables, or visual design.
agency-priorities
Provide self-contained USDA strategic goals and Forest Service priorities for agency briefings, proposals, and work-plan alignment. Use when explaining agency direction or evaluating how a project contributes to USDA and Forest Service priorities.
accomplishment-report
Create a concise Forest Service executive accomplishment report when all work in an ExecPlan is completed, or update its existing report. Use at ExecPlan closeout and when asked to report completed work, agency alignment, and estimated AI-assisted versus human-only time and cost savings.
writing-for-agents
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.