|
1 | 1 | --- |
2 | 2 | name: act |
3 | | -description: Executes an explicitly authorized workflow Plan, gathers criterion-matched evidence, stops on every unresolved implementation doubt, and launches independent review before completion. Use automatically after the active workflow's Plan records user authorization, or when continuing implementation or closing review findings. |
| 3 | +description: Implements an explicitly authorized Ready Design, keeps a factual execution record, stops on every unresolved implementation doubt, and launches independent review before completion. Use automatically after the active Design records user authorization, or when continuing implementation or closing review findings. |
4 | 4 | --- |
5 | 5 |
|
6 | 6 | # Workflow Act |
7 | 7 |
|
8 | | -Execute the approved Plan without changing Design intent. |
| 8 | +Implement the approved Design without changing its intent. Choose mechanical execution order from repository facts; do not create a separate implementation Plan. |
9 | 9 |
|
10 | 10 | ## Start |
11 | 11 |
|
12 | | -Read active `design.md` and `plan.md` together. Confirm Design is Ready and Plan authorization is Approved. Inspect repository status and preserve unrelated user changes. If any precondition is false, stop. |
| 12 | +Read active `design.md`. Confirm Design is Ready, every coverage dimension is resolved or justified `N/A`, and `Implementation Authorization` is `Approved`. Inspect repository status and preserve unrelated user changes. If any precondition is false, stop. |
| 13 | + |
| 14 | +Create or update `execution.md` from [assets/execution.md](assets/execution.md). It records work already started or completed, evidence, doubts, and deviations; it must not become a speculative task plan. |
13 | 15 |
|
14 | 16 | Read [references/doubt-protocol.md](references/doubt-protocol.md) before editing and use [references/validation-guide.md](references/validation-guide.md) throughout. |
15 | 17 |
|
16 | | -## Task loop |
| 18 | +## Execution loop |
17 | 19 |
|
18 | | -For each unchecked task in order: |
| 20 | +Until every Design success criterion is evidenced: |
19 | 21 |
|
20 | | -1. Re-read its Design anchors, constraints, affected system, and required evidence. |
21 | | -2. Investigate unclear repository facts read-only. |
22 | | -3. Before any mutation, confirm every Plan-required validation entrypoint and prerequisite exists and can be invoked. Inspect command/script availability without substituting or weakening the validation. If an entrypoint is unavailable, stop before implementation and apply the doubt protocol. |
23 | | -4. If uncertainty remains, apply the doubt protocol and wait for the user. |
24 | | -5. Implement the smallest coherent change uniquely entailed by Design and Plan. |
25 | | -6. Run the planned validation and record raw results in `plan.md`. |
26 | | -7. Mark the task complete only after its required evidence exists. |
| 22 | +1. Select an unmet success criterion or required production integration obligation and re-read its Design decisions, constraints, affected system, and required evidence. |
| 23 | +2. Investigate unclear repository facts read-only. Choose the next mechanical execution step from the actual dependency graph; do not ask the user about uniquely determined ordering. |
| 24 | +3. Before mutation, confirm the Design-required validation entrypoint and prerequisites exist and can be invoked. If unavailable, stop before implementation and apply the doubt protocol. |
| 25 | +4. If any implementation choice is not uniquely fixed by Design and repository facts, apply the doubt protocol and wait for the user. |
| 26 | +5. Implement the smallest coherent change uniquely entailed by Design. |
| 27 | +6. Run the applicable validation and append the raw result and production-path evidence to `execution.md`. |
| 28 | +7. Mark a success criterion covered only after its required evidence exists. Record deviations immediately; any deviation that changes Design requires user confirmation before further mutation. |
27 | 29 |
|
28 | 30 | Do not silently add dependencies, change APIs or formats, broaden scope, choose compatibility policy, introduce fallback behavior, skip evidence, or replace validation. Use required domain skills and follow the target project's version-control ownership rules. |
29 | 31 |
|
30 | | -Do not add or modify tests unless the user explicitly requested test work. Existing tests may be run when the authorized Plan names them as validation. |
| 32 | +Do not add or modify tests unless the user explicitly requested test work. Existing tests may be run when the approved Design names them as validation. |
31 | 33 |
|
32 | 34 | ## Review and closure |
33 | 35 |
|
34 | 36 | After all tasks and agent-accessible validation finish: |
35 | 37 |
|
36 | | -1. Launch an independent subagent with `$agent-workflow-kit:review`, passing only the active record, repository root, and raw validation entrypoints. Do not pass your conclusions or suspected gaps. |
| 38 | +1. Launch an independent subagent with `$agent-workflow-kit:review`, passing only `design.md`, `execution.md`, the repository root, and raw validation entrypoints. Do not pass your conclusions or suspected gaps. |
37 | 39 | 2. If review returns P0/P1 or an unmet criterion, fix only when the required correction is uniquely determined. Otherwise ask the user before editing. |
38 | 40 | 3. Ask the reviewer to re-check fixes until it returns `PASS`, or report a genuine `BLOCKED` decision/evidence dependency. |
39 | | -4. Reconcile the Completion Record, final Design behavior, validation results, deviations, and review verdict. |
| 41 | +4. Reconcile `execution.md`, final Design behavior, validation results, deviations, and review verdict. |
40 | 42 | 5. Apply required session log/ADR/architecture/feature updates. Move the entire change folder from `workflow/active/` to `workflow/completed/` only after `PASS`. |
41 | 43 |
|
42 | 44 | Never claim completion before independent `PASS`. |
0 commit comments