ForgeCraft

Вы наняли ИИ-инженера. Он гениален. Но сегодня он дважды установил одни и те же 14 расширений VS Code, поднял 6 Docker-контейнеров, которые никогда не почистит, и ваш диск за одну сессию перешёл от 12 ГБ свободного места к 0 КБ.

Заполненный диск не отказывает изящно. Он убивает VS Code, терминал, Docker и базу данных одновременно.

ForgeCraft — это контракт качества, в рамках которого работает ваш ИИ-ассистент по программированию, — чтобы он строил быстро и не сжигал дом дотла.

npx forgecraft-mcp setup .

Поддерживает: Claude (CLAUDE.md) · Cursor (.cursor/rules/) · GitHub Copilot (.github/copilot-instructions.md) · Windsurf (.windsurfrules) · Cline (.clinerules) · Aider (CONVENTIONS.md)

Фреймворк качества для разработки ПО с помощью ИИ

Каждая сессия, каждый проект, каждый ИИ-ассистент — оцениваются по одной и той же модели Generative Specification из 7 свойств. Не «по ощущениям». Не оценка линтера. Оценка из 14 баллов, которая точно показывает, где разрыв и почему.

$ npx forgecraft-mcp verify .

| Property        | Score | Evidence                                        |
|-----------------|-------|-------------------------------------------------|
| Self-Describing | ✅ 2/2 | CLAUDE.md — 352 non-empty lines                |
| Bounded         | ✅ 2/2 | No direct DB calls in route files              |
| Verifiable      | ✅ 2/2 | 64 test files — 87% coverage                   |
| Defended        | ✅ 2/2 | Pre-commit hook + lint config present           |
| Auditable       | ✅ 2/2 | 11 ADRs in docs/adrs/ + Status.md              |
| Composable      | ✅ 2/2 | Service layer + repository layer detected       |
| Executable      | ✅ 2/2 | Tests passed + CI pipeline configured           |

Total: 14/14 ✅ PASS · Threshold 11/14

Related MCP server: MCP Policy Gatekeeper

Гигиена среды разработки — обеспечивается соглашениями

ForgeCraft внедряет enforceable-правила в инструкции ИИ каждого проекта, превращая загрязнение среды из инцидента в нарушение соглашений.

Расширения VS Code Перед установкой: code --list-extensions | grep -i <name>. Устанавливайте только в том случае, если версия в требуемом основном диапазоне ещё не присутствует. Одно и то же расширение не должно загружаться дважды за один день.

Docker-контейнеры Проверяйте перед созданием: docker ps -a --filter name=<service>. Если контейнер существует — запустите его, не создавайте новый. Предпочитайте docker compose up (переиспользование) вместо голого docker run (всегда создаёт новый). Логи ограничены 500 МБ. docker system prune -f документируется как периодический шаг обслуживания, а не как аварийная мера.

Исключение: Несколько контейнеров одного сервиса допускаются, если они существенно различаются набором плагинов или основной версией — например, контейнер postgres-pgvector рядом со стандартным контейнером postgres. Именуйте контейнеры с учётом варианта (например, db-pgvector, db-timescale); в противном случае применяется правило дедупликации.

Виртуальные окружения Python Один .venv на корень проекта. Переиспользуйте, если версия Python major.minor совпадает. Никогда не создавайте venv в подкаталоге, если только это не отдельный устанавливаемый пакет. Неиспользуемые зависимости выявляются с помощью pip list --not-required.

Синтетические данные и данные временных рядов Прежде чем записать более 100 МБ сгенерированных данных, ИИ спрашивает: сохранить исходные, агрегировать статистически или удалить после запуска? Синтетические наборы данных старше 7 дней без ссылок в коде: предложить удалить.

Общее Если рабочее пространство превышает 2 ГБ вне известных артефактов сборки (node_modules/, .venv/, dist/), вывести предупреждение и остановиться. Никогда не увеличивайте рабочее пространство молча.

Настройка проекта в одном предложении

Read the spec in docs/specs/, set up this project with ForgeCraft,
scaffold it with the right tags, recommend the tech stack, start building.

Это весь онбординг-промпт. ForgeCraft читает спецификацию, ИИ присваивает теги, а ForgeCraft записывает файл инструкций, создаёт Status.md, docs/adrs/, docs/PRD.md, docs/TechSpec.md, хуки и навыки. У ИИ есть полный контекст. Вы начинаете строить.

