Spec

Convert unstructured notes and chats into a formal requirements document.

1|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/samdae/archflow --skill spec-samdae
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Spec
Source: https://github.com/samdae/archflow/tree/main/skills/spec
Command: npx skills add https://github.com/samdae/archflow --skill spec-samdae

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Spec skill transforms scattered materials into structured, testable requirements documents, establishing a single source of truth for product initiatives.

Core Features & Use Cases

  • Collects service names and input materials, performs an iterative refinement loop with Q&A to resolve ambiguities.
  • Generates a formal requirements document structure ready for arch/design handoffs.
  • Supports Notion/Markdown inputs and converts them into a consistent spec format.

Quick Start

Launch the Spec skill, provide the input material (Notion/Markdown or chat history), and name your service. The tool will produce a standardized docs/{serviceName}/spec.md and guide you through the Q&A to finalize the requirements.

Frequently Asked Questions about Spec

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

FAQPage Schema
How do I turn unstructured notes into a formal requirements document?▼

To turn unstructured notes into a requirements document, provide scattered Markdown or Notion inputs to trigger an iterative Q&A refinement loop that resolves ambiguities and outputs a structured specification.

Can I generate acceptance criteria and traceable IDs from scattered chat history?▼

Yes, you can generate acceptance criteria and traceable IDs from chat history by feeding the conversations as input material, which the system converts into a standardized specification format with unique identifiers.

Does this requirements generation process support Markdown and Notion inputs?▼

The requirements generation process supports both Notion and Markdown inputs, converting them into a consistent specification format ready for architecture and design handoffs.

What is the best way to resolve ambiguities when writing software specifications?▼

The best way to resolve ambiguities when writing software specifications is using an iterative Q&A loop that refines scattered inspiration into clear requirements with testable acceptance criteria.

How to create a standardized spec.md file for a specific service?▼

You create a standardized spec.md file by naming your service and providing input materials, which automatically generates the formal requirements document at the output location docs/{serviceName}/spec.md.