specclaw — плагин для Claude Code: жизненный цикл от идеи до PR
Ведёт изменение по шагам: предложение, план, сборка, проверка, pull request. Каждый шаг оставляет короткий след в репозитории.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install specclaw@claude-communityЧто делает specclaw
SpecClaw превращает обычную фразу в описание изменения и дальше ведёт его до готового PR. Сначала вы говорите «I have a proposal», плагин пишет changes/001-…/change.md с проблемой и критериями приёмки и рисует макет, который можно открыть в браузере. Макет появляется до кода, поэтому результат видно заранее.
Дальше /specclaw:plan добавляет задачи под каждый критерий, /specclaw:build делает по коммиту на задачу, /specclaw:verify прогоняет тесты и снимает скриншоты через Playwright, а /specclaw:pr открывает pull request. Всё складывается в .specclaw/ рядом с проектом: config.yaml, STATUS.md, mock/index.html и папка changes. Скрипты из bin/ читают и пишут только эту папку.
Нужен Claude v2.1 или новее. По умолчанию у нового проекта flow: lean — один файл change.md на изменение, без панели ревью и агентов код-ревью. Если в config.yaml ключа flow нет, проект читается как full со старыми proposal.md, spec.md, design.md, tasks.md и verify-report.md. Есть отдельные плагины того же маркетплейса: specclaw-bf для пересборки легаси, specclaw-sync для GitHub, Azure DevOps и Jira, specclaw-extras с дополнительными командами. Все четыре идут одной версией, и если в конфиге включён не установленный аддон, хук на старте сессии печатает команду установки.
Какие задачи решает
- превратить идею на словах в описание изменения с критериями приёмки
- показать макет до того, как написан код
- разбить изменение на задачи и коммиты
- сверить результат с макетом через скриншоты
- открыть pull request с записью об изменении
Примеры запросов агенту
- У меня есть предложение: проверять имя покупателя по санкционным спискам
- Запусти /specclaw:init и создай .specclaw/
- Спланируй изменение 001-… и собери его
Как установить specclaw
Через маркетплейс плагинов
/plugin marketplace add anthropics/claude-plugins-community/plugin install specclaw@claude-communityПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о specclaw
Как установить specclaw в Claude Code?
Сначала добавьте маркетплейс: /plugin marketplace add anthropics/claude-plugins-community, затем поставьте плагин: /plugin install specclaw@claude-community.
Что делает specclaw?
Проводит изменение по циклу propose → plan → build → verify → pr и хранит записи об этом в папке .specclaw/ вашего проекта.
Чем lean отличается от full?
flow: lean держит один файл change.md на изменение и пропускает панель ревью. flow: full добавляет proposal.md, spec.md, design.md, tasks.md и verify-report.md; конфиг без ключа flow читается как full.
Исходный текст
specclaw · MIT
<div align="center"> # 🦞 SpecClaw ### _"I have a proposal."_ **Spec-driven development for Claude Code and Codex.** Turn a plain-English idea into merged, production-ready code through a fully automated SDLC.  [](https://github.com/chan4lk/specclaw/actions/workflows/ci.yml) [](https://github.com/chan4lk/specclaw/releases) [](LICENSE) [](https://claude.com/claude-code) [](https://github.com/chan4lk/specclaw/stargazers) [](CONTRIBUTING.md) </div> Just say **"I have a proposal"**. SpecClaw takes a change from idea to pull request (propose, plan, build, verify, pr) and keeps a short paper trail in your repo. Every change starts as a mock you can open in a browser, so you see the result before any code is written. > **Try it:** `/plugin marketplace add chan4lk/specclaw`, `/plugin install specclaw@chan4lk`, `/specclaw:init` ## Install Requires [Claude Code](https://claude.com/claude-code) v2.1 or later. ``` /plugin marketplace add chan4lk/specclaw /plugin install specclaw@chan4lk ``` Add-ons from the same marketplace are installed only when you need them: | Plugin | Adds | Install | |---|---|---| | `specclaw` | The lifecycle: init, propose, plan, build, verify, pr, status, archive | `/plugin install specclaw@chan4lk` | | `specclaw-bf` | Brownfield rebuilds: analyze, clarify, baseline, replay and rebuild a legacy app (`/specclaw-bf:bf-*`, see [docs/rebuild-workflow.md](docs/rebuild-workflow.md)) | `/plugin install specclaw-bf@chan4lk` | | `specclaw-sync` | GitHub issues, Azure DevOps boards and PRs, Jira (`/specclaw-sync:*`) | `/plugin install specclaw-sync@chan4lk` | | `specclaw-extras` | auto, loop, learn, patterns, context, author-spec, debug, renumber and the review panel (`/specclaw-extras:*`) | `/plugin install specclaw-extras@chan4lk` | All four share one version. When your config uses an add-on that is not installed, the session-start hook prints the install command. **Codex:** `codex plugin marketplace add chan4lk/specclaw --sparse .agents/plugins`, then `codex plugin add specclaw@chan4lk`. In this checkout, Codex also finds the repo-local adapter at `.agents/skills/specclaw/`; invoke it with `$specclaw`. ## Quickstart ``` > /specclaw:init Creates .specclaw/ with flow: lean and a blank mock at .specclaw/mock/index.html. > /specclaw:propose "screen a buyer name against sanction lists" Writes changes/001-…/change.md (problem + acceptance criteria) and draws the mock. Open .specclaw/mock/index.html#001-… and approve. > /specclaw:plan 001-… Adds the fewest tasks that meet every criterion: UI first, then backend, then integration. > /specclaw:build 001-… One commit per task, at most one test per criterion. > /specclaw:verify 001-… Runs tests, then screenshots the app and the mock (Playwright) or asks you to compare by eye. > /specclaw:pr 001-… Opens the GitHub PR with the change record staged. ``` Change 001 draws the whole app at low fidelity. Each later change edits only its own `<section data-change="…">` in the mock, so the mock always shows what is coming next. ## Lean and full flow `flow: lean` (the default for new projects) keeps one file per change, `change.md`, and skips the review panel and code-review agents. Set `flow: full` in `.specclaw/config.yaml` for the older flow with `proposal.md`, `spec.md`, `design.md`, `tasks.md` and `verify-report.md`. A config with no `flow` key reads as `full`, so existing projects keep working. ## Project layout ``` .specclaw/ ├── config.yaml # flow, models, git strategy, integrations ├── STATUS.md # dashboard ├── mock/index.html # the living mock (lean) └── changes/<NNN>-<slug>/change.md ``` Scripts in each plugin's `bin/` are on PATH while the plugin is installed. They read and write `.specclaw/` in your project and nothing inside the plugin install. ## Repository This repo is the `chan4lk` marketplace: `.claude-plugin/marketplace.json` and `.agents/plugins/marketplace.json` list the four plugins under `plugins/`. Each plugin has `.claude-plugin/plugin.json`, `.codex-plugin/plugin.json`, `skills/`, `bin/` and `tests/`. CI runs every `tests/run-*-tests.sh` suite and the shellcheck gate. ## License MIT. PRs welcome; see [CONTRIBUTING.md](CONTRIBUTING.md).
© chan4lk · MIT · chan4lk/specclaw
