specify

Automate feature specification drafting with brainstorming and template formatting in Maxi.

1|Updated May 28, 2026

Search Tags:#template #planning #documentation #brainstorming #specification #requirements #docs

Ready to run

npx skills add https://github.com/amoutiers/maxi-superpowers --skill specify-amoutiers

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: specify
Source: https://github.com/amoutiers/maxi-superpowers/tree/main/skills/specify
Command: npx skills add https://github.com/amoutiers/maxi-superpowers --skill specify-amoutiers

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create a complete feature specification workflow within Maxi that coordinates brainstorming, template-based drafting, and storage of specs in docs/maxi/specs/.

Core Features & Use Cases

Orchestrates /maxi:brainstorming to elicit a complete feature specification.
Copies and formats outputs into docs/maxi/specs/NNNN-slug/spec.md using the spec-template.
Enforces frontmatter, status transitions, and structured spec content for downstream planning.

Quick Start

Ask Maxi to run /maxi:specify for your project and follow the prompts to generate and store docs/maxi/specs/NNNN-slug/spec.md

Frequently Asked Questions about specify

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

FAQPage Schema

How do I automate feature specification drafting from brainstorming notes?▼

Automating feature specification drafting involves orchestrating brainstorming sessions and mapping outputs into structured spec templates. This Skill coordinates the workflow, generating formatted specification files complete with required frontmatter and status transitions.

What's the best way to generate structured requirements documents from raw ideas?▼

Generating structured requirements documents from raw ideas requires turning brainstorming output into formatted specs. This Skill orchestrates the elicitation process and copies results into a standardized template to produce a ready feature spec.

Does this feature spec workflow require a specific project directory structure?▼

Yes, the feature spec workflow requires a specific directory structure. It stores generated specification files by deriving a slug and saving the final spec document into the project's docs/maxi/specs/ directory.

How do I manage status transitions and frontmatter for feature specs?▼

Managing status transitions and frontmatter for feature specs is handled automatically during document generation. The workflow enforces required metadata fields and structured content formatting to ensure downstream planning compatibility.

Can I use this specification template for any new feature in my project?▼

Yes, you can use this specification template for any new feature in a Maxi-managed project. The workflow applies to new features by handling prerequisites, deriving a slug, and drafting the spec content.

Limitations of using automated brainstorming for feature specification?▼

A limitation of automated brainstorming for feature specification is its dependency on the Maxi environment. The workflow is specifically designed for Maxi-managed projects, meaning it cannot operate independently outside this ecosystem.