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

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

Плагин zagrosi-forge для Claude Code делит большой бриф на спецификации, строит план по секциям и пишет код по TDD с записями о проверках. Разбивает задачи, которые не помещаются в один заход.

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

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

Что делает zagrosi-forge

Работа идёт в три фазы: zagrosi-project режет бриф на project-manifest.md и дочерние spec.md, zagrosi-plan собирает план с секциями и тестами, zagrosi-implement пишет код и оставляет машиночитаемые записи по каждой секции. Режим cleanup упрощает подсистему, сохраняя поведение и регрессионные доказательства. Глубина задаётся словом lean (по умолчанию), standard или deep.

Скрипт scripts/zagrosi_skills.py даёт команды status, next-section, commands и проверку доступа к провайдерам. Запускать его нужно из каталога целевого проекта, пути к плагину и плану — абсолютные. Независимые ревью от Codex, Claude или Gemini идут в свежем субагенте на штатных логинах CLI, флаг --check-auth показывает статус входа.

Нужен Python 3.11+. На Windows вместо python3 пишите python или py -3, после установки перезапустите сессию. Режим detached execution с привилегированной передачей рассчитан на Darwin/arm64 с APFS — на другой системе он не пойдёт.

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

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

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

  • Добавь авторизацию через /zagrosi-forge:zagrosi-forge и доведи проверку до конца.
  • Упрости этот модуль командой /zagrosi-forge:zagrosi-cleanup, поведение не меняй.
  • Спланируй задачу в глубине standard, код пока не трогай.

Как установить zagrosi-forge

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

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

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

Вопросы о zagrosi-forge

Как установить zagrosi-forge в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем поставьте плагин: /plugin install zagrosi-forge@awesome-codex-plugins. После установки перезапустите сессию.

Что делает zagrosi-forge?

Разбирает бриф на спецификации, строит план и пишет код по TDD, оставляя по каждой секции записи о тестах и проверках.

Что нужно для работы плагина?

Python 3.11+ и поддержка плагинов в хосте. На Windows вместо python3 используется python или py -3.

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

zagrosi-forge · MIT
# Zagrosi Forge

<p>
<picture>
  <source media="(max-width: 600px)" srcset="assets/readme-hero-mobile.svg" />
  <img src="assets/readme-hero.svg" alt="Forge turns briefs into reviewed plans and tested code, in Codex and Claude Code." width="100%" />
</picture>
</p>

Forge plans, builds, fixes and cleans code in Codex and Claude Code.
Lean by default: focused context, targeted checks, one integration result.

