All skills
jeffallan avatar

/feature-forge

@efebc44
by jeffallanjeffallan/claude-skills12k stars
1,127

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.

Use this Skill: https://skilld.dev/gh/jeffallan/claude-skills/feature-forge

This session only. Nothing lands on disk.

referencesinterview-questions.md

≈1.4k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Interview Questions

PM Hat Questions

Focus on user value and business goals.

Area Questions
Problem What problem does this solve? Who experiences this problem? How often?
Users Who are the target users? What are their goals? Technical level?
Value How will users benefit? What's the business value? ROI?
Scope What's in scope? What's explicitly out of scope? MVP vs full version?
Success How will we measure success? Key metrics?
Priority Is this a must-have, should-have, or nice-to-have?

Example PM Questions

For a "User Export" feature:
- Who needs to export data and why?
- What format do they need (CSV, JSON, Excel)?
- How much data? 100 rows or 1 million?
- Is this for compliance (GDPR) or convenience?
- How often will this be used?
- What's the deadline?

Dev Hat Questions

Focus on technical feasibility and edge cases.

Area Questions
Integration What systems does this touch? APIs, databases, services?
Security Authentication required? Data sensitivity (PII, PCI)?
Performance Expected load? Response time requirements? Async OK?
Edge Cases What happens when X fails? Empty states? Limits?
Data What's stored? Retention period? Backup needs?
Dependencies External services? Rate limits? Costs?

Example Dev Questions

For a "User Export" feature:
- What fields to include? Are any sensitive (passwords, tokens)?
- Max export size? Need streaming or background job?
- Should include soft-deleted records?
- What happens if export fails midway?
- File retention - how long to keep generated files?
- Need progress indicator for large exports?

Tool Usage: AskUserQuestions

Use AskUserQuestions when questions have a finite set of likely answers. Use open-ended follow-up when answers are unbounded.

When to Use Structured Options

Question Pattern Example Options Style
Priority/ranking "Is this must-have or nice-to-have?" Single select: Must-have, Should-have, Nice-to-have
Format selection "What export format?" Multi-select: CSV, JSON, Excel, PDF
Scope decisions "MVP or full version?" Single select: MVP, Full, Phased
Yes/No with nuance "Auth required?" Single select: Public, Authenticated, Role-based

When to Use Open-Ended

  • "Describe the user journey in your own words"
  • "What problem does this solve?"
  • "Walk me through the workflow"

Example: Structured Elicitation

For a "User Export" feature, batch related choices:

Question 1 (header: "Export scope"): "What data should users be able to export?" Options: "Own data only", "Team data", "Organization-wide", multi-select enabled

Question 2 (header: "Format"): "Which export formats should be supported?" Options: "CSV", "JSON", "Excel (.xlsx)", "PDF", multi-select enabled

Question 3 (header: "Priority"): "How critical is this feature?" Options: "Must-have (blocking)", "Should-have (important)", "Nice-to-have (future)"


Interview Flow

Phase 1: Discovery

Use open-ended questions to understand the problem space:

  1. "Tell me about this feature in your own words"
  2. "What problem are we solving?"

Then use AskUserQuestions to narrow down:

  • Target users (single select from identified personas)
  • Usage frequency (Daily, Weekly, Monthly, Rarely)
  • Priority (Must-have, Should-have, Nice-to-have)

Phase 2: Details

Use AskUserQuestions for scope and constraint decisions:

  • Scope: MVP vs Full vs Phased (single select)
  • Key capabilities (multi-select from discovered items)

Then open-ended: "Walk me through the user journey"

Phase 3: Edge Cases

Use AskUserQuestions for technical trade-offs:

  • Error handling approach (Retry, Fail fast, Queue, Notify)
  • Data limits (multi-select thresholds)

Then open-ended: "What happens when [X] fails?"

Phase 4: Validation

Present spec summary, then use AskUserQuestions:

  • "Does this capture your requirements?" (Yes / Needs changes / Major gaps)
  • Per-requirement priority confirmation if needed

Multi-Agent Pre-Discovery

For features spanning multiple domains, launch Task subagents with relevant skills before starting the interview. This front-loads technical context so the interview focuses on decisions rather than exploration.

Pattern: Parallel Skill-Invoked Discovery

User request: "I need a feature that does X"

Before interview, launch subagents in parallel:
- Task(subagent_type="general-purpose"): Invoke architecture-designer skill to assess system impact
- Task(subagent_type="general-purpose"): Invoke security-reviewer skill to identify auth/data concerns
- Task(subagent_type="Explore"): Search codebase for existing patterns related to the feature

Collect subagent findings → Use them to inform interview questions

This ensures the Feature Forge interview starts with concrete technical context rather than assumptions.


Quick Reference

Phase Focus Tool
Pre-Discovery Technical context Task subagents with skills
Discovery Problem, users, value Open-ended → AskUserQuestions
Details Journey, scope, constraints AskUserQuestions → Open-ended
Edge Cases Failures, limits, security AskUserQuestions → Open-ended
Validation Summary, gaps AskUserQuestions

Source: SKILL.md on GitHub

1 alert16d5 checks · Risk CRITICAL
  • Gen Agent Trust Hub16d

    This skill and its documentation URL have been flagged as malicious by automated scanners. The skill also possesses a vulnerability to indirect prompt injection due to its method of ingesting and processing untrusted user requirements.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer6mo

    6 files scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at efebc44. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Steadyupdated 5 months ago
Other metadata
metadata
{
  "author": "https://github.com/Jeffallan",
  "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"
}
  • requirements
  • specification
  • user-stories
  • ears
  • acceptance-criteria
  • planning
  • prd
  • workshop
  • feature-definition

README badge

README badge for jeffallan/claude-skills/feature-forge

Conducts structured requirements workshops using PM and Dev perspectives to produce feature specifications, EARS-format functional requirements, acceptance criteria, and implementation checklists. Targets feature definition, requirements gathering, and specification writing workflows with systematic discovery and validation phases.

Generated from the current SKILL.md.

Does this skill write the spec automatically, or does it require user input?
It requires structured user input through interviews and discovery questions. The skill conducts a systematic workshop using the AskUserQuestions tool to gather requirements before producing the specification.
What output formats does this skill produce?
It produces EARS-format functional requirements, Given/When/Then acceptance criteria, non-functional requirements, error handling tables, and implementation TODO checklists, all saved as a markdown specification document.
Can this skill handle complex features that span multiple domains?
Yes. The skill includes guidance for using multi-agent discovery with Task subagents on features spanning multiple domains, documented in the pre-discovery-subagents reference.
Does this skill cover non-functional requirements like performance and security?
Yes. It explicitly requires inclusion of non-functional requirements, security considerations, and error handling as part of the specification output.

Generated from the current SKILL.md. These answers refresh after source changes.