spec-writing

Write and validate formal specifications through a five-phase gated process.

21|3|Updated May 26, 2026
One-click install
npx skills add https://github.com/AlphaBitCore/nexus-gateway --skill spec-writing-alphabitcore
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-writing
Source: https://github.com/AlphaBitCore/nexus-gateway/tree/main/.claude/skills/spec-writing
Command: npx skills add https://github.com/AlphaBitCore/nexus-gateway --skill spec-writing-alphabitcore

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spec-writing reduces ambiguity by capturing requirements before implementation, aligning teams, and preventing scope drift.

Core Features & Use Cases

  • Phase-driven workflow: context gathering, specification drafting, planning, task breakdown, and implementation gating.
  • Elicitation prompts and templates to accelerate capturing requirements.
  • Collaboration-friendly outputs for AI-assisted planning, reviews, and handoffs.

Quick Start

Clarify the feature intent, gather context, draft A1-spec.md, and await approval before proceeding.

Frequently Asked Questions about spec-writing

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

FAQPage Schema
What is a spec-driven feature design workflow and when do I need it?

Spec-driven development uses a structured five-phase process with gated approvals to capture requirements before implementation. It requires completing context gathering, specification drafting, planning, task breakdown, and implementation gating sequentially to ensure traceability and completeness.

How do I write testable specifications for a new software feature?

Draft an A1-spec.md document using elicitation prompts and templates to capture requirements, then await gated approval before proceeding. This structured five-phase process ensures specifications remain testable, complete, and traceable across context gathering, drafting, planning, and task breakdown.

Can I use structured phase gates for AI-assisted planning and handoffs?

Yes, phase gates produce collaboration-friendly outputs designed for AI-assisted planning, reviews, and handoffs. The workflow guides both practitioners and AI agents through context gathering, specification drafting, and gated approvals to ensure alignment before implementation.

What is the best way to prevent scope drift during requirements elicitation?

Use structured elicitation prompts and templates within a gated five-phase workflow to prevent scope drift. Requiring formal approval before moving from specification drafting to planning ensures all open questions are resolved and requirements remain fully traceable.

Does specification writing work without formal approval gates?

Specification writing without gated approvals risks scope drift and misalignment. The structured five-phase process enforces formal approval between context gathering, drafting, planning, task breakdown, and implementation to ensure completeness and traceability before development proceeds.