mcpField
B
bro-give-me-spec

bro-give-me-spec

github.com/irpsvAgent workflows9154 installsUpdated 2d ago
Repository

About bro-give-me-spec

A skill for defining a software specification that states what should change, why, and how completion can be observed, without prescribing implementation. It resolves ambiguity with the user and follows either a CreatePlan-based or file-based workflow, depending on available tools.

Key features

  1. 01Define goals and observable acceptance criteria
  2. 02Separate desired outcomes from implementation
  3. 03Resolve product ambiguities with the user
  4. 04Select a workflow based on available tools

Use cases

  1. 01Specify a feature before implementation
  2. 02Clarify scope and expected outcomes
  3. 03Define acceptance criteria for a change

Install

Copy the command and run it in a terminal.

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

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

Bundled files

References and scripts installed along with SKILL.md.

evals/
trigger-evals.json
references/
dialog-rules.md
spec-review.md
spec-template.md
subagent-model-tiers.md
references/workflows/
create-plan.md
file-spec.md
subagents/
closer-prompt.md

Details

From the project README

Bro Give Me Spec

Твоя задача — создать спецификацию результата: зафиксировать, что и зачем должно измениться и по каким наблюдаемым условиям результат готов, не определяя способ реализации. НЕ ПИШИ код и НЕ СОСТАВЛЯЙ шаги реализации.

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

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

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

  • ЗАПРЕЩЕНО добавлять в спецификацию шаги, этапы, задачи исполнителя, выбранную архитектуру решения, код, diff, патчи, псевдокод и указания, какие файлы создавать или менять. Существующие пути, типы и методы допустимы в «Задача и контекст» и «Целевой результат» как якорь текущего состояния, не как рецепт правки.
  • ЗАПРЕЩЕНО добавлять разделы сверх структуры шаблона. Раздел Принятые решения допустим только при наличии зафиксированных договорённостей.
  • ЗАПРЕЩЕНО придумывать факты или критерии. Неоднозначность результата, рамок или приемки ДОЛЖНА быть решена до готовности спецификации.
  • ЗАПРЕЩЕНО записывать файл спецификации, пока человек не назвал однозначный путь. Путь, названный в текущем запросе, уже считается ответом — не спрашивай его повторно. Если файл по заданному пути уже существует — ЗАПРЕЩЕНО обновлять его без явного одобрения на обновление.
  • ЗАПРЕЩЕНО при доступном CreatePlan (или аналоге) спрашивать путь размещения или писать файл спецификации самому вместо вызова тула.
  • ЗАПРЕЩЕНО предлагать план реализации или /bro-give-me-plan как продолжение спецификации.
  • Когда спецификация сформирована и ревью пройдено, подскажи ровно один следующий шаг: /bro-do-it. Меню следующих шагов не предлагай.

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

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

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

Ниже описаны правила как определить какой workflow использовать. НЕ ЧИТАЙ файл с инструкциями до выбора workflow. ВЫБЕРИ workflow на основе критерия.

create-plan

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

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

При выборе этого workflow НЕ СПРАШИВАЙ путь размещения.

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

file-spec

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

  • CreatePlan (или аналог) недоступен

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

Comments

Markdown supported