Specpilot Report — Testing skill for Claude Code
Run the Spec-First review gate: classify the change, update specs, then wait for confirmation before coding.
How to install Specpilot Report
Installs to ~/.claude/commands/girishr-specpilot-specpilot-report.md
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/girishr/SpecPilot/HEAD/.claude/commands/specpilot-report.md -o ~/.claude/commands/girishr-specpilot-specpilot-report.md Restart Claude Code, or start a new session, for it to be picked up.
What Specpilot Report does
description: Run the Spec-First review gate: classify the change, update specs, then wait for confirmation before coding
Formalize the Spec-First review gate (mandate 8) for the pending change.
- Classify the pending change as trivial, feature, or architectural:
- Trivial: no spec update required.
- Feature: touches
project/requirements.mdandplanning/tasks.md. - Architectural: touches all affected spec files plus
CHANGELOG.md.
- Read the relevant
.specs/files per
Alternatives in Testing
- Pua — Use when the user invokes /pua or asks for PUA mode, try-harder/retry help, change-approach coaching, completi 19.5k ★
- Spec Driven Develop — Spec-driven development workflow for AI coding agents: architecture-first planning, task decomposition, GitHub 975 ★
- TDD Diagnostics.V1 — Follow strict TDD stages 272 ★
Full documentation available on GitHub
View Source RepositoryRelated Skills
Spec Fix
Lightweight fix flow — triage a defect against specs/, then one implementer pass through the same external gat
Spec Research
Investigate a loose idea before committing to a change. Runs codebase + (optional) web research via subagents,
Root Cause Fix
Root-cause-first TDD loop for any bug or data fix. Forces a failing reproduction test BEFORE touching producti
Buildable Plan
Classify an app idea and produce a local-first Buildable phase plan and app spec (archetype, stack, screens, e
To Spec
Write or update the capability spec from an interview — turns a /shape session (or provided notes/transcript)
Sandstorm Spec Refine
Interactive refinement loop — run quality gate, present gaps, ask questions, update ticket until it passes
Related Agents
Changelog Analyst
Agentic commit subagent. Reads git state and dev-report to classify files, stages them, writes conventional co
Sdd Clarify.Agent
Reduce spec ambiguities before design. Detects material gaps, asks ≤5 questions via question_gate, and encodes
Self Update
Audits skills, rules, agent definitions, and specs for missing, outdated, or incorrect content — then proposes