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

boss — плагин для Claude Code: что делает и как установить

Организует разработку через девять ролей от сбора требований до деплоя. Фиксирует артефакты каждого шага в папку .boss/ и проверяет контракты качества.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install boss@awesome-codex-plugins
Открыть на GitHub

Что делает boss

Плагин превращает агента в структурированную инженерную команду: аналитика, архитектора, дизайнера интерфейсов, техлида, скрам-мастера, разработчиков, QA и DevOps. Весь конвейер делится на этапы: pm → architect → ui → review → tasks → dev → qa → ship. Можно запустить весь процесс командой /boss или войти на отдельном шаге вроде /boss:review или /boss:dev.

Каждый этап сохраняет файлы в директорию .boss/<feature>/ — от prd.md до qa-report.md. Переход к следующей роли блокируется, если нарушен контракт качества, например при отсутствии сценариев Given-When-Then или проваленных тестах. Разработка по умолчанию ведётся через TDD: агент сначала пишет падающий тест, а потом рабочий код.

Плагин работает локально без сторонних прокси или телеметрии. Единственная сетевая часть — локальный сервер предпросмотра интерфейса на 127.0.0.1, который включается по желанию.

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

  • развернуть сквозной процесс разработки от ТЗ до деплоя
  • провести техническое ревью кода с генерацией отчёта о рисках
  • разбить требования на проверяемые задачи для спринта
  • сформировать отчёт о тестировании с фиксацией результатов проверки

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

  • /boss Сделай персональный трекер задач --skip-ui
  • /boss:review
  • /boss:qa

Как установить boss

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install boss@awesome-codex-plugins

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

Вопросы о boss

Как установить boss в Claude Code?

Сначала подключите каталог командой /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем выполните /plugin install boss@awesome-codex-plugins.

Что делает плагин boss?

Он передаёт задачу по цепочке ролевых агентов — от аналитика и архитектора до тестировщика и инженера деплоя. Результаты каждого шага сохраняются в виде Markdown-файлов внутри каталога проекта.

Можно ли пропустить отдельные шаги конвейера?

Да, флаг --skip-ui отключает проектирование интерфейса для консольных или серверных задач, а флаг --stop-after <stage> останавливает цепочку на нужном этапе.

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

boss-skill · MIT
# boss-skill

