author-feature

Generates feature design documents in .claude/features/ through structured user interviews and codebase exploration.

Updated May 2, 2024
One-click install
npx skills add https://github.com/cman131/EatSomethingSourWhenYoureTired --skill author-feature-cman131
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: author-feature
Source: https://github.com/cman131/EatSomethingSourWhenYoureTired/tree/main/.claude/skills/author-feature
Command: npx skills add https://github.com/cman131/EatSomethingSourWhenYoureTired --skill author-feature-cman131

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a body of work spans multiple stories, teams need an overarching design captured before any stories are written. This Skill turns a feature idea into a structured Feature design doc, preventing fragmented or inconsistent story planning. ## Core Features & Use Cases - Codebase-Aware Exploration: Reads ADRs in docs/decisions/, greps src/ for relevant services and entities, and checks .claude/features/ for overlapping docs before asking questions. - Structured One-at-a-Time Interview: Walks through problem, scope, affected code, dependencies, and an explicit gating decision (none, feature flag, or permanent entitlement). - Design-Only Document Generation: Writes a kebab-case-slugged markdown doc to .claude/features/ with sections for context, goals, architecture, affected files, gating, and constraints, then self-reviews against quality gates. - Use Case: A developer planning a multi-story game verification system uses this Skill to capture the overarching design and gating decision first, then optionally hands off to story-author to generate linked stories. ## Quick Start Ask the AI to author a feature design doc for your feature idea, optionally providing a feature name or short description as an argument.

Frequently Asked Questions about author-feature

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

FAQPage Schema
How do I create a feature design doc before writing stories?▼

Invoke the author-feature skill with a feature name or description. It explores the codebase for relevant context, interviews you one question at a time about problem, scope, and gating, then writes a design-only markdown doc to .claude/features/.

What sections does the generated feature document contain?▼

The doc includes Context/Problem, Goals & Non-Goals, Architecture & Approach, Affected Areas/Files, Gating (flag/entitlement), Constraints/Out of Scope, and Open Questions. Sections without real facts are deleted rather than left as placeholders.

Does the feature doc include a story breakdown or task list?▼

No. The doc is design-only with no story enumeration. After you confirm it, the skill optionally hands off to the story-author agent, which decomposes the feature into stories linked back via a Parent Feature line.

How are feature flags and entitlements handled in the design?▼

The interview explicitly asks whether the feature ships ungated, behind a named feature flag (temporary or long-lived), or behind a permanent entitlement. The decision is recorded in the doc's Gating section and enforced in generated stories.

When should I not use a feature design doc?▼

Skip it for work that fits within a single story or needs no overarching design. The skill is intended for bodies of work spanning multiple stories where shared architecture and gating decisions must be captured first.