spec-writer

Guide teams through a 4-stage gated workflow to create a living SPEC.md.

1|1|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/H2OSLabs/SynnovatorZero --skill spec-writer-h2oslabs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-writer
Source: https://github.com/H2OSLabs/SynnovatorZero/tree/main/.claude/skills/spec-writer
Command: npx skills add https://github.com/H2OSLabs/SynnovatorZero --skill spec-writer-h2oslabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The spec-writer guides teams through crafting a living SPEC.md using a 4-stage gated workflow and a 6-domain framework, enabling AI agents to operate with clear project standards.

Core Features & Use Cases

  • Structured 4-stage workflow: Specify, Plan, Tasks, Implement, with gate checks.
  • Six-domain coverage: Commands, Testing, Project Structure, Code Style, Git Workflow, Boundaries with concrete templates.
  • Living documentation: Produces SPEC.md at project root and supports ongoing updates and version history.

Quick Start

To begin, tell the agent your project goals and desired guidelines and request a SPEC.md scaffold. Then review and approve Stage 1 Vision, push Stage 2 planning, and generate SPEC.md in Stage 3.

Frequently Asked Questions about spec-writer

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

FAQPage Schema
How do I create a SPEC.md to set project guidelines for an AI coding agent?▼

To create a SPEC.md, define your project goals and guidelines to generate an initial scaffold, then progress through a 4-stage gated workflow covering vision, planning, tasks, and implementation. This establishes structured standards for AI agents to follow.

What is the six-domains framework for spec-writing in AI projects?▼

The six-domains framework structures project specifications across Commands, Testing, Project Structure, Code Style, Git Workflow, and Boundaries. It ensures AI agents operate with comprehensive, tangible guidelines rather than vague instructions.

Can I use this structured spec-writing workflow for existing codebases instead of just greenfield projects?▼

Yes, the gated workflow and six-domain framework apply to both greenfield and existing projects. You can generate a living SPEC.md at your project root to define or update standards for AI agents working within current codebases.

How does the 4-stage gated workflow function when planning AI agent tasks?▼

The gated workflow operates through Specify, Plan, Tasks, and Implement stages with enforced gate checks. You review and approve each stage, such as Stage 1 Vision, before pushing to Stage 2 planning and generating the SPEC.md in Stage 3.

What's the best way to maintain a living SPEC.md as project standards evolve?▼

Maintain a living SPEC.md by using the workflow's ongoing update and versioned history features. The structured approach allows continuous modifications to the six domains, keeping project guidelines synchronized with evolving codebases.