ForgeCraft сканирует ваш проект, автоматически определяет ваш стек и генерирует индивидуальные файлы инструкций из 116 курируемых блоков — SOLID, гексагональная архитектура, пирамида тестирования, CI/CD и 24 набора доменных правил — за секунды.

Шлюзы качества

Шлюзы качества — это структурированные проверки «прошёл/не прошёл», которые ваш ИИ-ассистент выполняет в определённые моменты — перед коммитом, перед релизом, после развёртывания. Это не правила линтера. У каждого шлюза есть условие, требование к доказательствам и флаг, обязательна ли проверка человеком.

Шлюзы организованы по фазам релиза, чтобы вы не запускали хаос-тесты предрелизной стадии в первый день greenfield-проекта:

Шлюзы с тегом requires_human_review: true не могут быть автоматически пройдены — некоторые проверки требуют человека.

Полная библиотека шлюзов, руководство по внесению вклада и схема находятся в репозитории шлюзов качества →

ADR — автоматическая нумерация

Каждое неочевидное архитектурное решение фиксируется. ForgeCraft автоматически нумерует docs/adrs/NNNN-slug.md в формате MADR — контекст, решение, альтернативы, последствия. Ваш ИИ-ассистент рассуждает с учётом прошлых решений. Ваша команда перестаёт пересматривать их заново.

npx forgecraft-mcp generate_adr . --title "Use event sourcing for order history" \
  --status Accepted \
  --context "Order mutations need full audit trail for compliance" \
  --decision "Append-only event log, project current state on read"
# → docs/adrs/0004-use-event-sourcing-for-order-history.md

Настройка ИИ-ассистента против ForgeCraft

claude init, правила рабочего пространства Cursor или файл инструкций Copilot помогут вам начать. ForgeCraft доводит вас до производственных стандартов — для каждого ИИ-ассистента, каждой сессии, каждого инженера в команде.

Плейбук рабочих процессов

После настройки у вашего ИИ есть контекст. Эти промпты направляют работу. Копируйте, вставляйте, запускайте.

→ Полный плейбук рабочих процессов · Онлайн-версия

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

# First-time setup — auto-detects your stack
npx forgecraft-mcp setup .

flowchart TD
    A["<b>setup .</b><br/>npx forgecraft-mcp setup ."] --> B["Phase 1 — Analyze<br/>Reads spec · infers tags"]
    B --> C{AI assistant\nin the loop?}
    C -->|"Yes (MCP)"| D["Phase 2 — Calibrate<br/>LLM corrects tags from spec<br/>Writes forgecraft.yaml · CLAUDE.md<br/>PRD.md · hooks · ADR-000"]
    C -->|"No (CLI only)"| E["⚠️ CLI-only mode<br/>Directory heuristics only<br/>→ configure an AI assistant"]
    D --> F["<b>check_cascade</b><br/>5-step readiness gate<br/>1 · Functional spec<br/>2 · Architecture + C4<br/>3 · Constitution<br/>4 · ADRs<br/>5 · Use cases"]
    F --> G{All 5 passing?}
    G -->|"Stubs / missing"| H["Fill artifacts<br/>docs/PRD.md · docs/adrs/<br/>docs/use-cases.md"]
    H --> F
    G -->|"✅ All pass"| I["<b>generate_session_prompt</b><br/>Bound context for next task"]
    I --> J["Implement with TDD<br/>RED → GREEN → REFACTOR<br/>+ Documentation Cascade"]
    J --> K["<b>audit_project</b><br/>Score 0 – 100"]
    K --> L{Score ≥ 90?}
    L -->|"Violations found"| M["WORKFLOWS.md remediation<br/>file_length · layer_violation<br/>hardcoded_url · missing_prd"]
    M --> J
    L -->|"✅ Score ≥ 90"| N["<b>close_cycle</b><br/>Re-check cascade · assess gates<br/>promote to registry · bump version"]
    N --> O{Roadmap\ncomplete?}
    O -->|"More features"| I
    O -->|"All done"| P["<b>start_hardening</b><br/>Mutation tests · OWASP · load test"]
    P --> Q["🚢 Ship"]

    style A fill:#1a2e1a,color:#90ee90,stroke:#3a6e3a
    style Q fill:#1a2a3e,color:#87ceeb,stroke:#3a5a8e
    style E fill:#2e1a1a,color:#ffaa88,stroke:#6e3a3a
    style M fill:#2e2a00,color:#ffd700,stroke:#6e6000

