spec-driven-loop
Freeze PRD, technical design, and acceptance criteria before medium-to-large Codex work; coordinate agents with explicit ownership, then judge delivery from diffs, tests, and evidence.
IT & Software Developmentacceptance-testingagent-orchestrationcodexmulti-agentspec-driven-development
Spec-Driven Loop
Turn an uncertain software request into an approved specification, a controlled implementation, and evidence-backed acceptance. Keep project documents in the repository's established location; otherwise use docs/spec-driven/<feature-slug>/.
When to Use
Use this skill for new products, medium-to-large features, cross-module changes, or requests that need PRD/technical design, active clarification, multi-agent execution, or a main-agent judge. Do not use it for a small single-file change, a tiny bug fix, code explanation, review-only or diagnostic work, pure research, or a simple task whose specification is already complete.
Quick Example
$spec-driven-loop Build a multi-tenant job dashboard with role-based access and evidence-backed acceptance.
Limitations
- Not intended for small isolated edits, review-only work, diagnosis, or pure research.
- Does not replace environment-specific testing or grant authorization for unrelated changes or external actions.
- Production implementation cannot start until the user explicitly approves the frozen specification and acceptance contract.
Follow repository instructions and authorization boundaries throughout. Match generated project documents to the user's language or the repository's existing documentation language; keep identifiers such as FR-001 and AC-001 stable.
Operating Invar
Subscribers only
The full skill, its 3 bundled files and every download is included with every paid Complete AI plan.
Details
| Source | Linji-x/spec-driven-loop |
|---|---|
| License | MIT |
| Risk label | safe ("critical" means the skill may run commands or touch files — read before use) |
| Files | SKILL.md, references/agent-and-judge-contracts.md, references/document-templates.md |
| Added | 2026-08-25 |
Related skills
agent-harness-fault-injection
Use when an agent workflow needs deterministic recovery evidence for sandbox, MCP/tool, worker, checkpoint, memory, or orchestration failures.
agents-md
Create, revise, or audit AGENTS.md files from repository evidence, verified commands, and correctly scoped instructions without overwriting maintainer intent.
agenttrace-session-audit
Audit local AI coding-agent sessions with agenttrace for cost, tool failures, latency, anomalies, health, diffs, and CI gates.
api-endpoint-builder
Builds production-ready REST API endpoints with validation, error handling, authentication, and documentation. Follows best practices for security and scalability.
api-rate-limit-handler
Implement bounded, idempotency-aware API throttling, backoff, and retry handling for 429 and transient 5xx responses.
arm-cortex-expert
Senior embedded software engineer specializing in firmware and driver development for ARM Cortex-M microcontrollers (Teensy, STM32, nRF52, SAMD).
