What is the main benefit of the Specs-Dev skill?

The Specs-Dev skill ensures code quality by enforcing a disciplined 'plan before you code' approach with mandatory review steps and quality gates.

Does this skill support specialized subagents?

Yes, it utilizes specialized Reviewer and Worker agent personas to separate implementation logic from quality assurance and planning.

When should I use Specs-Dev instead of standard coding?

Use it for complex features, major refactoring, or any task where architectural mistakes would be costly or multi-file changes are required.

How does the review gate system work?

Each task moves through a state machine: Implementing, Validating, Reviewing, Committing, and Documenting. Tasks cannot proceed until the 'Reviewing' state is approved.

Where are session plans and task lists stored?

All session data, including plans and tactical tasks, is organized within a dedicated '.agents/sessions/' directory for full transparency and history.

Specs-Dev Workflow

Name: Specs-Dev Workflow
Author: vaayne

byvaayne

•

Productivity & Workflow

Implements a disciplined, plan-first development workflow with mandatory review gates to ensure high-quality, structured code changes.

Specs-Dev is a specialized workflow skill for Claude Code designed for complex engineering tasks that require rigorous planning and iterative execution. It guides the AI through four distinct phases—Discovery, Planning, Implementation, and Completion—enforcing quality gates and review loops at every step. By utilizing subagents for specialized 'Worker' and 'Reviewer' roles, it ensures that every feature implementation or refactor is well-documented, thoroughly tested, and aligns perfectly with user requirements before any code is committed, making it ideal for multi-file changes and high-stakes architectural updates.

Key Features

01Quality gate validation for every development phase exit

02Structured implementation planning with reviewer subagent validation

03Phase-based discovery and requirements gathering

04Automated session logging and documentation tracking

05Mandatory review-gated state machine for implementation tasks

0621 GitHub stars

Use Cases

01Executing large-scale refactors where planning and safety checks are critical

02Managing multi-file changes through a disciplined 'plan-first' approach

03Building complex new features that require clear architectural oversight

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add vaayne/agent-kit specs-dev

For use in Claude.ai and ChatGPT

Download Skill