spec

Generate a formal feature spec with decision gates and changelog.

36|3|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/2lab-ai/oh-my-claude --skill spec-2lab-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/2lab-ai/oh-my-claude/tree/main/plugins/stv/skills/spec
Command: npx skills add https://github.com/2lab-ai/oh-my-claude --skill spec-2lab-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

STV Spec helps teams capture the WHY, decision rationale, and architectural direction in a single, repeatable workflow, reducing back-and-forth and misalignment between product, design, and engineering.

Core Features & Use Cases

  • Decision Gate (MANDATORY) — Read the decision-gate.md and apply it to every decision to ensure governance and consistency across specs.
  • Step 0 to Step 3 workflow: Proposal, Input Analysis, Business Interview, Architecture Interview, and Spec Writing, enabling a coherent progression from intent to implementation.
  • Update vs New decision tree: Handles scenarios where an existing spec is extended or replaced with clear rules and changelogs.
  • Output generation: Produces a docs/{feature-name}/spec.md with sections for overview, user stories, architecture, and traceability.
  • Non-linear flow support: Allows actions to occur outside rigid phase boundaries when appropriate, while preserving auditability.
  • Collaboration guidance: Guides interview-style input gathering and autonomous decisions where possible, reducing friction.

Quick Start

Start the STV spec workflow for your feature to generate a complete spec.md with decision gates and traceable steps.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I create a formal feature specification with architectural decisions and traceability?

To create a formal feature specification, you need a workflow that captures the why, architectural direction, and decision rationale in a single pass. This ensures alignment across product, design, and engineering while producing a traceable spec document.

What is the best way to govern software specification updates versus creating new specs?

Governing specification updates requires a decision tree to handle whether an existing spec is extended or replaced. This workflow manages changes with clear rules and records a spec changelog to maintain full traceability.

How does a decision gate work in a software specification workflow?

A decision gate enforces governance and consistency by applying predefined rules to every decision made during specification. It ensures that all architectural and business decisions are validated before a feature spec is finalized.

Can I generate a spec.md file that includes user stories and architecture documentation?

Yes, you can generate a spec.md file that automatically structures your feature overview, user stories, architecture direction, and traceability records. This output consolidates interview inputs and autonomous decisions into a single document.

How do I capture business and architectural requirements before writing a feature spec?

Capturing requirements involves an interview-style input gathering process that progresses from initial proposal through input analysis and business interviews to architecture interviews. This coherent progression ensures intent is fully mapped before spec writing.

Does a specification workflow support non-linear progression while maintaining auditability?

Yes, a specification workflow can support non-linear flow allowing actions to occur outside rigid phase boundaries when appropriate. It preserves auditability by recording auto-decisions and maintaining a comprehensive spec changelog.