spec-writer

Generate formal invariants and acceptance criteria from vision statements.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/Will-Aveva/phoenix-chassis --skill spec-writer-will-aveva
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-writer
Source: https://github.com/Will-Aveva/phoenix-chassis/tree/main/.agent/skills/spec-writer
Command: npx skills add https://github.com/Will-Aveva/phoenix-chassis --skill spec-writer-will-aveva

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translates broad project vision into precise, falsifiable invariants that guide specification and validation.

Core Features & Use Cases

  • Generate formal invariants and acceptance criteria from vision statements.
  • Structure outputs to align with the spec-phase schema and tooling requirements.
  • Use case: at project kickoff, convert ambiguous goals into testable constraints for later phases.

Quick Start

Provide an initial set of invariants derived from the current vision and present them in the required spec format.

Frequently Asked Questions about spec-writer

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

FAQPage Schema
How do I convert a vague project vision into falsifiable invariants?

Generate falsifiable invariants from a project vision by translating ambiguous goals into a structured spec schema, which includes sections for invariants, acceptance tests, and failure modes to guide validation.

What is the best way to write acceptance criteria from early-stage project goals?

Writing acceptance criteria from project goals involves deriving formal invariants from the vision and outputting a structured spec schema that includes testable constraints, acceptance tests, and failure modes.

How do I structure specification documents for validation planning?

Structure specification documents for validation planning by generating a spec schema that organizes outputs into sections like Title, Problem, Invariants, Interfaces, Failure Modes, Acceptance Tests, Open Questions, and Observations.

Can I generate a structured spec schema directly from a vision statement?

You can generate a structured spec schema directly from a vision statement by translating broad project goals into precise, falsifiable invariants and organizing them into required specification sections.

When do I need to use falsifiable invariants for spec-writing?

You need falsifiable invariants for spec-writing during early-stage specification, validation planning, and risk assessment to convert ambiguous project goals into testable constraints.