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.