gspec

Living specs for AI-assisted development.

Give your AI coding tools the product context they need — structured specifications that stay in sync with your code.

$ npx gspec
Get Started

The problem with AI-assisted development

AI tools lack project context

Your AI coding tools don't know your product vision, design system, tech stack decisions, or team standards. Every prompt starts from zero, producing inconsistent code that doesn't match your project.

Specs drift from reality

Documentation written at kickoff becomes stale within weeks. Your AI tools reference outdated specs, or worse, get no context at all — leading to decisions that contradict your evolving codebase.

A structured workflow for AI context

Define your product once, then let AI build with full context. Only Define and Build are required — everything else adds optional depth.

Define

Required

Product identity, design, stack, standards

profile style stack practices

Research

Competitive analysis & gaps

research

Specify

Feature PRDs & epics

feature epic

Architect

Technical blueprint

architect

Analyze

Cross-spec consistency

analyze

Build

Required

Spec-driven implementation

implement

Specs stay in sync with your code through automated spec-sync — update once, context updates everywhere.

11 commands, one workflow

Each command adopts a professional perspective to guide you through comprehensive product definition.

Define

Establish your product foundation

profile Business Strategist

Define what your product is, who it serves, and why it exists

style UI Designer

Generate a visual design system with tokens, colors, and component patterns

stack Solutions Architect

Define your technology choices, frameworks, and infrastructure

practices Engineering Lead

Set development standards, testing conventions, and workflows

Optional Depth

Add precision where it matters

research Market Analyst

Analyze competitors and identify feature gaps

feature Product Manager

Write a PRD with prioritized capabilities and acceptance criteria

epic Product Manager

Break down large initiatives into focused feature PRDs

architect Technical Architect

Design the technical blueprint — data model, APIs, project structure

analyze Quality Analyst

Cross-reference all specs and resolve contradictions

Build

Implement with full context

implement Senior Developer

Read all specs and build software with complete project context

One install, every platform

gspec works with the AI coding tools you already use. Same specs, consistent context, everywhere.

Claude Code
Cursor
Antigravity
Codex

Ready to give your AI tools context?

One command installs structured specification skills into your AI coding tool.

$ npx gspec

Then follow the Getting Started guide to define your first spec.