skill-spec-validator

Skill: Spec Validator

[!IMPORTANT] TIER 2 (High Integrity): This skill acts as a mechanical gatekeeper for the /vdd-enhanced workflow.

1. Purpose

To strictly enforce "Requirements Hardening" by mechanically verifying that:

1. TASK.md contains a Requirements Traceability Matrix (RTM).
2. PLAN.md explicitly covers every item in the RTM using Atomic Checklists.

2. Usage

Mode A: TASK Validation

Trigger: After Analysis Phase. Command:

python3 scripts/validate.py --mode task /absolute/path/to/docs/TASK.md

Checks:

• Presence of an RTM heading (h2–h4), matched flexibly: ## Requirements Traceability [Matrix], ## N. ... (RTM), and the bare ### N. Requirements (RTM) form are all accepted.
• Columns ID, Requirement.

Mode B: PLAN Validation

Trigger: After Planning Phase. Command:

python3 scripts/validate.py --mode plan /absolute/path/to/docs/PLAN.md /absolute/path/to/docs/TASK.md

Checks:

• Every RTM ID in TASK appears as a whole token somewhere in PLAN — in a step heading (## Step 1 — ... (R1)) or a - [ ] R1 ... bullet. R1 does not satisfy R10.

3. Failure Handling

• Exit Code 1: Issues found. Orchestrator should trigger a Correction Loop (instruct Analyst/Planner to fix).
• Bypass: If validation is buggy, add the bypass token — BYPASS_VALIDATION in square brackets — to TASK.md.

  [!WARNING] The bypass is a bare substring test anywhere in TASK.md, so a spec that merely mentions the token switches its own gate off and prints Validation bypassed … with exit 0 — which reads like a pass. Write it only when you mean it (that is why this section spells the token out instead of quoting it). Pinned by a test, deliberately not "fixed": tightening it is a behavior change to a live gate.

4. Dependencies

• Python 3 (stdlib only)
• validate.py (in scripts/)

Execution Mode

• Mode: script-first. The whole judgement is mechanical — two regex matchers and a table parser. Nothing here is prompt-side; if a matcher disagrees with an artifact, that is a finding for a human, not something to reason around.