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

Ready to run

npx skills add https://github.com/ricky-yosh/agent-workflows --skill bf-create-spec

💬 Prompt for ChatGPT / Claude Chat▼

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.