spec-check

Audit draft specs against the Socratic Definition of Done and classify acceptance criteria.

1|1|Updated Feb 25, 2025
One-click install
npx skills add https://github.com/JamSuite/jim --skill spec-check-jamsuite
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-check
Source: https://github.com/JamSuite/jim/tree/main/skills/spec-check
Command: npx skills add https://github.com/JamSuite/jim --skill spec-check-jamsuite

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit a draft spec against the Socratic Definition of Done (DoD) to identify gaps and classify acceptance criteria into three tiers for remediation.

Core Features & Use Cases

  • Three-tier classifier: categorize AC into Tier 1 (Functional), Tier 2 (External Constraint), or Tier 3 (Implementation Detail).
  • Four Socratic Probes: Razor, Delegation, Story-Link, and Constraint-Sourcing applied to each AC.
  • Structured audit outcomes: handoff-ready items, retained constraints, orphan ACs, and a clean/residual status.

Quick Start

Run /jim:spec-check on a spec.md path to generate a structured DoD audit.

Frequently Asked Questions about spec-check

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

FAQPage Schema
How do I audit acceptance criteria in a draft spec for quality gaps?

To audit acceptance criteria for quality gaps, the tool classifies each item into functional, external constraint, or implementation detail tiers and applies Socratic probes to identify orphan criteria and missing constraints, returning a structured remediation outcome.

What is the Socratic Definition of Done methodology for project management?

The Socratic Definition of Done is a spec audit methodology that uses a three-tier classifier and four probes—Razor, Delegation, Story-Link, and Constraint-Sourcing—to evaluate draft specifications and classify acceptance criteria for structured remediation outcomes.

How do I check if a spec.md file meets Definition of Done requirements?

You can check if a spec.md file meets DoD requirements by running the spec-check command on the target path, which triggers an audit to evaluate acceptance criteria and return a clean or residual status along with handoff-ready items.

What are the three tiers used to classify acceptance criteria during a spec audit?

The three tiers used to classify acceptance criteria during a spec audit are Tier 1 for Functional requirements, Tier 2 for External Constraints, and Tier 3 for Implementation Details, enabling structured evaluation of each specification draft.

What are the four Socratic probes applied to acceptance criteria?

The four Socratic probes applied to acceptance criteria are Razor, Delegation, Story-Link, and Constraint-Sourcing, which systematically test each item to identify gaps and validate constraints within the specification draft.

What structured outcomes does a DoD spec audit return for remediation?

A DoD spec audit returns structured outcomes including handoff-ready items, retained constraints, orphan acceptance criteria, and a final clean or residual status to guide specification remediation efforts.