spec-writing

Extract behavioral scenarios from rough intent via 5-round Given/When/Then/Verify interviews.

5|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/thevibethinker/n5os-ode --skill spec-writing-thevibethinker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-writing
Source: https://github.com/thevibethinker/n5os-ode/tree/main/Skills/spec-writing
Command: npx skills add https://github.com/thevibethinker/n5os-ode --skill spec-writing-thevibethinker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Structured interview to extract behavioral scenarios from rough intent before Architect planning. Runs before Pulse interview and outputs scenario specs that become input to PLAN.md.

Core Features & Use Cases

  • 5-round structured interview to capture intent, edge cases, failure modes, and decision points.
  • Outputs: scenario list, ambiguities, and decisions for PLAN.md input used by the Architect.
  • Designed to be used before Pulse builds or when a user describes a new feature or system.

Quick Start

Describe your goal and let Spec-Writing guide a 5-round interview to generate PLAN.md input.

Frequently Asked Questions about spec-writing

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

FAQPage Schema
How do I extract behavioral scenarios from rough feature intent before planning?

To extract behavioral scenarios from rough intent, you can use a structured 5-round Given/When/Then/Verify interview process. This method captures intent, edge cases, failure modes, and decision points to produce a finalized scenario spec.

What is the best way to capture edge cases and failure modes for a new system?

The best way to capture edge cases and failure modes is through a 5-round structured interview designed to uncover ambiguities and decisions. It systematically probes your feature description to ensure all behavioral scenarios are documented.

How do I generate input for PLAN.md when describing a new feature?

You generate input for PLAN.md by completing a structured behavioral scenario interview. The output is a finalized scenarios document containing the scenario list, ambiguities, and decisions required for Architect planning.

When do I need to run a Given/When/Then interview for feature planning?

You need to run a Given/When/Then interview before initiating Pulse builds or when you first describe a new feature or system. It ensures rough intent is converted into executable scenario specs before architectural planning begins.

Does scenario spec writing work without an Architect planning phase?

Scenario spec writing is designed to produce output specifically for Architect planning input. Without this downstream planning phase, the finalized scenarios document and identified decisions would not be utilized for PLAN.md creation.