К основному содержанию
скилл CX Codex

bmad-tech-spec — скилл для Claude Code: лёгкий техспек за 1-15 историй

Скилл bmad-tech-spec для Claude Code создаёт компактный техспек для небольших фич вместо полного PRD и архитектуры. Он собирает один артефакт перед разработкой историй.

MIT 114 установок ★ 493 обновлён 2026-06-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-tech-spec -a claude-code
Открыть на GitHub

Что делает bmad-tech-spec

Скилл нацелен на Quick Flow — трек для работ объёмом 1-15 историй внутри одной команды. Вместо отдельных документов (PRD, архитектура) он собирает в один файл tech-spec.md описание проблемы и решения, требования (с тегами MUST/SHOULD/COULD), стек и ключевые компоненты, черновой бэклог историй и таблицы зависимостей и рисков.

Работает в трёх режимах: создание нового спека, правка существующего, проверка на полноту по BMAD критериям. На каждом шаге скилл собирает контекст (требования, техподход, список историй), заполняет шаблон и пишет результат в bmad-output/tech-spec.md. Если при разговоре объём вырастет сверх 15 историй или понадобится несколько команд, скилл остановит работу и предложит переключиться на полный BMAD трек (bmad-prd + bmad-architecture).

Тестирование в спеке — только описание стратегии (что проверять и почему), без кода и метрик как обязательных цели. Все значимые решения логируются в decision-log.md.

Какие задачи решает

  • Написать техспек для фичи объёмом до 15 историй
  • Собрать требования, стек и бэклог в один документ вместо PRD+архитектуры
  • Проверить черновой спек на полноту перед началом разработки
  • Обновить существующий техспек при изменении требований или подхода

Примеры запросов агенту

  • Напиши техспек для нового API, требования нужно собрать с нуля
  • Проверь мой черновой спек на полноту по BMAD критериям
  • Обнови техспек: мы добавили кэширование в требования

Как установить bmad-tech-spec

1Через Skills CLI (Vercel)

npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-tech-spec -a claude-code

2Вручную: положить файлы

~/.claude/skills/bmad-tech-spec/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/bmad-tech-spec/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о bmad-tech-spec

Как установить bmad-tech-spec в Claude Code?

Выполни команду npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-tech-spec -a claude-code, затем прочитай инструкцию в файле ~/.claude/skills/bmad-tech-spec/SKILL.md.

Что делает bmad-tech-spec?

Создаёт лёгкий техспек для работ объёмом 1-15 историй вместо полного PRD и архитектуры. Собирает проблему, решение, требования (MUST/SHOULD/COULD), стек, бэклог и риски в один файл tech-spec.md.

Когда переходить с Quick Flow на полный BMAD трек?

Если во время работы объём вырастет сверх 15 историй, понадобятся несколько команд или внешние интеграции на масштабе — переключись на bmad-prd и bmad-architecture. Скилл подскажет, если это случится.

Исходный текст

SKILL.md · MIT
---
name: bmad-tech-spec
description: |
  Quick Flow lightweight technical specification for small-scope work (1-15 stories).
  Replaces the full PRD + architecture pair when scope is small and requirements are clear.
  Produces bmad-output/tech-spec.md as the single planning artifact before story creation.

  Use when the user says: "write a tech spec", "create a technical specification",
  "I need a tech spec for this feature", "quick spec", "small project spec", "we don't
  need a full PRD", "just a tech spec", "spec out this change", "document this feature".

  QUICK FLOW TRACK ONLY (1-15 stories). If scope grows beyond ~15 stories or involves
  multiple teams / external integrations at scale, stop and redirect to bmad-prd +
  bmad-architecture instead — those skills are built for that complexity.

  Supports three intents: Create (new spec), Update (revise an existing tech-spec.md),
  Validate (review a draft for completeness against BMAD criteria).
allowed-tools: Read, Write, Edit, Glob, Grep, WebSearch, WebFetch, TodoWrite
---

# BMAD Tech Spec — Quick Flow

