spec-agent

Guide the spec-driven delivery lifecycle to produce an approved customer-spec.md.

13|12|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/itential/builder-skills --skill spec-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-agent
Source: https://github.com/itential/builder-skills/tree/main/.claude/skills/spec-agent
Command: npx skills add https://github.com/itential/builder-skills --skill spec-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured, interactive way to initiate new automation deliveries by capturing requirements, refining scope, and creating an approved high-level design (customer-spec.md) to hand off to architecture teams.

Core Features & Use Cases

  • Guides engineers and stakeholders through the requirements discovery process, producing a detailed customer-spec.md.
  • Supports re-use of existing specs or creation from scratch, and hands off to /solution-arch-agent after approval.
  • Captures acceptance criteria, constraints, and key decisions to ensure alignment across Feasibility and Design phases.

Quick Start

Initiate a new delivery with /spec-agent to generate an approved customer-spec.md and set the initial project scope.

Frequently Asked Questions about spec-agent

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

FAQPage Schema
How do I capture requirements and define scope for a new automation project?

To capture requirements and define scope for a new automation project, you need a structured discovery process that refines initial ideas into an approved customer-spec.md. This approach guides stakeholders through gathering constraints and acceptance criteria to ensure alignment before solution design.

What is a spec-driven delivery lifecycle and when do I need it for automation workflows?

A spec-driven delivery lifecycle is a structured engagement process that produces an approved high-level design before solution architecture begins. You need this for early-stage automation deliveries to ensure requirements are refined and documented before committing to technical design.

How do I create an approved high-level design document for automation engagements?

To create an approved high-level design document for automation engagements, you must run a requirements discovery process that captures key decisions and constraints. This produces a detailed customer-spec.md, serving as the foundational handoff artifact for architecture teams.

Can I reuse existing requirements specs instead of starting from scratch?

Yes, you can reuse existing requirements specs instead of starting from scratch. The discovery process supports both refining pre-existing specifications and creating new ones, ultimately handing off the approved context to feasibility and design phases.

Does the requirements discovery process handle artifact handoff to solution architecture?

Yes, the requirements discovery process handles artifact handoff by delivering the approved customer-spec.md and related context documents. This ensures the solution architecture phase receives precise project scope, acceptance criteria, and foundational decisions.

What are the limitations of using a spec-driven approach for early-stage automation deliveries?

The limitation of a spec-driven approach for early-stage automation deliveries is that it strictly focuses on discovery, requirements refinement, and HLD creation, meaning it does not cover the actual solution design or implementation phases directly.