ForgeCraft — это CLI-инструмент времени настройки. Запустите его один раз для настройки проекта, затем удалите — у него нет следа в рантайме.

Опционально добавьте MCP-сторожевой модуль, чтобы ваш ИИ-ассистент мог диагностировать и рекомендовать команды:

claude mcp add forgecraft -- npx -y forgecraft-mcp

Сторожевой модуль — это один инструмент (~200 токенов). Он читает три артефакта — forgecraft.yaml, CLAUDE.md, .claude/hooks — выводит правильную следующую CLI-команду и возвращает её. И ничего больше. Это основной принцип методологии, выраженный в дизайне инструмента: читатель без состояния, конечный набор артефактов, выводимое действие. Удалите его после первоначальной настройки, чтобы вернуть токен-бюджет.

Что вы получаете

После npx forgecraft-mcp setup ваш проект содержит:

your-project/
├── forgecraft.yaml        ← Your config (tags, tier, customizations)
├── CLAUDE.md              ← Engineering standards (Claude)
├── .cursor/rules/         ← Engineering standards (Cursor)
├── .github/copilot-instructions.md  ← Engineering standards (Copilot)
├── Status.md              ← Session continuity tracker
├── .claude/hooks/         ← Pre-commit quality gates
├── docs/
│   ├── PRD.md             ← Requirements skeleton
│   └── TechSpec.md        ← Architecture + NFR sections
└── src/shared/            ← Config, errors, logger starters

Файлы инструкций

Это основная ценность. Собраны из курируемых блоков, охватывающих:

• Принципы SOLID — конкретные правила, а не общие слова

• Гексагональная архитектура — порты, адаптеры, DTO, границы слоёв

• Пирамида тестирования — цели для unit/integration/E2E, таксономия тест-дублёров

• Чистый код — CQS, защитные условия, иммутабельность, чистые функции

• CI/CD и развёртывание — этапы пайплайна, окружения, предпросмотр деплоев

• Доменные паттерны — DDD, CQRS, event sourcing (когда вашему проекту это нужно)

• 12-Factor эксплуатация — конфигурация, отсутствие состояния, утилизируемость, логирование

Каждый блок основан на устоявшейся инженерной литературе (Martin, Evans, Wiggins) и адаптирован для разработки с помощью ИИ.

24 тега — определяются ИИ, настраиваются пользователем

Теги сообщают ForgeCraft, что представляет собой ваш проект. При первой настройке ИИ анализирует вашу спецификацию и кодовую базу и присваивает их. Вы можете просмотреть и переопределить их в forgecraft.yaml. Блоки объединяются без конфликтов — добавляйте или удаляйте теги по мере развития проекта.

Полный список тегов и руководство по внесению вклада находятся в репозитории quality gates →

Уровни глубины контента

Не каждому проекту нужен DDD с первого дня.

Задаётся в forgecraft.yaml:

projectName: my-api
tags: [UNIVERSAL, API]
tier: recommended

Команды CLI

npx forgecraft-mcp <command> [dir] [flags]

Общие флаги

--tags UNIVERSAL API     Project classification tags (or read from forgecraft.yaml)
--tier core|recommended  Content depth (default: recommended)
--targets claude cursor  AI assistant targets (default: claude)
--dry-run                Preview without writing files
--compact                Strip explanatory bullet tails and deduplicate lines (~20-40% smaller output)
--apply                  Apply changes (for refresh)
--language typescript    typescript | python (default: typescript)
--scope focused          comprehensive | focused (for review)

MCP Sentinel

Опционально добавьте MCP-страж ForgeCraft, чтобы ваш ИИ-ассистент мог диагностировать ваш проект и предлагать правильную команду CLI:

Страж — это один минимальный инструмент (~200 токенов на запрос, против ~1,500 для полного набора инструментов). Он проверяет, существуют ли forgecraft.yaml, ваш файл инструкций для ИИ и ваши хуки, а затем возвращает целевую команду CLI для текущего состояния проекта.

