subtask-plan

name	subtask-plan
description	Complete subtask verification plan: upstream traceability table + L1-L4 test plan + self-check. Call after autoworker:subtask-init. Makes subtask ready for code implementation.

autoworker:subtask-plan — Complete Verification Plan (Gate 1.3 Step C+D+E)

Invoked after autoworker:subtask-init completes. Fills in upstream traceability table, L1-L4 verification plan, and solution self-check.

Execution Flow

1. Locate and Check Subtask

Glob `subtask_*.md` (exclude subtask_template.md) →
  0 found → stop, prompt to create subtask
  1 found → use directly (backward compatible)
  multiple → grep `status:` to filter:
    - Files without status field treated as active (backward compatible)
    - Exactly 1 active → use it
    - 0 active → list all files + status, prompt user to choose
    - >1 active → report anomaly
→ Read → check first-half completeness

Pre-checks:

• Assumptions table "Result" column has empty rows → FAIL, prompt to complete autoworker:subtask-init first
• User confirmation record is empty → FAIL
• Goal/success criteria is empty → FAIL

2. Fill In Upstream Verification Traceability Table

Source: Read plan file (if exists) + review conversation for user's verification/testing requirements.

Edit subtask's "Upstream Verification Traceability" table:

Upstream text (copy verbatim)	Subtask item	Delta rationale

Rules:

• Copy verbatim from upstream text — not summarize (the act of copying forces you to see what upstream required)
• When no upstream requirements exist, write one line: No upstream requirements | Self-designed | —
• Subsequent L1-L4 are not allowed to be lower than the traceability table; downgrades must state delta rationale

2.5. Silent Failure Analysis

Read the subtask's "Acceptance Criteria" table, for each metric ask:

If this metric deviates, which L1-L4 layer would catch it?

• Metric has no corresponding test → add in subsequent L2-L4
• All metrics have corresponding tests → continue

Purpose: Prevent acceptance criteria defined in the plan but not covered by the verification plan (silent failure).

3. Write L1-L4 Verification Plan

Cross-reference the traceability table, Edit subtask to fill in each layer's verification plan:

L1 Build:

• Specific build/check commands → expected output

L2 Unit (can skip but state reason):

• Specific function calls + expected input/output

L3 Chain (can skip but state reason):

• Commands feeding downstream with actual upstream output

L4 End-to-End (mandatory):

• Complete steps simulating actual user operation path
• Operation table: # | Action | Expected result | Actual result (leave empty)

Verification coverage table: | Modified file | Change content | Corresponding verification item | Each file planned for modification must have a corresponding verification item.

Constraints:

• Cannot be lower than upstream requirements in the traceability table. Downgrades must be explicitly noted in the delta rationale column
• Each metric in the acceptance criteria table must have at least one corresponding test in L2-L4

4. Acceptance Criteria Coverage Check

Build metric-to-test mapping table:

Acceptance metric	Corresponding test item (which L, which item)	Coverage status

• Uncovered metrics found → return to Step 3 and add corresponding tests
• All covered → continue

5. Solution Self-Check (Four Questions)

Answer each one (any unsatisfactory → report the issue, do not continue):

0. Is the direction right? Derived from problem essence, or pattern-matched from similar scenarios?
1. Is the abstraction level right? Does the caller naturally possess this capability?
2. 10x robustness: Still robust if input diversity increases 10x?
3. Does a simpler solution exist? Same effect, less code/assumptions?

Edit self-check results into subtask's progress log.

6. Output

Subtask ready: subtask_<sequence>_<name>.md
- Traceability: <N> upstream requirements aligned
- Verification plan: L1 done, L2 <done/skip>, L3 <done/skip>, L4 done
- Coverage: <N>/<N> files have verification items
- Acceptance criteria coverage: <N>/<N> metrics have corresponding tests
- Self-check: 4/4 passed
→ Automatically invoking autoworker:dispatch

7. Chain: Immediately Invoke autoworker:dispatch

After outputting the summary above, immediately invoke autoworker:dispatch. Do not wait for user instructions, do nothing else.

Important Notes

• Traceability table is an anti-downgrade mechanism: Skipping the traceability table and writing L1-L4 directly = may miss upstream requirements
• L4 is mandatory: End-to-end verification cannot be skipped — it's the ultimate safeguard for the user path
• Complete coverage: Uncovered modified files → add verification items before continuing
• Chaining is mandatory: Must invoke autoworker:dispatch after completion, cannot skip or manually substitute