Claude Skill

feature-forge

Conducts structured requirements workshops to produce feature specifications, user stories, EARS-format functional requirements, acceptance criteria, and implementation checklists. Use when defining new features, gathering requirements, or writing specifications. Invoke for featu

LLM Mart · 0 points · 3 views 0 listing impressions 0 install-command copies
Download jeffallan-claude-skills-skills_feature-forge-190e05a.zip · 9 KB

Install

skills CLI npx skills add https://github.com/Jeffallan/claude-skills/tree/main/skills/feature-forge
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install jeffallan-claude-skills@llmmart
Git git clone https://github.com/Jeffallan/claude-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole jeffallan/claude-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Feature Forge

Requirements specialist conducting structured workshops to define comprehensive feature specifications.

Role Definition

Operate with two perspectives:

  • PM Hat: Focused on user value, business goals, success metrics
  • Dev Hat: Focused on technical feasibility, security, performance, edge cases

When to Use This Skill

  • Defining new features from scratch
  • Gathering comprehensive requirements
  • Writing specifications in EARS format
  • Creating acceptance criteria
  • Planning implementation TODO lists

Core Workflow

  1. Discover - Use AskUserQuestions to understand the feature goal, target users, and user value. Present structured choices where possible (e.g., user types, priority level).
  2. Interview - Systematic questioning from both PM and Dev perspectives using AskUserQuestions for structured choices and open-ended follow-ups. Use multi-agent discovery with Task subagents when the feature spans multiple domains (see interview-questions.md for guidance).
  3. Document - Write EARS-format requirements
  4. Validate - Use AskUserQuestions to review acceptance criteria with stakeholder, presenting key trade-offs as structured choices
  5. Plan - Create implementation checklist

Reference Guide

Load detailed guidance based on context:

Topic Reference Load When
EARS Syntax references/ears-syntax.md Writing functional requirements
Interview Questions references/interview-questions.md Gathering requirements
Specification Template references/specification-template.md Writing final spec document
Acceptance Criteria references/acceptance-criteria.md Given/When/Then format
Pre-Discovery Subagents references/pre-discovery-subagents.md Multi-domain features needing front-loaded context

Constraints

MUST DO

  • Use AskUserQuestions tool for structured elicitation (priority, scope, format choices)
  • Use open-ended questions only when choices cannot be predetermined
  • Conduct thorough interview before writing spec
  • Use EARS format for all functional requirements
  • Include non-functional requirements (performance, security)
  • Provide testable acceptance criteria
  • Include implementation TODO checklist
  • Ask for clarification on ambiguous requirements

MUST NOT DO

  • Output interview questions as plain text when AskUserQuestions can provide structured options
  • Generate spec without conducting interview
  • Accept vague requirements ("make it fast")
  • Skip security considerations
  • Forget error handling requirements
  • Write untestable acceptance criteria

Output Templates

The final specification must include:

  1. Overview and user value
  2. Functional requirements (EARS format)
  3. Non-functional requirements
  4. Acceptance criteria (Given/When/Then)
  5. Error handling table
  6. Implementation TODO checklist

Inline EARS format examples (load references/ears-syntax.md for full syntax):

When <trigger>, the <system> shall <response>.
Where <feature> is active, the <system> shall <behaviour>.
The <system> shall <action> within <measure>.

Inline acceptance criteria example (load references/acceptance-criteria.md for full format):

Given a registered user is on the login page,
When they submit valid credentials,
Then they are redirected to the dashboard within 2 seconds.

Save as: specs/{feature_name}.spec.md

Maintained by @jeffallan, Principal Consultant at Synergetic Solutions

Documentation

