spec

Converts confirmed Change Request items into standardized 10-section specification documents.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/Angel1104/architecture-docs --skill spec-angel1104
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/Angel1104/architecture-docs/tree/main/FE-MOBILE/commands/spec
Command: npx skills add https://github.com/Angel1104/architecture-docs --skill spec-angel1104

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Spec Skill provides a disciplined, repeatable workflow to translate a Change Request (CR) item into a comprehensive, approved specification. It ensures alignment between intake, scope, and implementation by enforcing a standardized 10-section template and explicit gating rules.

Core Features & Use Cases

  • Phase-driven drafting: context loading, proportionality calibration, drafting, multi-agent review, and revision cycles that adapt to CR size and risk.
  • Template-driven output: produces a structured specs/cr/<cr-id>.spec.md with clear sections, changelog, and status tracking.
  • Guardrails and validation: references CR item details, tracks status, and prompts for missing business decisions.
  • Collaboration-ready: supports a review workflow with multiple lenses and clear acceptance criteria.

Quick Start

Start by confirming a CR item with /intake and then begin drafting its spec using the standard template and the CR context.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I write a specification for a change request?

A change request specification needs a standardized 10-section template covering context, scope, and acceptance criteria. It enforces gated phases from context loading to handoff, adjusting depth by CR size and risk to ensure cross-team alignment.

What is a gated phase workflow for software documentation?

A gated phase workflow for documentation enforces sequential stages: context loading, proportionality calibration, drafting, multi-agent review, and handoff. This structured process ensures formal validation and cross-team alignment before proceeding to implementation.

How do I handle missing business decisions when drafting a spec?

When drafting a spec and missing business decisions are detected, validation guardrails flag the omissions and prompt for the missing acceptance criteria. This ensures formal documentation is complete before cross-team handoff.

Can I use a single specification template for bug fixes and feature changes?

Yes, a single 10-section specification template applies to both bug fixes and feature changes. The workflow uses proportionality calibration to adjust documentation depth appropriately based on the specific CR size and risk level.

What is the best way to structure cross-team alignment for a change request?

The best way to structure cross-team alignment for a change request is using a multi-agent review workflow within a standardized template. This enforces clear acceptance criteria and tracks status through gated phases to ensure complete formal documentation.