bf-plan

Plan task-scoped implementation work using Claude Code Plan mode with architectural patterns.

Updated Apr 4, 2026

Search Tags:#workflow #planning #architecture #code #brownfield #claude-code #task-management

Ready to run

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

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: bf-plan
Source: https://github.com/ricky-yosh/agent-workflows/tree/main/skills/brownfield/bf-plan
Command: npx skills add https://github.com/ricky-yosh/agent-workflows --skill bf-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan and anchor implementation work for a batch of tasks in a brownfield project, ensuring compliance with the target area's architectural patterns.

Core Features & Use Cases

Identify the task scope from next-task.json or the first not-done task in tasks.json.
Explore the target area by loading real code examples to model patterns.
Enter Plan mode to produce a detailed, pattern-anchored plan that maps to existing code and contexts.
Surface conflicting patterns and guide the user to choose the correct approach.
Output a precise, task-scoped implementation plan that can be executed task-by-task.

Quick Start

Enter Plan mode with all context loaded for the identified task(s) and follow the plan to implement the chosen task(s).

Frequently Asked Questions about bf-plan

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

FAQPage Schema

How do I plan implementation tasks in a brownfield project while matching existing code patterns?▼

The task scope is determined automatically by reading next-task.json for a specified task or falling back to the first not-done entry in tasks.json, ensuring the plan focuses strictly on that batch.

What is the best way to ensure new code follows established architecture in an existing codebase?▼

It outputs a precise, task-scoped implementation plan that specifies modified and new files and details exactly how new components connect to existing code contexts.

Can I plan multiple tasks at once with this brownfield code-pattern alignment approach?▼

Yes, you can use Claude Code Plan mode with this approach by loading all context for the identified task and following the generated plan to implement the chosen task batch-by-batch.

Why does my implementation plan need to load research.txt and spec.txt files?▼

It handles conflicting patterns by surfacing them in the plan and guiding the user to choose the correct architectural approach before finalizing the implementation steps.

Do I need next-task.json to start planning brownfield work?▼

It works best for brownfield project task management where maintaining compliance with established architectural patterns during implementation is critical.