[Install](#install) · [Use](#use) · [Multiple models](#multiple-models) · [Teams](#teams) · [Workflows](#workflows) · [Engineering](#engineering) · [Releases](docs/releases.md) · [Contribute](#contribute)

## Install

Requires Python 3.11+ and plugins. On Windows, replace `python3`
with `python` or `py -3`. Restart after installing or updating.

### Claude Code

```bash
claude plugin marketplace add zagrosi-code/zagrosi-forge
claude plugin install zagrosi-forge@zagrosi
```

Update with `claude plugin marketplace update zagrosi`, then
`claude plugin update zagrosi-forge@zagrosi`.

### Codex

```bash
codex plugin marketplace add zagrosi-code/zagrosi-forge
codex plugin add zagrosi-forge@zagrosi
```

<details>
<summary>Install or develop from a local checkout</summary>

```bash
git clone https://github.com/zagrosi-code/zagrosi-forge.git
cd zagrosi-forge
```

One Claude Code session:

```bash
claude --plugin-dir "/absolute/path/to/zagrosi-forge"
```

From the checkout in Codex:

```bash
python3 scripts/zagrosi_skills.py install --pretty
# Preview without writing:
python3 scripts/zagrosi_skills.py install --dry-run --pretty
# Refresh from the updated checkout:
git pull --ff-only
python3 scripts/zagrosi_skills.py update-check --pretty
python3 scripts/zagrosi_skills.py self-update --pretty
```

</details>

## Use

Describe your task; optionally request `standard` or `deep`.
Try the [first task](examples/first-task/README.md).

**Claude Code**

```text
/zagrosi-forge:zagrosi-forge Add this feature and finish verification.
/zagrosi-forge:zagrosi-cleanup Simplify this subsystem while preserving behavior.
```

**Codex**

```text
Use $zagrosi-forge:zagrosi-forge to add this feature and finish verification.
Use $zagrosi-forge:zagrosi-cleanup to simplify this subsystem while preserving behavior.
```

Shared skills, runtime and standards; phases: `zagrosi-project`,
`zagrosi-plan`, `zagrosi-implement`. Authorized work continues through delivery;
planning-only requests stop at planning.

Optional [verification allowances](skills/zagrosi-implement/references/verification.md)
(unlimited by default).

## Multiple models

Request independent Codex, Claude or Gemini reviews; the host reviews in a fresh subagent:

```text
Implement this feature with independent Codex and Claude reviews. Keep one writer; report missing access.
```

Forge reuses native CLI logins and model defaults or requested IDs.
Missing access and unreported identity stay visible; no silent fallback.
Add `--check-auth` for login status. See [provider setup](skills/zagrosi-forge/references/providers.md).
Resolve `{plugin_root}` from the loaded Forge skill: the absolute directory
containing `scripts/zagrosi_skills.py`.

```bash
python3 "{plugin_root}/scripts/zagrosi_skills.py" provider-status --check-cli --pretty
```

## Teams

Share reviewed plans through Git; reserve work across clones, worktrees and hosts.
Enable collaboration explicitly; commit `.forge/team.json` for teammates.
Execution records stay private. No extra service.

All depths and cleanup share reservations and advisory dependency warnings at
work boundaries. Stale tasks retain ownership; offline status grants no clearance.
Notes remain in Git history. See [setup, migration and limits](docs/collaboration.md).

## Workflows

<p>
<picture>
  <source media="(max-width: 600px)" srcset="assets/readme-workflow-mobile.svg" />
  <img src="assets/readme-workflow.svg" alt="Project splits a brief into specs; Plan defines a compact contract; Implement tests, builds, reviews, and records each section." width="100%" />
</picture>
</p>

| Workflow | Output |
|---|---|
| Project | `project-manifest.md` and child `spec.md` files |
| Single-section plan | `sections/index.md` and one canonical section with tests, evidence, decisions, risks, and review |
| Multi-section plan | Shared plan and ordered sections |
| Implement | Code, tests, and machine-readable section records |
| Cleanup | Simpler responsibilities and preserved behavior, with regression evidence |

| Depth | Use |
|---|---|
| `lean` — default | Minimum sufficient artifacts and focused checks |
| `standard` | Wider research, traceability, or coordination |
| `deep` | High-risk or architecture-heavy work |

Depth controls investigation and review; every mode retains requirements,
ownership, acceptance and verification.

Complete contracts before coding. See
[compact-plan format](skills/zagrosi-plan/references/plan-format.md),
[depth standards](skills/zagrosi-plan/references/depth-standards.md), and
[example briefs](examples/gallery/README.md).

### Resume and compatibility

Resume from the target project in either host. Checkpoints retain progress;
conflicting ownership serializes work. Changed code/contracts require fresh
verification; legacy evidence cannot prove completion.

Run helpers **from the target project directory**, with absolute plugin and plan
paths. Until implementation setup saves the target, `status` uses the working
directory; it has no `--target-dir` option.

```bash
cd "/absolute/path/to/target project"
python3 "{plugin_root}/scripts/zagrosi_skills.py" status --path "/absolute/path/to/planning/01-auth" --pretty
python3 "{plugin_root}/scripts/zagrosi_skills.py" next-section --planning-dir "/absolute/path/to/planning/01-auth" --target-dir "/absolute/path/to/target project" --pretty
python3 "{plugin_root}/scripts/zagrosi_skills.py" commands --phase implement --verbose --pretty
```

`fast` aliases `lean`; existing `zagrosi-*`, `deep-*`, `DEEP_META`, and migrated
`claude-*` artifacts remain accepted. `codex_review` aliases `agent_review`.

[Detached execution](skills/zagrosi-implement/references/detached-frozen.md) retains
its pinned evidence protocol and physical contracts; privileged handoff requires
Darwin/arm64 and APFS.

## Engineering

Our [engineering standard](skills/zagrosi-implement/references/engineering.md)
follows [Ponytail](https://github.com/DietrichGebert/ponytail): trace callers, reuse
code, prefer direct flow. Simplify duplication and responsibilities with
regression coverage. [Preservation checks](skills/zagrosi-implement/references/compatibility.md)
run before edits, then replay unchanged checks and commands; required pairs gate
completion. Capture cannot prove coverage or authorship. Run feature checks and
integration. Cleanup can cover repositories; PR review covers the diff and callers.

`context-brief` and `implementation-packet` keep complete sections, mapped source
requirements and linked contracts. Budget: 2,000 words (`--max-words`);
broken links fail and oversized sections return an adjusted retry. Failures retain
blockers, recovery commands and complete reports (`--full-output`).

Runtime loading verifies SHA-256 source bindings; writes are locked and atomic.

[Helper benchmarks](examples/evals/performance.json) measure fixed fixtures.
[Suite comparisons](examples/evals/coding/README.md#manifest-driven-suites) use frozen
tasks, isolated checks and blind review.
[Historical results](examples/evals/coding/behavior-contract-results-2026-10-02.md)
retain failures; adapter support proves neither speed nor quality.

## Contribute

Workflows: `skills/`, `agents/`; runtime: `scripts/forge/`; checks: `tests/`,
`examples/`; host metadata: `.codex-plugin/`, `.claude-plugin/`.

Runtime/test edits: run `python3 tools/update_runtime_manifest.py`.
Package membership changes: stage intended files, then run
`python3 tools/update_package_manifest.py`.
CI covers Linux/macOS/Windows and native packaging. Native validators require their CLIs.

```bash
python3 tools/update_runtime_manifest.py --check
python3 tools/update_package_manifest.py --check
npm ci --prefix tools
uv run --with pytest python -m pytest
python3 scripts/zagrosi_skills.py doctor --plugin-root . --strict --pretty
python3 scripts/zagrosi_skills.py release-check --plugin-root . --pretty
plugin-scanner verify .
claude plugin validate . --strict
```

[MIT License](LICENSE) · [Attribution](NOTICE.md)

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

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

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
claude-forge Sangrok Jung Плагин claude-forge для Claude Code собирает окружение из агентов, слэш-команд и хуков для TDD, ревью кода и безопасности, разбора ошибок сборки и аудита Lighthouse. ★ 880звёзд репо ub-mode unclebob Скилл ub-mode для Claude Code помогает разработчикам структурировать изменения в коде. Он направляет процесс разработки, следуя принципам «Сначала заставь работать, затем сделай правильно, затем следуй практикам». CX Codex +1 930установок writing-plans Jesse Vincent Скилл writing-plans для Claude Code и Codex создаёт детальный план реализации многошаговой задачи перед первой правкой кода. Запускается, когда у агента есть спецификация фичи или требования. CX Codex +1 282 859установок Pair Programming ruvnet Скилл Pair Programming организует парное программирование с ИИ: роли driver и navigator, проверка кода, тесты и режимы для TDD, отладки и обучения. CX Codex +1 1 200установок methodology-advisor FlorianBruniaux Команда methodology-advisor для Claude Code и Codex изучает кодовую базу и задаёт три вопроса, чтобы подобрать подходящий стек методологий AI-разработки. Запускается вручную, когда нужно выбрать процесс до начала активной работы с агентом. CX Codex +1 ★ 6 529звёзд репо agent-teams alinaqi Скилл agent-teams организует разработку через команду ИИ-агентов и обязательный TDD-конвейер. Подходит для проектов, где нужны проверки кода, безопасности и pull request. CX Codex +1 300установок

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

Весь набор →
amq-cli Плагин amq-cli связывает кодинг-агентов через локальную файловую очередь: они могут отправлять запросы, читать ответы и продолжать переписку в одной ветке. CX Codex ★ 1 596звёзд репо abuzzhive Подключает агента к публичным Q&A-доскам AbuzzHive, где агенты публикуют ошибки и предлагают друг другу решения. Хук автоматически предлагает find_by_error после каждой упавшей shell-команды. CX Codex ★ 1 596звёзд репо call-me Плагин call-me связывает агента с телефоном на iOS или Android: агент звонит голосом или отправляет пуш, а ответ возвращает текстом прямо в сессию. CX Codex ★ 1 596звёзд репо codex-zcode-bridge Плагин codex-zcode-bridge для Claude Code и Codex передаёт задачу из Codex локальному ZCode и возвращает ход работы для проверки изменений и сверки результата с критериями приёмки. CX Codex ★ 1 596звёзд репо yylo Плагин yylo для Claude Code и Codex изолирует задачи агентов в отдельных git worktree и распределяет работу между субагентами Codex и Pi, фиксируя изменения квитанциями. CX Codex ★ 1 596звёзд репо wtfm wtfm — плагин для Claude Code и Codex, который пишет справочные статьи по коду проекта и добавляет скриншоты его интерфейса. Запросите руководство обычным языком, например о приглашении коллеги. CX Codex ★ 1 596звёзд репо writers-loop Плагин writers-loop ведёт написание текста по шагам: рамка задачи, план, черновик, критика, правка по подтверждённым пунктам. Предпочтения запоминает только с вашего согласия. CX Codex ★ 1 596звёзд репо workflow-kit Плагин workflow-kit ведёт продукт от формулировки видения до готового пакета артефактов. Каждую задачу выполняет рабочий агент, а валидирует обязательный независимый ревьюер. CX Codex ★ 1 596звёзд репо

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

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