| name | dev-testing |
| description | AI DevKit · Testing phase guidance for adding and validating feature test coverage. Use when the user wants to write tests, update testing docs, run coverage, close coverage gaps, or run dev-lifecycle phase 8. |
Dev Testing
Run testing work for configured AI docs features. Before changing docs or code, propose the concrete plan for this phase and wait for user approval unless the user already approved the exact phase plan.
Phase Contract
- Run
npx ai-devkit@latest lint before phase work.
- If working on a named feature, run
npx ai-devkit@latest lint --feature <name>.
- Read the testing doc, requirements, design, implementation notes, and current diff before changes.
- Apply the
verify skill before making coverage or test-pass claims.
- If parent
dev-lifecycle established usable task tracing, emit testing phase, next-action, and evidence events per task.
Write Tests
Use for Phase 8.
- Run
npx ai-devkit@latest lint --feature <name> and reference the testing doc path it validates. If manual path resolution is unavoidable, first resolve .ai-devkit.json paths.docs, falling back to docs/ai.
- Gather context: feature name, changes summary, environment, existing test suites, flaky tests to avoid.
- Analyze the testing template, success criteria, edge cases, available mocks, and fixtures.
- Add unit tests for happy paths, edge cases, and error handling for each module. Highlight missing branches.
- Add integration tests for critical cross-component flows, setup/teardown, and boundary/failure cases.
- Run coverage tooling, identify gaps, and suggest additional tests if below the target.
- If task tracing is available, record evidence for each fresh test/coverage command per
task.
- Update the selected testing doc with test file links and results.
Next: dev-review. If tests reveal design flaws, return to dev-design.
