skills.rest
ricky-yosh
ricky-yoshCOMMUNITY
Explore all skills by this author →
GitHub

bf-create-spec

Interview stakeholders and generate a structured spec.txt draft for brownfield projects.

Updated Apr 4, 2026
Search Tags:#requirements#interview#spec#brownfield#draft#stakeholders#bf-research
One-click install
npx skills add https://github.com/ricky-yosh/agent-workflows --skill bf-create-spec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bf-create-spec
Source: https://github.com/ricky-yosh/agent-workflows/tree/main/skills/brownfield/bf-create-spec
Command: npx skills add https://github.com/ricky-yosh/agent-workflows --skill bf-create-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables teams to collaboratively craft a clear implementation spec for brownfield projects by guiding interviews to clarify scope and constraints and by producing a spec.txt (with references for bf-research).

Core Features & Use Cases

  • Guided stakeholder interviews to extract requirements and constraints.
  • Generates a structured spec draft (spec.txt) with embedded research hints for bf-research.
  • Part of the brownfield skill family to standardize modernization planning.

Quick Start

Run the bf-create-spec skill to start interviews and generate the draft spec at .aw/brownfield-progress/spec.txt.draft.

Frequently Asked Questions about bf-create-spec

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

FAQPage Schema
How do I collaboratively draft a spec for a brownfield project modernization?▼

To collaboratively draft a brownfield spec, this skill guides teams through stakeholder interviews to clarify scope and constraints, then generates a structured spec draft capturing decisions and acceptance criteria for legacy-system enhancement.

What is the best way to capture requirements and constraints for legacy-system enhancement?▼

Capturing requirements for legacy-system enhancement is done through guided stakeholder interviews, which extract necessary constraints and scope decisions to inform the structured spec draft and subsequent validation processes.

How do I start stakeholder interviews to define scope for an existing product modernization?▼

Start stakeholder interviews by running the skill to interactively extract requirements and constraints, producing a spec.txt.draft file located at .aw/brownfield-progress to define your brownfield implementation scope.

Can I use this spec draft with bf-research for future validation?▼

Yes, the spec draft is designed to work with bf-research by embedding research hints directly within the generated spec.txt file, providing necessary context to inform downstream validation and modernization planning.

Does this approach work for defining acceptance criteria before implementation in brownfield scenarios?▼

Yes, defining acceptance criteria before implementation is a core function of the brownfield spec creation process, ensuring scope and constraints are clearly established for product modernization or legacy-system enhancement scenarios.

Related Skills

Explore More Product & Management Skills→
DoubleslashSEDoubleslashSE
4

codebase-analysis

Extract domain models, business rules, and data flows from existing codebases.

Community
Basic
JuniYadiJuniYadi

judge-pragmatist

Assess feature proposals for MVP scope, feasibility, and risk-reward trade-offs.

Community
Intermediate
ricky-yoshricky-yosh

bf-create-tasks

Convert ticket specs into structured tasks.json drafts for implementation planning.

Community
Intermediate
clovernguyen1010-ship-itclovernguyen1010-ship-it

bmad-agent-pm

Guide user interviews and requirements discovery to draft PRDs.

Community
Intermediate