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.