mcpField
B
bro-give-me-plan

bro-give-me-plan

github.com/irpsvAgent workflows9202 installsUpdated 2d ago
Repository

About bro-give-me-plan

bro-give-me-plan is an agent skill for turning a specific task into an unambiguous implementation plan without writing code. It is intended for users who need implementation steps and distinguishes planning from writing a specification.

Key features

  1. 01Creates step-by-step implementation plans
  2. 02Does not produce code or pseudocode
  3. 03Resolves ambiguities before planning
  4. 04Selects inline, file, or create-plan workflow

Use cases

  1. 01Planning a clearly scoped implementation task
  2. 02Clarifying unknowns before implementation planning
  3. 03Choosing a plan format for a task

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/irpsv/ai-bro --skill bro-give-me-plan

After installing, type/bro-give-me-planin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

evals/
trigger-evals.json
references/
dialog-rules.md
implementation-hygiene.md
plan-review.md
step-rules.md
subagent-model-tiers.md
references/templates/
file-plan-template.md
references/workflows/
create-plan.md
file-plan.md
inline-plan.md
subagents/
closer-prompt.md

Details

From the project README

Bro Give Me Plan

Твоя задача — составить план реализации для конкретной задачи и проблемы. НЕ ПИШИ сам код, только составляй план. Если человеку нужна спецификация результата без шагов реализации, ОСТАНОВИСЬ и предложи /bro-give-me-spec.

ОБЩИЕ ПРАВИЛА

  • ОБЯЗАТЕЛЬНО соблюдай правила диалога!
  • ОБЯЗАТЕЛЬНО соблюдай гигиену реализации!
  • ОБЯЗАТЕЛЬНО соблюдай и НЕ нарушай порядок работы!
  • План ДОЛЖЕН быть однозначным, без наличия вариаций и вопросов в нём. Все вопросы и вариации НУЖНО решать с человеком.
  • План НЕ ДОЛЖЕН подменять шаги реализации кодом, diff, патчами или псевдокодом.
  • Если в плане есть раздел критериев приемки, они ДОЛЖНЫ покрывать целевой результат наблюдаемыми утверждениями. Способ проверки (автотест, ручная проверка, сборка и т.п.) в критерии НЕ указывай.

ОГРАНИЧЕНИЯ / STOP

  • ЗАПРЕЩЕНО нарушать порядок работы и правила workflows
  • ЗАПРЕЩЕНО придумывать и додумывать факты или гипотезы. Любая неоднозначность ДОЛЖНА быть решена до перехода к составлению плана.
  • ЗАПРЕЩЕНО при доступном CreatePlan (или аналоге) спрашивать выбор inline / file или писать файл плана самому вместо вызова тула.

ПОРЯДОК РАБОТЫ

  1. СОБЕРИ информацию для составления однозначного плана: код, контекст:
    • Не спрашивай то, что можно установить с высокой уверенностью.
    • Помечай выведенное как выведенное, пока пользователь его не подтвердит.
  2. ЗАПРОСИ недостающую информацию у человека. ОБЯЗАТЕЛЬНО соблюдай правила диалога.
  3. ОПРЕДЕЛИ какой workflow нужно использовать, следуя правилам определения workflow.
  4. ПОДКЛЮЧИ файл с инструкциями выбранного workflow. СОБЛЮДАЙ все инструкции из выбранного workflow.

ПРАВИЛА ОПРЕДЕЛЕНИЯ WORKFLOW

Ниже описаны правила как определить какой workflow использовать в зависимости от запроса. НЕ ЧИТАЙ файл с инструкциями inline / file до тех пор, пока не подтвердишь выбор у человека. Для create-plan подтверждение не нужно — подключай сразу после выбора. СНАЧАЛА оцени задачу по следующим критериям:

  • доступен ли в сессии тул CreatePlan (или аналог harness для создания плана);
  • нужен ли отдельный файловый артефакт плана (новый чат, ревью вне чата, явные «Рамки» / «Критерии приёмки»);
  • достаточно ли шагов в чате без отдельного файла.

ВЫБЕРИ workflow на основе критериев полученных ранее. Для inline и file — ОСТАНОВИСЬ и ЗАПРОСИ подтверждение выбранного workflow у пользователя. СКАЖИ почему именно этот workflow ты рекомендуешь. Для create-plan подтверждение НЕ запрашивай.

create-plan

Используй если:

  • в текущей сессии доступен тул CreatePlan (или аналог harness для создания плана)

При выборе этого workflow НЕ СПРАШИВАЙ inline / file и НЕ ЗАПРАШИВАЙ подтверждение.

Файл с инструкциями: create-plan

inline

Используй если:

  • CreatePlan (или аналог) недоступен
  • небольшая задача и понятный целевой результат
  • рамки и проверка укладываются в шаги и/или уже ясны из контекста
  • не нужны артефакты до и после реализации

Файл с инструкциями: inline-plan

file

Используй если:

  • CreatePlan (или аналог) недоступен
  • небольшая задача и понятный целевой результат
  • план должен пережить новый чат, нужен файловый артефакт
  • нужны явные разделы «Рамки» или «Критерии приёмки» отдельно от шагов

Файл с инструкциями: file-plan

Крупные многоэтапные инициативы НЕ планируй через этот скилл одним большим планом: сначала зафиксируй желаемый результат через /bro-give-me-spec, а планы составляй на конкретные небольшие задачи.

Comments

Markdown supported