Дизайн намеренный. Полная поверхность команд ForgeCraft — 21 действие — живёт в CLI, а не в MCP-сервере. MCP-сервер предоставляет ровно один инструмент, который читает три артефакта и возвращает одну рекомендацию. Это принцип Generative Specification в собственной архитектуре инструмента: статeless-читатель, ограниченный набор артефактов, производное действие. Инструмент практикует то, что записывает в ваши файлы инструкций.

Побочный эффект: каждый объявленный MCP-инструмент читается моделью на каждом ходу, независимо от того, вызывается он или нет. Один инструмент стоит 200 токенов. Двадцать один инструмент стоит 1,500. Страж сохраняет рекомендуемый бюджет MCP методологии (≤3 активных сервера) по дизайну.

Рекомендуемый рабочий процесс:

1. Добавьте стража в ваш ИИ-ассистент (см. примеры конфигурации ниже)

2. Позвольте вашему ИИ-ассистенту выполнить npx forgecraft-mcp setup .

3. Удалите стража из вашей активной конфигурации MCP

4. Добавьте его снова, когда нужно обновить или провести аудит

Добавьте в .claude/settings.json:

{
  "mcpServers": {
    "forgecraft": {
      "command": "npx",
      "args": ["-y", "forgecraft-mcp"]
    }
  }
}

Добавьте в .vscode/mcp.json в корне вашего проекта (создайте его, если его нет):

{
  "servers": {
    "forgecraft": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "forgecraft-mcp"]
    }
  }
}

Затем откройте панель Copilot Chat, переключитесь в Agent mode, и страж forgecraft появится в списке инструментов.

Добавьте в .cursor/mcp.json:

{
  "mcpServers": {
    "forgecraft": {
      "command": "npx",
      "args": ["-y", "forgecraft-mcp"]
    }
  }
}

Нет MCP-клиента? Это нормально — он вам не нужен. Запустите npx forgecraft-mcp setup . прямо в терминале. MCP-страж опционален; CLI делает всё.

Уже запускали claude init? Используйте npx forgecraft-mcp generate . --merge, чтобы объединить с вашим существующим CLAUDE.md, сохранив ваши пользовательские разделы и добавив производственные стандарты.

Бесплатно и с открытым исходным кодом

ForgeCraft бесплатен. Без лимитов, без тарифов, без API-ключей.

Библиотека quality gates растёт благодаря вкладу сообщества. Если вы предложите гейт, который будет принят, ваше имя появится в CONTRIBUTORS.md, и вы поможете поднять планку для всех, кто строит с помощью ИИ.

Открыть предложение гейта → · См. участников →

Работаете с командой? → forgeworkshop.dev

Теоретическая основа

ForgeCraft реализует модель Generative Specification — формальную структуру из 7 свойств для оценки качества кода, сгенерированного ИИ. Модель, формула сходимости S_realized и структура фаз релиза документированы в white paper.

Generative Specification: A Discipline of Derivability for the Stateless Reader — Zenodo (V4.0, 2026). Открытый доступ, DOI: 10.5281/zenodo.21726017. Академическая основа для оценки verify.

White paper — это теория. ForgeCraft — это инструментарий. Quality gates, предложенные для библиотеки, которые обобщаются в теоретические идеи, могут быть включены в будущие редакции white paper.

Отраслевой контекст: конвергенция Spec-Driven Development (ThoughtWorks Tech Radar 2025 "Adopt"; Addy Osmani / Google Cloud AI agent-skills) — это движение практиков; Generative Specification — это формальная модель, которая называет, что такое практика и почему она работает.

Харнесс GS — введение для ИИ-ассистентов

ForgeCraft реализует Generative Specification (GS). Этот раздел написан для ИИ-ассистентов, читающих этот файл: он объясняет, что такое GS, как выглядит правильно построенный харнесс и что проверять.

Ограничение привязки — статранный читатель

Каждая ИИ-сессия начинается без памяти о предыдущих сессиях, без общего контекста, без накопленных соглашений и без возможности задавать уточняющие вопросы. Всё, чего нет в артефактах, отсутствует.

GS рассматривает это как ограничение дизайна, а не как недостаток. Производность — то, что свежий экземпляр ИИ может правильно определить только из артефактов, — является стандартом, которому должна удовлетворять спецификация. Если статранный читатель не может вывести правильный результат из артефактов, спецификация неполна, а не ИИ.