This skill produces a focused `tech-spec.md` for **Quick Flow** work: small, well-scoped
features or changes that sit in the 1-15 story range. It consolidates the product
rationale, technical approach, and story backlog into a single lightweight document,
skipping the separate PRD + architecture artifacts that larger tracks require.

> **Track guidance**
> - 1-15 stories, single team, clear requirements → **Quick Flow** (this skill)
> - 10-50+ stories, multiple concerns, or uncertain scope → use **bmad-prd** then **bmad-architecture**
> - 30+ stories, cross-org, security/compliance/DevOps dimensions → **Enterprise** track

---

## Workflow

### Step 1 — Identify intent

Ask the user (or infer from context) which of three intents applies:

| Intent | When |
|--------|------|
| **Create** | No tech-spec.md exists yet |
| **Update** | Revising scope, requirements, or approach in an existing spec |
| **Validate** | Checking a draft spec for BMAD completeness before moving to stories |

### Step 2 — Gather context

For **Create**, collect (interactively or from existing project files):

1. **Problem & solution** — what are we solving and how?
2. **Scope** — what is in scope? What is explicitly out of scope?
3. **Functional requirements** — numbered, MoSCoW-tagged (MUST / SHOULD / COULD)
4. **Non-functional requirements** — performance, security, accessibility targets that are relevant; omit boilerplate that does not apply
5. **Technical approach** — stack, key components, data model sketch, API surface (if any)
6. **Story list** — high-level backlog items; the scrum-master skill will compile them into full story files
7. **Dependencies & risks** — third-party libs, external services, known unknowns
8. **Decision log entries** — any choices made during this conversation that belong in `bmad-output/decision-log.md`

Load `bmad-output/project-context.md` if present — it is the project constitution and must
not be contradicted without a recorded decision.

For **Update**, read the existing `bmad-output/tech-spec.md` first, then apply targeted
edits and log what changed in the decision log.