[![skills.sh](https://skills.sh/b/echovic/boss-skill)](https://skills.sh/echovic/boss-skill)
[![CodeRabbit Pull Request Reviews](https://img.shields.io/coderabbit/prs/github/echoVic/boss-skill?utm_source=oss&utm_medium=github&utm_campaign=echoVic%2Fboss-skill&labelColor=171717&color=FF570A&link=https%3A%2F%2Fcoderabbit.ai&label=CodeRabbit+Reviews)](https://coderabbit.ai)
[![G-Star Incubation](https://img.shields.io/badge/G--Star-Incubation-C71D23)](https://atomgit.com/echoVic/boss-skill)
[![AtomGit Mirror](https://img.shields.io/badge/AtomGit-Mirror-1F6FEB)](https://atomgit.com/echoVic/boss-skill)
[![Boss trust badge](https://img.shields.io/endpoint?url=https%3A%2F%2Fhol.org%2Fapi%2Fregistry%2Fbadges%2Fplugin%3Fslug%3Dechovic%252Fboss%26metric%3Dtrust%26style%3Dflat)](https://hol.org/registry/plugins/echovic%2Fboss)

**Languages / 语言 / 言語 / 언어 / Idiomas / Langues:** [English](./README.md) · [中文](./README.zh-CN.md) · [日本語](./README.ja.md) · [한국어](./README.ko.md) · [Español](./README.es.md) · [Français](./README.fr.md) · [Português](./README.pt-BR.md)

![boss-skill promo](https://raw.githubusercontent.com/echoVic/boss-skill/main/boss-skill-promo.png)

> This project is part of the AtomGit G-Star Incubation Program. GitHub is the canonical repository; AtomGit provides an automatically synchronized mirror for faster access in China. Please submit issues and pull requests on [GitHub](https://github.com/echoVic/boss-skill).
>
> GitHub: <https://github.com/echoVic/boss-skill> · AtomGit mirror: <https://atomgit.com/echoVic/boss-skill>

**Boss is an expert-squad workflow for coding agents.** It turns one coding agent into a structured engineering team: PM, Architect, UI Designer, Tech Lead, Scrum Master, Frontend, Backend, QA, and DevOps. Unlike prompt-only agent teams, Boss enforces hard quality contracts per role, produces replayable artifacts, and chains stages automatically — start anywhere, it runs the rest until you say stop.

Boss works with Claude Code, Codex, OpenClaw, Antigravity, and Hermes.

## Why Boss

Prompt-only orchestration can sound organized, but it usually cannot prove that the plan was followed, tests were run, or gates passed. Boss is built around evidence and hard contracts:
- **Hard quality contracts**: every role has a non-negotiable requirements table (e.g. PRD must have Given-When-Then scenarios; architecture must compare at least two options; QA must record verified or honestly-unverified evidence). Failed contracts block the next stage unless you explicitly override.
- **Artifact-driven**: every stage writes a real file under `.boss/<feature>/`. Progress is judged by artifacts on disk, not by what the agent claims.
- **Continuation chain**: start at any stage (`/boss:pm`, `/boss:dev`, ...) and Boss auto-runs every downstream stage until `ship` or until you stop it. No manual hand-offs.
- **Engineering principles**: the squad shares ten principles — prove it works, fix root causes, build the lever, model the domain, boundary discipline, sequence verifiable units, test behavior, minimize reader load, structured experience, autonomous rules. Each agent cites the principle it applies.
- **TDD by default**: development stages must write a failing test first, watch it go RED, then write the minimum code to make it GREEN.
- **Zero-network by default**: no telemetry, no phone-home, no remote LLM proxy. The only network surface is an opt-in loopback preview server bound to `127.0.0.1` for UI prototyping. See [PRIVACY.md](./PRIVACY.md).
- **Deterministic evals**: captured transcripts are scored without calling a real LLM.

## Expert Squad Commands

Boss is not a single monolithic command. Each slash command is an entry point; by default it auto-runs all downstream stages.

| Command           | Starts at        | Auto-runs through      | Use when                       |
| ----------------- | ---------------- | ---------------------- | ------------------------------ |
| `/boss`           | PM               | full chain → ship      | Go from idea to shippable work |
| `/boss:pm`        | PM               | Architect → ... → Ship | Start from requirements        |
| `/boss:architect` | Architect        | UI → ... → Ship        | You have a spec, need design   |
| `/boss:ui`        | UI Designer      | Review → ... → Ship    | You have architecture, need UI |
| `/boss:review`    | Tech Lead        | Tasks → ... → Ship     | Need technical review + plan   |
| `/boss:tasks`     | Scrum Master     | Dev → QA → Ship        | Need task breakdown            |
| `/boss:dev`       | Frontend/Backend | QA → Ship              | Start implementation           |
| `/boss:qa`        | QA               | Ship                   | Need test evidence             |
| `/boss:ship`      | DevOps           | (end)                  | Deploy only                    |

The full chain:

```
pm → architect → ui → review → tasks → dev → qa → ship
```

Stop the chain by saying "stop", "only do this step", or passing `--stop-after <stage>`.

## Quick Start

### 1. Install

Boss is a skill you install into your coding agent. Distribution is marketplace-only: no npm package, no global binary.

**Claude Code — plugin marketplace (recommended):**

```text
/plugin marketplace add echoVic/boss-skill
/plugin install boss@boss-skill
```

**Codex — plugin marketplace:**

```bash
codex plugin marketplace add echoVic/boss-skill
```

Then open the plugin browser (`/plugins`) and install **boss**.

**Any agent — via the `skills` CLI ([vercel-labs/skills](https://github.com/vercel-labs/skills), skills.sh):**

```bash
npx skills add echoVic/boss-skill
```

### 2. Try It On A Project You Already Have

The lowest-cost first run is a read-only review against existing code:

```
/boss:review
```

You get `tech-review.md` (and `plan.md`) under `.boss/<feature>/` with risks, findings, and severity. Nothing else in your repo is touched.

Want verifiable test evidence instead? `/boss:qa` runs the tests and writes `qa-report.md`.

### 3. Run The Full Pipeline

Inside your coding agent:

```text
/boss Build a local personal todo app --skip-ui
```

- `--skip-ui` skips the UI design stage (pure API/CLI projects).
- `--quick` skips routine clarification prompts.

### 4. Inspect Results

Artifacts live under `.boss/<feature>/`:

```text
.boss/todo-app/
├── prd.md
├── architecture.md
├── ui-spec.md
├── ui-design.json
├── tech-review.md
├── plan.md
├── tasks.md
├── qa-report.md
└── deploy-report.md
```

Each Markdown artifact starts with a `## 摘要` (summary) section so downstream agents can read the conclusion first.

## Workflow

```text
User request
  → requirement clarification (unless --quick)
  → PM: requirement discovery → prd.md
  → Architect: system design → architecture.md
  → UI Designer: UI/UX spec → ui-spec.md + ui-design.json  (skip with --skip-ui)
  → Tech Lead: technical review + implementation plan → tech-review.md + plan.md
  → Scrum Master: task breakdown → tasks.md
  → Frontend / Backend: TDD implementation
  → QA: test execution, bug reports, evidence → qa-report.md
  → DevOps: build, deploy, health checks → deploy-report.md
```

### Roles & Artifacts

| Role         | Responsibility                                         | Artifact                       |
| ------------ | ------------------------------------------------------ | ------------------------------ |
| PM           | Requirement discovery, PRD, hidden needs, edge cases   | `prd.md`                       |
| Architect    | System architecture, technical design, APIs            | `architecture.md`              |
| UI Designer  | UI/UX spec, renderable design JSON, HTML prototype     | `ui-spec.md`, `ui-design.json` |
| Tech Lead    | Technical review, risk assessment, implementation plan | `tech-review.md`, `plan.md`    |
| Scrum Master | Task breakdown and acceptance criteria                 | `tasks.md`                     |
| Frontend     | UI implementation, TDD, frontend tests                 | source code                    |
| Backend      | API, storage, TDD, backend tests                       | source code                    |
| QA           | Test execution, bug reports, verification evidence     | `qa-report.md`                 |
| DevOps       | Build, deployment, health checks                       | `deploy-report.md`             |

## Quality Contract

Boss has two layers of quality control:
- **Hard requirements per role**: each agent's prompt defines a non-negotiable requirements table. The agent self-checks before handing off; a failed contract blocks the next stage.
- **Quality gates**: real commands whose verdicts are recorded in the stage artifact.

| Gate                  | Stage                   | Checks                                                                          |
| --------------------- | ----------------------- | ------------------------------------------------------------------------------- |
| Gate 0 (code quality) | After dev, before QA    | TypeScript/lint pass, no high-severity dependency vulnerabilities               |
| Gate 1 (testing)      | After QA, before deploy | Unit + integration tests pass, coverage ≥ 70%, no P0/P1 bugs, E2E tests written |
| Gate 2 (performance)  | Before web deploy       | Lighthouse ≥ 80, API P99 < 500ms (web projects only)                            |

## When To Use Boss

| Good fit                                                                                  | Poor fit                                                              |
| ----------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| New features that need requirements, design, implementation, tests, and delivery evidence | One-line fixes or tiny local edits                                    |
| API, full-stack, UI, or medium-sized product work                                         | Pure code reading or explanation                                      |
| Work where `.boss/<feature>/` artifacts are valuable                                      | Tasks with a complete existing spec where you only need a quick patch |
| Teams that want repeatable quality gates and audit trails                                 | Work that does not need coordination or review evidence               |

Rule of thumb: if you do not need a traceable `.boss/` folder, you probably do not need the full `/boss` pipeline. Use a single role or let your coding agent edit directly.

## Security & Privacy

Boss is local-first and makes no outbound network requests by default. The only network surface is an opt-in, loopback-only (`127.0.0.1`) HTML prototype server used during the UI design stage.

Release provenance lives in `.agents/plugins/provenance.json`. It pins the repository HTTPS URL, immutable source commit SHA, publisher identity, and SHA-256 digests for plugin manifests. Verify it with:

```bash
npm run provenance:verify
```

See [PRIVACY.md](./PRIVACY.md) for the full data and network boundary.

## Pipeline Artifacts

```text
.boss/<feature>/
├── prd.md              # PM — product requirements
├── architecture.md     # Architect — system design
├── ui-spec.md          # UI Designer — UI/UX spec (skipped with --skip-ui)
├── ui-design.json      # UI Designer — renderable design JSON
├── tech-review.md      # Tech Lead — technical review
├── plan.md             # Tech Lead — implementation plan
├── tasks.md            # Scrum Master — task breakdown
├── qa-report.md        # QA — test evidence
└── deploy-report.md    # DevOps — deployment record
```

## Evals

Boss evals score captured fixtures without starting a real LLM:

```bash
npm run evals
npm run evals:release
```

The release eval includes release-evidence and pipeline-compliance checks — it verifies artifact recording, avoidance of deprecated runtime commands, and expert-squad orchestration behavior.

See [test/evals/README.md](./test/evals/README.md).

## Development

Requirements:
- Node.js >= 22.18

Setup:

```bash
git clone https://github.com/echoVic/boss-skill.git
cd boss-skill
npm install
npm run typecheck
npm test
```

Useful scripts:

```bash
npm run typecheck    # tsc --noEmit
npm test             # vitest (unit + skill behavior + evals)
npm run test:skills  # skill behavior tests only
npm run evals        # deterministic transcript evals
npm run lint         # biome ci
```

## Repository Layout

```text
boss-skill/
├── skill/                      # Skill bundle installed into coding agents (self-contained)
│   ├── SKILL.md                # Main orchestration entry (invariants + index)
│   ├── agents/                 # Role prompts (boss-pm, boss-architect, ...)
│   ├── commands/               # Slash commands (/boss, /boss:pm, ...)
│   ├── references/             # Shared methodology (principles, quality-gate, ...)
│   ├── skills/                 # Per-domain methodology skills (pm/, qa/, devops/, ...)
│   └── templates/              # Artifact templates (.md.template)
├── test/                       # Vitest, skill behavior, and eval tests
├── scripts/                    # release.js, provenance.js
├── docs/                       # Historical specs, plans, reports
├── examples/                   # Example projects
├── .claude-plugin/             # Claude Code plugin manifest + marketplace
├── .codex-plugin/              # Codex plugin manifest + marketplace
├── .agents/plugins/            # Repo-scoped plugin marketplace + provenance
├── tsconfig.json               # Typecheck-only config (no emit)
└── package.json                # Private dev workspace (never published)
```

## Release

Use the release script so version numbers stay synchronized across package metadata and skill/plugin manifests:

```bash
npm run release -- patch
npm run release -- minor
npm run release -- major
npm run release -- 4.1.0
npm run release -- 4.1.0 --dry-run
```

The release script checks for a clean worktree, runs the full verification chain (typecheck, lint, test), syncs versions across all manifests, verifies consistency, creates a commit and tag, and pushes. Release is the git tag: marketplaces read the repository — there is no npm publish step and no build step.

See [CONTRIBUTING.md](./CONTRIBUTING.md).

## Design

Boss is inspired by BMAD: Breakthrough Method of Agile AI-Driven Development, and by the "write less, higher quality code" philosophy. The expert-squad model keeps the harness lean — no runtime state machine, no event sourcing, no hooks — while preserving hard quality contracts and artifact-driven collaboration.

Read more in [DESIGN.md](./DESIGN.md), `skill/references/bmad-methodology.md`, and `skill/references/principles.md`.

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=echoVic/boss-skill&type=Date)](https://star-history.com/#echoVic/boss-skill&Date)

## License

MIT

© echoVic · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
testing-boss Pedro Nauck Скилл testing-boss задаёт правила создания тестов и эвалов для LLM-агентов: помогает выбрать уровень проверок, починить нестабильные тесты в CI и убрать лишние моки. CX Codex +1 274установок ub-mode unclebob Скилл ub-mode для Claude Code помогает разработчикам структурировать изменения в коде. Он направляет процесс разработки, следуя принципам «Сначала заставь работать, затем сделай правильно, затем следуй практикам». CX Codex +1 930установок methodology-advisor FlorianBruniaux Команда methodology-advisor для Claude Code и Codex изучает кодовую базу и задаёт три вопроса, чтобы подобрать подходящий стек методологий AI-разработки. Запускается вручную, когда нужно выбрать процесс до начала активной работы с агентом. CX Codex +1 ★ 6 529звёзд репо oma-orchestrator First Fluke Скилл oma-orchestrator для Claude Code автоматизирует запуск нескольких специализированных агентов одновременно, координирует их через MCP Memory и отслеживает прогресс. CX Codex +1 ★ 1 472звёзд репо quality-validation qodex-ai Скилл quality-validation запрещает ИИ-агенту заявлять о готовности задачи без свежих доказательств: запусков тестов, сборки или проверки диффа в Git. CX Codex +1 142установок sparc-methodology ruvnet Скилл sparc-methodology для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode: методология разработки SPARC с 17 режимами — от спецификации и архитектуры до TDD, ревью кода и деплоя. CX Codex +1 1 200установок

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

Весь набор →
claude-code Связывает Codex с локальным Claude Code CLI через MCP. Подходит для проверки статуса, входа и запуска запросов в безопасном режиме. CX Codex ★ 1 596звёзд репо chatgpt-agent Плагин chatgpt-agent для Claude Code и Codex подключает ChatGPT как ревьюера, советника, редактора или исполнителя. Работает через ZIP-пакет, MCP или GitHub. CX Codex ★ 1 596звёзд репо casefile Плагин casefile ведёт журнал уязвимостей для CTF, аудитов и bug bounty с автоматической проверкой PoC в Docker. CX Codex ★ 1 596звёзд репо bringyour-migration-auditor Плагин bringyour-migration-auditor проверяет проект после переноса с Claude на Codex: охват AGENTS.md и CLAUDE.md, хуки, MCP-конфиг, скиллы и ссылки на секреты. Пригодится до первой правки кода агентом. CX Codex ★ 1 596звёзд репо bindry Собирает Bindry Binder в навыки с фиксацией версии или живой загрузкой через MCP. Подключает инструкции по задаче. CX Codex ★ 1 596звёзд репо bgs-modding-superpowers Плагин bgs-modding-superpowers для сборки модпаков Bethesda: два MCP-сервера, аудит конфликтов в xEdit и управление MO2 прямо из сессии агента. CX Codex ★ 1 596звёзд репо babok_analyst Плагин babok_analyst ведёт бизнес-анализ по стандарту BABOK v3 через 9 этапов с подтверждением человека на каждом шаге. CX Codex ★ 1 596звёзд репо aw1-circuit-breaker Плагин aw1-circuit-breaker проверяет AST и аргументы вызовов инструментов до выполнения Python. Он пригодится, чтобы блокировать динамический запуск кода, shell-вызовы и сетевые подключения. CX Codex ★ 1 596звёзд репо

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

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