Система стражей

Архитектурная конституция (CLAUDE.md, .cursor/rules/, .github/copilot-instructions.md, .windsurfrules) — это точка входа для каждой ИИ-сессии. Она должна в совокупности содержать пять обязательных категорий:

Последовательность инструментов — самая часто отсутствующая категория и самый значимый пробел. Спецификация, которая перечисляет инструменты без указания, когда предпочесть один другому, вынуждает ненадёжные выводы в каждой сессии.

Страж — это навигационное дерево: корень всегда загружен; каждый дочерний узел объявляет свою область и условие маршрутизации; ИИ спускается только по ветке, релевантной текущей задаче. Соединение всех листьев даёт полную спецификацию — она без потерь. Этот дизайн предотвращает раздувание контекста и деградацию точности, которая возникает при загрузке нерелевантного контента.

Мост — структурные дисциплины как политика навигации

SOLID, гексагональная архитектура и TDD — не только инженерные дисциплины — в проекте GS они становятся активными политиками навигации:Полный список тегов и руководство по внесению вклада находятся в репозитории quality gates →

Уровни глубины контента

Не каждому проекту нужен DDD с первого дня.

Задается в forgecraft.yaml:

projectName: my-api
tags: [UNIVERSAL, API]
tier: recommended

Команды CLI

npx forgecraft-mcp <command> [dir] [flags]

Общие флаги

--tags UNIVERSAL API     Project classification tags (or read from forgecraft.yaml)
--tier core|recommended  Content depth (default: recommended)
--targets claude cursor  AI assistant targets (default: claude)
--dry-run                Preview without writing files
--compact                Strip explanatory bullet tails and deduplicate lines (~20-40% smaller output)
--apply                  Apply changes (for refresh)
--language typescript    typescript | python (default: typescript)
--scope focused          comprehensive | focused (for review)

MCP Sentinel

Опционально добавьте MCP sentinel ForgeCraft, чтобы ваш ИИ-ассистент мог диагностировать ваш проект и предлагать правильную команду CLI:

Sentinel — это один минимальный инструмент (~200 токенов на запрос, против ~1,500 для полного набора инструментов). Он проверяет, существуют ли forgecraft.yaml, ваш файл инструкций для ИИ и ваши хуки, а затем возвращает целевую команду CLI для текущего состояния проекта.

Дизайн намеренный. Полная поверхность команд ForgeCraft — 21 действие — находится в CLI, а не в MCP-сервере. MCP-сервер предоставляет ровно один инструмент, который читает три артефакта и возвращает одну рекомендацию. Это принцип Generative Specification в собственной архитектуре инструмента: статeless reader, ограниченный набор артефактов, производное действие. Инструмент практикует то, что записывает в ваши файлы инструкций.

Побочный эффект: каждый объявленный MCP-инструмент читается моделью на каждом ходу, независимо от того, вызывается ли он. Один инструмент стоит 200 токенов. Двадцать один инструмент стоит 1,500. Sentinel сохраняет рекомендуемый бюджет MCP методологии (≤3 активных сервера) по дизайну.

Рекомендуемый рабочий процесс:

1. Добавьте sentinel в ваш ИИ-ассистент (см. примеры конфигурации ниже)

2. Позвольте вашему ИИ-ассистенту выполнить npx forgecraft-mcp setup .

3. Удалите sentinel из вашей активной конфигурации MCP

4. Добавьте его снова, когда нужно обновить или провести аудит

Добавьте в .claude/settings.json:

{
  "mcpServers": {
    "forgecraft": {
      "command": "npx",
      "args": ["-y", "forgecraft-mcp"]
    }
  }
}

Добавьте в .vscode/mcp.json в корне вашего проекта (создайте его, если его нет):

{
  "servers": {
    "forgecraft": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "forgecraft-mcp"]
    }
  }
}

Затем откройте панель Copilot Chat, переключитесь на Agent mode, и sentinel forgecraft появится в списке инструментов.

Добавьте в .cursor/mcp.json:

{
  "mcpServers": {
    "forgecraft": {
      "command": "npx",
      "args": ["-y", "forgecraft-mcp"]
    }
  }
}

