speckit-testing

Dispatches a Sonnet tester subagent to generate a conformance-gated testing.md coverage document.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-testing-narenkarthikbm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-testing
Source: https://github.com/NarenKarthikBM/specseyal/tree/main/.claude/skills/speckit-testing
Command: npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-testing-narenkarthikbm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a feature is implemented in a spec-driven pipeline, teams need a verifiable record mapping every Success Criterion and Functional Requirement in spec.md to a verification approach — without the orchestrator re-reading large artifacts and polluting its context. This Skill closes that gap by dispatching an isolated tester session and enforcing a conformance gate before the phase can be called complete. ## Core Features & Use Cases - Isolated tester dispatch: Sends exactly one Sonnet subagent whose only inputs are completion-report.md and spec.md (with an optional lazy read of implement.log.md), keeping the main session's context clean. - Conformance gating: Runs check-conformance.py against the feature directory and blocks the phase on any finding scoped to testing.md, relaying findings verbatim and restoring any prior valid file. - Auditable tracing: Appends exactly one trace record to traces.jsonl with role tester, model claude-sonnet-5, token capture, and a context_in field listing the files the tester actually read. - Use Case: After running /speckit-complete on a feature, invoke /speckit-testing to produce testing.md mapping each requirement to a verification approach, mark uncovered items as explicit GAPs, and optionally trigger the after_testing git commit hook. ## Quick Start Run /speckit-testing in a repository with Spec Kit initialized after /speckit-complete has produced a valid completion-report.md for the current feature.

Frequently Asked Questions about speckit-testing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a testing coverage document for a spec-kit feature?

Run /speckit-testing after /speckit-complete has produced a valid completion-report.md. It dispatches one Sonnet tester subagent that reads completion-report.md and spec.md, then writes testing.md mapping every Success Criterion and Functional Requirement to a verification approach.

How does the testing phase enforce context hygiene in Claude Code?

The main orchestrator never opens completion-report.md or spec.md itself — the tester subagent reads its own inputs in a separate session and returns only a one-line status. A context_in field in the trace record makes any violation auditable after the fact.

Does speckit-testing run actual test suites?

No. The tester never executes tests — it produces a doc-only coverage map marking each requirement's evidence source as report-claimed or log-verified, with uncovered items recorded as explicit GAPs rather than fabricated coverage.

What happens when the conformance validator is unavailable at testing time?

An unavailable check-conformance.py or missing python3 interpreter is treated as a blocking condition, not downgraded to an existence-only check. The phase is reported as blocked with the specific cause, and no commit hook fires.

Why did the testing phase fail even though testing.md exists on disk?

Existence alone is not sufficient — the phase fails if the tester's status line reported a self-check failure or the conformance gate found testing.md-scoped findings. A prior valid testing.md is restored via git checkout so a bad draft never overwrites it.