spec-workflow

Automate four-phase development workflows with validation scripts and auditable wiki artifacts.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/lightxue/dotfiles --skill spec-workflow-lightxue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-workflow
Source: https://github.com/lightxue/dotfiles/tree/main/agent/skills/spec-workflow
Command: npx skills add https://github.com/lightxue/dotfiles --skill spec-workflow-lightxue

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Spec Workflow standardizes and automates end-to-end development processes by guiding teams through a 0→1→2→3 four-phase workflow, incorporating automated validation scripts and mandatory approvals, and producing auditable wiki documentation and .specs outputs.

Core Features & Use Cases

  • Automates the end-to-end development lifecycle from requirement capture to wiki updates and execution summaries.
  • Enforces strict phase order with automated checks and human gatekeeping to prevent skipping steps.
  • Generates and validates 1+3 wiki documents (README, architecture, interfaces, implementation) and per-feature .specs artifacts.
  • Supports both TAPD-based inputs and free-form requirements, delivering traceable deliverables for governance.

Quick Start

Use the Spec Workflow to guide your project from discovery through completion by following the phase documents and running the provided scripts.

Frequently Asked Questions about spec-workflow

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

FAQPage Schema
How do I automate end-to-end development workflows with mandatory phase validation?

Automating end-to-end development workflows involves guiding teams through a four-phase process with automated validation scripts and formal approval gates to prevent skipping steps. This produces auditable wiki documentation and .specs outputs for project governance.

Can I use free-form requirements instead of TAPD for automated workflow validation?

Yes, automated workflow validation supports both TAPD-driven and free-form requirement inputs. It processes free-form requirements through the same four-phase workflow, delivering traceable deliverables while enforcing strict phase order with automated checks.

What wiki documentation structure is generated for development governance?

Development governance generates a 1+3 wiki document structure including README, architecture, interfaces, and implementation documents. It also produces per-feature .specs artifacts, all validated by scripts and maintained as auditable project deliverables.

How does automated gatekeeping prevent teams from skipping development phases?

Automated gatekeeping enforces strict phase order by running validation scripts and requiring mandatory approvals before advancing. It coordinates templates, references, and scripts to verify every phase, preventing teams from skipping steps during the end-to-end workflow.

What is the best way to standardize development processes from requirement capture to wiki updates?

Standardizing development processes requires automating the lifecycle from requirement capture through wiki updates using a four-phase workflow. This approach enforces phase order with automated checks and human gatekeeping, generating auditable artifacts and execution summaries.

Do I need specific project management integrations to use automated workflow gatekeeping?

No specific project management integrations are required because automated workflow gatekeeping supports both TAPD-based inputs and free-form requirements. It validates every phase using scripts and formal approvals without external dependencies.