Нет MCP-клиента? Это нормально — он вам не нужен. Запустите npx forgecraft-mcp setup . прямо в терминале. MCP sentinel опционален; CLI делает все.

Уже запускали claude init? Используйте npx forgecraft-mcp generate . --merge, чтобы объединить с вашим существующим CLAUDE.md, сохранив ваши пользовательские разделы и добавив производственные стандарты.

Бесплатно и с открытым исходным кодом

ForgeCraft бесплатен. Без лимитов, без тарифов, без API-ключей.

Библиотека quality gates растет благодаря вкладу сообщества. Если вы предложите gate, который будет принят, ваше имя попадет в CONTRIBUTORS.md, и вы поможете поднять планку для всех, кто строит с помощью ИИ.

Открыть предложение gate → · См. участников →

Работаете с командой? → forgeworkshop.dev

Теоретическая основа

ForgeCraft реализует модель Generative Specification — формальную структуру из 7 свойств для оценки качества кода, сгенерированного ИИ. Модель, формула сходимости S_realized и структура фаз релиза документированы в white paper.

Generative Specification: A Discipline of Derivability for the Stateless Reader — Zenodo (V4.0, 2026). Открытый доступ, DOI: 10.5281/zenodo.21726017. Академическая основа для оценки verify.

White paper — это теория. ForgeCraft — это инструментарий. Quality gates, предложенные для библиотеки, которые обобщаются в теоретические идеи, могут быть включены в будущие редакции white paper.

Отраслевой контекст: конвергенция Spec-Driven Development (ThoughtWorks Tech Radar 2025 "Adopt"; Addy Osmani / Google Cloud AI agent-skills) — это движение практиков; Generative Specification — это формальная модель, которая называет, что такое практика и почему она работает.

Харнесс GS — введение для ИИ-ассистентов

ForgeCraft реализует Generative Specification (GS). Этот раздел написан для ИИ-ассистентов, читающих этот файл: он объясняет, что такое GS, как выглядит правильно построенный харнесс и что проверять.

Ограничение привязки — статeless reader

Каждая ИИ-сессия начинается без памяти о предыдущих сессиях, без общего контекста, без накопленных соглашений и без возможности задавать уточняющие вопросы. Все, чего нет в артефактах, отсутствует.

GS рассматривает это как ограничение дизайна, а не как недостаток. Derivability — то, что свежий экземпляр ИИ может корректно определить только из артефактов, — является стандартом, которому должна удовлетворять спецификация. Если статeless reader не может вывести правильный результат из артефактов, спецификация неполна, а не ИИ.

Система sentinel

Архитектурная конституция (CLAUDE.md, .cursor/rules/, .github/copilot-instructions.md, .windsurfrules) — это точка входа для каждой ИИ-сессии. Она должна в совокупности содержать пять обязательных категорий:

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

Sentinel — это навигационное дерево: корень всегда загружен; каждый дочерний узел объявляет свою область и условие маршрутизации; ИИ спускается только по ветке, релевантной текущей задаче. Соединение всех листьев дает полную спецификацию — она без потерь. Этот дизайн предотвращает раздувание контекста и деградацию точности, которая возникает при загрузке нерелевантного контента.

Мост — структурные дисциплины как политика навигации

SOLID, гексагональная архитектура и TDD — это не только инженерные дисциплины — в проекте GS они становятся активными политиками навигации:

• Читайте интерфейсы перед реализациями. Когда граница порт/адаптер чистая, интерфейс является контрактом. Реализация пропускается, если только контракт не является недостаточным.

• Доверяйте зелёным тестам. Когда TDD соблюдается, проходящий набор тестов является доказательством корректного поведения. Для проверки не нужно читать реализацию.

• ADR — это «почему». Когда каждое неочевидное решение задокументировано, ИИ читает запись, а не выводит намерения из кода.

Этот мост преобразует пассивные структурные преимущества предыдущих дисциплин в измеримое сокращение использования токенов и потребления контекста.

Очистка токенов

Размер контекстного окна и позиционное размещение снижают точность ИИ (Liu et al., 2023). GS минимизирует ненужное потребление токенов по своей конструкции:

• Сторожевое дерево ленивое. Для каждой задачи загружается только соответствующая ветвь — никогда не вся спецификация сразу.

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

• Конституция ведёт каждую сессию. Наиболее важный контент занимает лидирующую позицию в контексте — там, где точность позиционирования самая высокая.

