spec-workflow

Clarify ambiguous requirements and create design artifacts for multi-module changes.

2|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/EverettField/MatchMate-MiniProgram --skill spec-workflow-everettfield
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-workflow
Source: https://github.com/EverettField/MatchMate-MiniProgram/tree/main/miniprogram-2/.codebuddy/skills/spec-workflow
Command: npx skills add https://github.com/EverettField/MatchMate-MiniProgram --skill spec-workflow-everettfield

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spec workflow clarifies ambiguous requirements and planning for complex, multi-module changes.

Core Features & Use Cases

  • Explicit requirements & design artifacts: captures the problem statement, acceptance criteria, and high-level architecture before coding.
  • Structured task planning: breaks work into concrete tasks with traceability to requirements and design decisions.
  • Cross-team alignment: coordinates frontend, backend, data, and infrastructure changes through a shared spec.

Quick Start

Propose a spec-workflow by outlining the problem, identifying acceptance criteria, and listing design decisions before implementation.

Frequently Asked Questions about spec-workflow

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

FAQPage Schema
How do I clarify ambiguous requirements for a complex multi-module software change?

Spec workflow clarifies ambiguous requirements by capturing the problem statement, acceptance criteria, and high-level architecture before coding begins. This prevents scope drift by aligning multi-module implementation with explicitly agreed criteria.

How do I plan tasks and align architecture before coding a large feature?

Plan tasks and align architecture by creating explicit design artifacts and breaking work into concrete tasks with traceability to requirements. This structured task planning coordinates cross-team implementation across frontend, backend, data, and infrastructure modules.

When do I need to use a spec workflow for software planning?

You need a spec workflow for medium-to-large changes across multiple modules where acceptance criteria and design decisions are not well defined. It applies to complex software engineering tasks requiring cross-team alignment to prevent scope drift.

What is the best way to prevent scope drift in cross-team software engineering projects?

The best way to prevent scope drift in cross-team projects is coordinating frontend, backend, data, and infrastructure changes through a shared spec. This shared design artifact ensures implementation aligns with explicitly defined requirements and design decisions.

Does spec workflow work for medium-to-large changes with undefined acceptance criteria?

Yes, spec workflow is specifically designed for medium-to-large changes with undefined acceptance criteria. It resolves this by creating explicit requirements, structured task plans, and design artifacts that align implementation with agreed project criteria.

How to break down work into concrete tasks with traceability to requirements?

Break down work into concrete tasks with traceability by applying a structured spec workflow. This process lists design decisions and maps explicit acceptance criteria directly to individual implementation tasks across all affected modules.