mgratzer/forge

Навыки агента для структурированного развития с подключенным отслеживанием проблем. Один рабочий процесс. Десять навыков. От идеи к объединенному коду.

Быстрый старт · Как это работает · Навыки · Lens · Архитектура · Вклад

Кузница - это место, где сырье соответствует намерениям. Вы приносите кодовую базу; эти навыки формируют рабочий процесс от выпуска до реализации для обзора.

Быстрый старт

Установите кузницу одним способом на машину:

Тогда в вашем проекте:

С помощью плагина команды размещаются в пространстве имен ([T0]), и /forge demo воспроизводит защищенный прогон в объективе, не касаясь GitHub.

Как это работает

Ship реализует изменение из Issue, файла плана или описания: исследует кодовую базу, работает в вертикальных фазах с тестами, запускает приложение на изменённом пути, когда проект говорит как, и открывает PR. Рецензент свежего контекста, а не сессия, написавшая код, просматривает дифф, прежде чем увидеть его.

Guard приводит открытый PR в готовность к рецензированию без чьего-либо наблюдения: пропуск упрощения, пропуск безопасности, когда дифф требует одного, CI, рецензента и обратной связи в ограниченных раундах. Она никогда не сливается.

Agent skills for structured development with pluggable issue tracking. One workflow. Ten skills. From idea to merged code.

Quick start · How it works · Skills · Lens · Architecture · Contributing

---

A forge is where raw material meets intention. You bring the codebase; these skills shape the workflow from issue to implementation to review.

---

Quick Start

Install forge one way per machine:

# Claude Code: the skills plus the lens above
/plugin install forge --marketplace mgratzer/forge

# any other agent that reads Agent Skills
npx skills add mgratzer/forge

Then, in your project:

/forge-setup-project       # once per repo: AGENTS.md and the docs agents work from
/forge-ship 42             # implement Issue #42, review it in fresh context, open the PR
/forge-ship --guard 42     # and keep going: CI, review feedback, then a risk verdict

With the plugin, the commands are namespaced (/forge:forge-ship), and /forge demo replays a guarded run in the lens without touching GitHub.

How It Works

forge-setup-project → [forge-shape →] forge-create-issue → forge-implement → forge-reflect → forge-address-pr-feedback → forge-guard → forge-land
                                                                        ╰──── forge-ship ────╯╰────────── forge-ship --guard ───────────╯

Ship implements a change from an Issue, a plan file or a description: it researches the codebase, works in vertical phases with tests, runs the app on the changed path when the project says how, and opens a PR. A fresh-context reviewer, not the session that wrote the code, reviews the diff before you see it.

Guard drives the open PR to review-ready without anyone watching: a simplification pass, a security pass when the diff calls for one, CI, the peer reviewer, and feedback in bounded rounds. It never merges.

Land judges a green PR’s risk on its head commit and writes the verdict into the PR. Low risk means you can merge without reading the diff; anything else comes with a list of where to look. It merges by itself only when the project opts in.