spec-first

Generate design proposals and acceptance criteria before coding.

10|2|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/Zhijiang-Li1111/ironflow --skill spec-first-zhijiang-li1111
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-first
Source: https://github.com/Zhijiang-Li1111/ironflow/tree/main/skills/spec-first
Command: npx skills add https://github.com/Zhijiang-Li1111/ironflow --skill spec-first-zhijiang-li1111

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design-before-code to surface assumptions, align stakeholders, and prevent expensive rework during software changes.

Core Features & Use Cases

  • Structured exploration: clarifies goals, constraints, and success criteria before implementing.
  • 2-3 design options: presents multiple paths with trade-offs and a recommended approach.
  • Spec-to-plan handoff: outputs clear design artifacts and acceptance criteria for planning.

Quick Start

Begin with a design discussion to align goals, constraints, and acceptance criteria before coding.

Frequently Asked Questions about spec-first

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

FAQPage Schema
How do I align requirements before coding to prevent rework?

To align requirements before coding, use structured exploration to clarify goals, constraints, and success criteria, then generate a documented design ready for review and handoff to planning.

What is the best way to present design options for a software refactor?

The best way to present design options for a software refactor is to generate 2-3 paths with clear trade-offs and a recommended approach to align stakeholders before implementation.

How do I create acceptance criteria for a feature redesign?

You create acceptance criteria for a feature redesign through question-driven clarification during stepwise exploration, outputting clear design artifacts that define success metrics.

Can I use spec-first design for dependency upgrades?

Yes, you can apply spec-first design during dependency upgrades to surface assumptions, align stakeholders, and generate a documented design proposal with clear acceptance criteria.

Why does miscommunication happen during software changes and how to prevent it?

Miscommunication happens during software changes when assumptions are not surfaced; prevent it by applying design-before-code practices to align goals and constraints before implementation.