For **Validate**, read the existing spec and report against the checklist in the
[Validation Checklist](#validation-checklist) section below.

### Step 3 — Draft or revise

Render the template at:

```
${CLAUDE_PLUGIN_ROOT}/skills/bmad-tech-spec/templates/tech-spec.template.md
```

Fill every section. Omit sections that genuinely do not apply (e.g., no API design for a
pure-CLI tool) and note the omission inline. Do not leave unreplaced `{{placeholders}}`.

Testing strategy in the spec is **planning only** — describe what should be tested and
why. Do not write test code. Do not set coverage numbers as mandatory targets; frame them
as guidance for the dev team.

### Step 4 — Write output

Write to `bmad-output/tech-spec.md` (respecting the `outputFolder` user config if set).

If decision-log entries were made, append them to `bmad-output/decision-log.md`
(create the file if it does not exist, using the format: `## [YYYY-MM-DD] <title>` /
`**Decision:** ...` / `**Rationale:** ...`).

### Step 5 — Confirm next steps

After writing, tell the user:

- The spec is the Quick Flow planning artifact. Story creation is the next step.
- Use **bmad-epics-and-stories** to compile stories from the story list in the spec.
- If scope has grown during this conversation beyond ~15 stories, recommend switching to
  the BMad Method track (bmad-prd + bmad-architecture) before proceeding.

---

## Validation Checklist

When intent is **Validate**, report pass/fail for each item:

- [ ] Problem statement is clear and specific
- [ ] Solution is described without implementation code
- [ ] All functional requirements are numbered and MoSCoW-tagged
- [ ] Non-functional requirements include at least one performance or security entry if applicable
- [ ] Technical approach names the stack and describes key components
- [ ] Story list exists and each story title is one-line, action-oriented
- [ ] Story count is 1-15 (flag if over)
- [ ] No unreplaced `{{placeholders}}` remain
- [ ] Testing section describes strategy only (no executable test code)
- [ ] Dependencies table lists version or version constraint
- [ ] Risks table lists at least one risk with a mitigation
- [ ] Decision log entries have been written for any significant choices
- [ ] No content instructs a dev agent to run tests, lint, build, or deploy

---

## Subagent Strategy

This skill is primarily single-threaded (one conversation, one document). Parallelism is
optional and limited to information gathering:

- If the user wants **concurrent research** (e.g., compare two tech options), spawn two
  WebSearch/WebFetch agents in parallel and synthesize results before writing the spec.
- Do not spawn parallel agents for writing — the spec is one coherent document and must
  be written atomically to avoid merge conflicts.

---

> ---
> Part of the **BMAD Planning & Orchestrator** plugin — a Claude Code harness for the **BMAD Method** by the **BMAD Code Organization** (https://github.com/bmad-code-org/BMAD-METHOD). Implements the spirit of `bmad-tech-spec`. All methodology credit belongs to the BMAD Code Organization.

© aj-geddes · MIT · aj-geddes/claude-code-bmad-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
bmad-agent-pm bmad-code-org Скилл bmad-agent-pm для Claude Code и Cursor выступает в роли менеджера продуктов Джона для написания, обновления и проверки планов проектов. CX Codex +1 17 800установок spec Klerith Проектирует спецификации по методологии spec-driven development. Задаёт уточняющие вопросы блоками и формирует файл требований в папке specs/ перед написанием кода. CX Codex +1 5 000установок spec-writer dannwaneri Скилл spec-writer превращает туманное описание фичи в структурированный спек, технический план и список задач. Помечает каждое предположение прямо в тексте, чтобы вы могли исправить неточности до того, как агент начнёт кодить. CX Codex +1 ★ 29звёзд репо absolute-spec dhruvjainin Скилл absolute-spec для Claude Code превращает запрос на функцию в проектную спецификацию после изучения кодовой базы. Агент задаёт несколько уточняющих вопросов, записывает документ в docs/plans/ и передаёт его на отдельную оценку. CX Codex +1 176установок quick-spec qdhenry Команда quick-spec разбирает кодовую базу, задаёт до 10 вопросов и пишет готовую спецификацию в файл. Для простых фич и рефакторингов, где полный опрос избыточен. CX Codex +1 ★ 1 357звёзд репо bmad-architecture bmad-code-org Скилл bmad-architecture пишет короткий архитектурный документ: фиксирует только те решения, без которых независимо собранные части системы разойдутся. CX Codex +1 17 800установок

Из того же набора11

Весь набор →
bmad-epics-and-stories Скилл bmad-epics-and-stories превращает PRD и архитектуру в готовый к разработке бэклог: один файл epics.md и набор самодостаточных story-файлов с критериями приёма, заметками разработчика и картой зависимостей. CX Codex +1 138установок bmad-research Скилл bmad-research для Claude Code проводит структурированное исследование рынка, конкурентов, технологий и отрасли, собирая данные из живых источников и оформляя их в цитируемый отчёт. CX Codex +1 138установок bmad-brainstorm Скилл bmad-brainstorm запускает структурированные мозговые штурмы по методикам вроде SCAMPER, SWOT и «5 почему». Формирует отчёт с выводами для дальнейшего планирования. CX Codex +1 130установок bmad-spec Скилл bmad-spec для Claude Code превращает заметки, PRD или расшифровку в короткий файл SPEC.md с пятью разделами. Он включается, когда нужно сформулировать задачу и границы проекта. CX Codex +1 108установок bmad-readiness-check Скилл bmad-readiness-check для Claude Code сверяет документы планирования перед началом разработки. Запускается по просьбе проверить готовность требований, архитектуры и эпиков к реализации. CX Codex +1 107установок bmad-document-project Скилл bmad-document-project для Claude Code сканирует готовый репозиторий в режиме чтения и сохраняет файл project-documentation.md. Документ фиксирует стек и архитектуру перед планированием дальнейших задач. CX Codex +1 104установок bmad-sprint-planning Скилл bmad-sprint-planning для Claude Code раскладывает истории по зависимостям и формирует план передачи в разработку. Запускается по просьбе упорядочить истории, составить волны или создать sprint-status.yaml. CX Codex +1 104установок bmad-investigate Скилл bmad-investigate для Claude Code расследует баги и оформляет факты в case file. Запускается по запросу найти причину ошибки, разобрать инцидент или обновить расследование. CX Codex +1 102установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой