Specwright Gate: Build and Test

Default verdict is FAIL. Evidence must be cited before any verdict. Absence of evidence is evidence of non-compliance.

Step 1: Read Configuration and State

Read .specwright/config.json for commands.build and commands.test. Read .specwright/state/workflow.json. Extract currentEpic.id and currentEpic.specDir. If no epic active, STOP: "No active epic. Run /specwright:specify first." If commands.build is null and commands.test is null: write ERROR status, STOP.

Step 2: Create Evidence Directory

bash

mkdir -p {specDir}/evidence/

Step 3: Run Build Command

bash

{commands.build} 2>&1 | tee {specDir}/evidence/build-output.txt

If exit code non-zero: update gates.build to {"status":"FAIL","lastRun":"<ISO>","evidence":"{specDir}/evidence/build-output.txt"}, update lastUpdated, output FAIL result, STOP.

Step 4: Run Test Command

bash

{commands.test} 2>&1 | tee {specDir}/evidence/test-output.txt

Step 5: Parse Test Results

Parse the test output to determine: total tests, passed, failed, skipped. Note: The output format varies by language/framework — use LLM reasoning to parse whatever format the test runner produces. If ANY tests FAIL or ANY tests SKIPPED without justification: update gate to FAIL, STOP.

Step 6: Check for Warnings

Scan build output for compilation warnings. Log count if found.

Step 7: Baseline Check

If .specwright/baselines/gate-build.json exists, load entries ({finding, file, reason, expires} with ISO dates; null = no expiry). For matching findings: downgrade BLOCK->WARN, WARN->INFO. Ignore expired entries. Partial match (same category, different line): AskUserQuestion. Log all downgrades in evidence.

Step 8: Update Gate Status

Self-critique checkpoint: Before finalizing — did I accept anything without citing proof? Did I give benefit of the doubt? Would a skeptical auditor agree? Gaps are not future work. TODOs are not addressed. Partial implementations do not match intent. If ambiguous, FAIL.

Determine final status:

•Gate cannot complete (partial results): ERROR (invoke AskUserQuestion)
•Build/test failure: FAIL
•All pass, compilation warnings present: WARN
•All pass, no warnings: PASS

Update .specwright/state/workflow.json gates.build:

json

{"status": "PASS|WARN|FAIL|ERROR", "lastRun": "<ISO>", "evidence": "{specDir}/evidence/build-output.txt"}

Update lastUpdated.

Step 9: Output Result

code

BUILD GATE: {PASS|WARN|FAIL}
- Build: SUCCESS/FAILED
- Tests: X passed, 0 failed, 0 skipped
- Warnings: N compilation warnings
- Evidence: {specDir}/evidence/