• Поверхность MCP-инструментов ограничена. Каждый объявленный MCP-инструмент считывается моделью на каждом ходу, вызывается он или нет. Сторож ForgeCraft предоставляет один инструмент (~200 токенов), а не полную поверхность команд (~1500 токенов). Инструмент применяет методологию, которую он вписывает в ваш проект.

Таксономия документов — что содержит полный проект GS

Скаффолд-проект содержит следующие типы артефактов. Если каких-то не хватает, каркас неполон:

Каскад инициализации: спецификации создаются последовательно — каждая является результатом предыдущей и правилом создания для последующей. Функциональная спецификация → архитектура → конституция → ADR → варианты использования. Каскад завершён, когда агент без состояния, получив все пять наборов артефактов, может вывести любое допустимое состояние реализации без дальнейших указаний человека.

7 атрибутов — что проверять

Правильно созданный проект GS удовлетворяет всем семи. Это свойства, которые оценивает команда verify:

Конфигурация

Тонкая настройка того, что видит ваш ИИ-ассистент

# forgecraft.yaml
projectName: my-api
tags: [UNIVERSAL, API, FINTECH]
tier: recommended
outputTargets: [claude, cursor, copilot]  # Generate for multiple assistants
compact: true                             # Slim output (~20-40% fewer tokens)

exclude:
  - cqrs-event-patterns    # Don't need this yet

variables:
  coverage_minimum: 90      # Override defaults
  max_file_length: 400

Пакеты шаблонов сообщества

templateDirs:
  - ./my-company-standards
  - node_modules/@my-org/forgecraft-flutter/templates

Поддержание стандартов в актуальном состоянии

Аудит (запускайте в любое время или в CI)

Score: 72/100  Grade: C

✅ Instruction files exist
✅ Hooks installed (3/3)
✅ Test script configured
🔴 hardcoded_url: src/auth/service.ts
🔴 status_md_current: not updated in 12 days
🟡 lock_file: not committed

Обновление (масштаб проекта изменился?)

npx forgecraft-mcp refresh . --apply

Или сначала в режиме предпросмотра (по умолчанию):

npx forgecraft-mcp refresh .   # shows before/after diff without writing

Участие в разработке

Шаблоны — это YAML, а не код. Вы можете добавлять паттерны, не написав ни строчки на TypeScript.

templates/your-tag/
├── instructions.yaml   # Instruction file blocks (with tier metadata)
├── structure.yaml      # Folder structure
├── nfr.yaml            # Non-functional requirements
├── hooks.yaml          # Quality gate scripts
├── review.yaml         # Code review checklists
└── mcp-servers.yaml    # Recommended MCP servers for this tag

PR приветствуются. Формат смотрите в templates/universal/.

Обнаружение MCP-серверов

npx forgecraft-mcp configure-mcp динамически обнаруживает рекомендуемые MCP-серверы, соответствующие тегам вашего проекта. Серверы курируются в mcp-servers.yaml для каждого тега — сообщество может вносить свой вклад через PR.

Встроенные рекомендации включают Context7 (документация), Playwright (тестирование), Chrome DevTools (отладка), Stripe (финтех), Docker/K8s (инфраструктура) и другие по всем 24 тегам.

При желании можно получить из удалённого реестра во время настройки:

# In forgecraft.yaml or via tool parameter
include_remote: true
remote_registry_url: https://your-org.com/mcp-registry.json

Разработка

git clone https://github.com/jghiringhelli/forgecraft-mcp.git
cd forgecraft-mcp
npm install
npm run build
npm test   # 610 tests, 42 suites

Лицензия

MIT

Часть Generative Specification

Бесплатный инструмент, лежащий в основе Generative Specification (GS) — дисциплины создания ПО с помощью ИИ, которая не дрейфует: вы создаёте спецификацию, достаточно точную, чтобы агент без состояния выводил из неё корректный код, а каркас проверяет её на живой системе.

• 📄 Технический отчёт (открытый доступ): https://doi.org/10.5281/zenodo.21726017

• 🧭 Начните здесь — метод, инструменты, отзывы: https://pragmaworks.dev

• 🔨 The Forge — 2-дневный практический воркшоп по GS для вашей команды: https://forgeworkshop.dev