bf-plan

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

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/ricky-yosh/agent-workflows --skill bf-plan
Or copy as Structured Prompt for Agent
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.