SKILL.md
- Read
AGENTS.md,codex.toml(if present), and the target work item folderspec/features/<work-id>-<slug>/.
- <work-id> must use S-<stream>-<nnn> (example: S-core-001) for new work. - For legacy single-file specs, read the matching file under spec/features/. - Source acceptance criteria from feature.md (or the legacy single-file spec).
- Convert acceptance criteria into a test matrix:
- Preserve stable identifiers (AC-1, AC-2, etc.) in every mapping. - Unit tests (fast, isolated) - Integration tests (component boundaries) - End-to-end / scenario tests (happy path + key edge cases) - Negative/error cases (validation, permissions, timeouts, etc.)
- Decide what to mock vs run for real (with rationale).
- Update
test-plan.mdwith:
- Test cases mapped to ACs - Test data/fixtures needed - Any required test hooks/utilities - Smoke plan fields: - applicability: required or notapplicable - rationale when not applicable; only non-runnable work may use this value - scenario ID/name - fixture path - expected output shape (schema and invariants) - pass/fail mode (schema/invariants only, or schema/invariants/golden) - runtime constraints (mode, network/env, time budget, request/token budget) - artifact path expectation (artifacts/smoke/...) - Omit scenario/fixture/artifact fields only when applicability is notapplicable and the rationale is documented.
- End by recommending
write-tests.
- Output exactly: - Next recommended skill: - Run $write-tests <work-id> to implement the planned unit/integration/edge-case tests. - Replace <work-id> with the real ID from the target folder (example: S-core-001). - Do not use markdown links or absolute file paths in this recommendation.