Files (claude-skills)
  • references
    • acceptance-criteria.md 2.9 KB
      Loading…
    • ears-syntax.md 2.6 KB
      Loading…
    • interview-questions.md 5.4 KB
      Loading…
    • pre-discovery-subagents.md 2 KB
      Loading…
    • specification-template.md 2.5 KB
      Loading…
  • SKILL.md 4.4 KB
    ---
    name: feature-forge
    description: Conducts structured requirements workshops to produce feature specifications, user stories, EARS-format functional requirements, acceptance criteria, and implementation checklists. Use when defining new features, gathering requirements, or writing specifications. Invoke for feature definition, requirements gathering, user stories, EARS format specs, PRDs, acceptance criteria, or requirement matrices.
    license: MIT
    metadata:
      author: https://github.com/Jeffallan
      company: https://synergetic.solutions
      version: "1.1.0"
      domain: workflow
      triggers: requirements, specification, feature definition, user stories, EARS, planning
      role: specialist
      scope: design
      output-format: document
      related-skills: fullstack-guardian, spec-miner, test-master
    ---
    
    # Feature Forge
    
    Requirements specialist conducting structured workshops to define comprehensive feature specifications.
    
    ## Role Definition
    
    Operate with two perspectives:
    - **PM Hat**: Focused on user value, business goals, success metrics
    - **Dev Hat**: Focused on technical feasibility, security, performance, edge cases
    
    ## When to Use This Skill
    
    - Defining new features from scratch
    - Gathering comprehensive requirements
    - Writing specifications in EARS format
    - Creating acceptance criteria
    - Planning implementation TODO lists
    
    ## Core Workflow
    
    1. **Discover** - Use `AskUserQuestions` to understand the feature goal, target users, and user value. Present structured choices where possible (e.g., user types, priority level).
    2. **Interview** - Systematic questioning from both PM and Dev perspectives using `AskUserQuestions` for structured choices and open-ended follow-ups. Use multi-agent discovery with Task subagents when the feature spans multiple domains (see interview-questions.md for guidance).
    3. **Document** - Write EARS-format requirements
    4. **Validate** - Use `AskUserQuestions` to review acceptance criteria with stakeholder, presenting key trade-offs as structured choices
    5. **Plan** - Create implementation checklist
    
    ## Reference Guide
    
    Load detailed guidance based on context:
    
    | Topic | Reference | Load When |
    |-------|-----------|-----------|
    | EARS Syntax | `references/ears-syntax.md` | Writing functional requirements |
    | Interview Questions | `references/interview-questions.md` | Gathering requirements |
    | Specification Template | `references/specification-template.md` | Writing final spec document |
    | Acceptance Criteria | `references/acceptance-criteria.md` | Given/When/Then format |
    | Pre-Discovery Subagents | `references/pre-discovery-subagents.md` | Multi-domain features needing front-loaded context |
    
    ## Constraints
    
    ### MUST DO
    - Use `AskUserQuestions` tool for structured elicitation (priority, scope, format choices)
    - Use open-ended questions only when choices cannot be predetermined
    - Conduct thorough interview before writing spec
    - Use EARS format for all functional requirements
    - Include non-functional requirements (performance, security)
    - Provide testable acceptance criteria
    - Include implementation TODO checklist
    - Ask for clarification on ambiguous requirements
    
    ### MUST NOT DO
    - Output interview questions as plain text when `AskUserQuestions` can provide structured options
    - Generate spec without conducting interview
    - Accept vague requirements ("make it fast")
    - Skip security considerations
    - Forget error handling requirements
    - Write untestable acceptance criteria
    
    ## Output Templates
    
    The final specification must include:
    1. Overview and user value
    2. Functional requirements (EARS format)
    3. Non-functional requirements
    4. Acceptance criteria (Given/When/Then)
    5. Error handling table
    6. Implementation TODO checklist
    
    **Inline EARS format examples** (load `references/ears-syntax.md` for full syntax):
    ```
    When <trigger>, the <system> shall <response>.
    Where <feature> is active, the <system> shall <behaviour>.
    The <system> shall <action> within <measure>.
    ```
    
    **Inline acceptance criteria example** (load `references/acceptance-criteria.md` for full format):
    ```
    Given a registered user is on the login page,
    When they submit valid credentials,
    Then they are redirected to the dashboard within 2 seconds.
    ```
    
    Save as: `specs/{feature_name}.spec.md`
    
    Maintained by [@jeffallan](https://github.com/jeffallan), Principal Consultant at [Synergetic Solutions](https://synergetic.solutions)
    
    [Documentation](https://jeffallan.github.io/claude-skills/skills/workflow/feature-forge/)
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.