@jakerdy/agentica 0.0.2 → 0.0.4

package/README.md

@@ -1,6 +1,6 @@
 # Agentica
 
-[![Version](https://img.shields.io/badge/version-0.1.0-blue)](https://github.com/jakerdy/agentica/releases/tag/v0.1.0)
+[![Version](https://img.shields.io/badge/version-0.0.4-blue)](https://github.com/jakerdy/agentica/releases/tag/v0.0.4)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Bun Build](https://img.shields.io/badge/build-bun-orange)](https://bun.sh)
 
@@ -13,26 +13,23 @@
 
 ## Prerequisites
 
-- VSCode 1.109.0+
+- [VSCode](https://code.visualstudio.com/) 1.109.0+
 - GitHub Copilot
-- Bun 1.3+ / Node.js 18+ (для запуска CLI)
-- Context7 (`Upstash.context7-mcp`) — опционально
+- [Bun](https://bun.com/docs/installation) 1.3+ или [Node.js](https://nodejs.org/en/download) 18+ (для запуска CLI)
+- Расширение Context7 (`Upstash.context7-mcp`) — опционально
 
 ## Quick Start
 
 ```bash
-# Установка глобально
-bun install -g @jakerdy/agentica
+# Запускаем без установки
+bunx @jakerdy/agentica init typescript/cli MyProject
 
-# Инициализация (работает и в пустой папке, и в существующем проекте)
-agentica init typescript/cli MyProject
-
-# Открытие в VSCode
-cd MyProject
-code .
+# Открываем в VSCode
+cd MyProject && code .
 ```
 После `init` Agentica автоматически:
 - копирует в проект `.agentica/prompts`, `.agentica/templates` и `.agentica/skills`;
+- создаёт директории спецификаций `.agentica/architecture`, `.agentica/changes`, `.agentica/features`, `.agentica/release`;
 - обновляет `.vscode/settings.json`, добавляя пути в `chat.promptFilesLocations` и `chat.agentSkillsLocations`.
 - добавит context7 в рекомендованные расширения, чтобы агенты сами могли искать документацию по библиотекам
 
@@ -47,6 +44,35 @@ code .
  - Прочие важные детали
 ```
 
+## CLI
+
+Чтобы было проще интегрировать Agentica в ваш проект, был создан небольшой, но удобный CLI.
+
+Agentica CLI поддерживает два формата запуска `init`:
+- **Позиционный (основной):** `agentica init <stack> [targetPath]`
+- **Через опции (совместимость):** `agentica init --stack <type> [--out <path>]`
+
+### Основные команды
+
+```bash
+# Инициализация Agentica в текущей папке
+agentica init typescript/cli
+
+# Инициализация с созданием новой папки проекта
+agentica init typescript/spa MyProject
+
+# То же через опции (режим совместимости)
+agentica init --stack typescript/spa --out MyProject
+
+# Показать доступные шаблоны стеков
+agentica stacks
+
+# Справка по CLI
+agentica --help
+agentica init --help
+```
+
+
 ## Мотивация
 
 Agentica был создан в ходе мучительного поиска "идеального" инструмента для работы с агентными системами.
@@ -78,9 +104,9 @@ Agentica - это конструктор таких спек. Она запол
 
 ## Философия подхода
 
-### 0. Вся ответственность за принятые решения лежит на тебе
+### 0. Вся ответственность за принятые решения лежит на вас
 
-Прелесть агентов заключается в том, что они мультиплицируют твои возможности по написанию кода в разы, а то и в десятки раз. Но не весь тот код, что написал агент, следует сразу лить в прод.
+Прелесть агентов заключается в том, что они мультиплицируют ваши возможности по написанию кода в разы, а то и в десятки раз. Но не весь тот код, что написал агент, следует сразу лить в прод.
 
 В идеале, вся та работа по "продумыванию" проекта должна быть сделана человеком. И только после того, как человек удостоверился в том что:
 - Все структуры данных и интерфейсы правильные
@@ -134,8 +160,8 @@ Agentica строго разделяет уровни ответственнос
 ```text
 .
 ├── .agentica/                  # GLOBAL SCOPE (Конфигурация и общие знания)
-│   ├── templates/              # Шаблоны (feature, arch, change)
-│   ├── prompts/                # Промпты (init, create, implement...)
+│   ├── templates/              # Шаблоны (feature, arch, change, release)
+│   ├── prompts/                # Промпты (init, create, implement, commit, release...)
 │   ├── skills/                 # Skills для Copilot Agent (например frontend-design)
 │   ├── product.md              # Глобальный продукт
 │   ├── structure.md            # Структура репозитория
@@ -147,6 +173,7 @@ Agentica строго разделяет уровни ответственнос
 │   │   │   ├── architecture/   # AR-XXXX (Архитектурные решения)
 │   │   │   ├── changes/        # CH-XXXX (Изменения существующего)
 │   │   │   ├── features/       # FT-XXXX (Новые фичи)
+│   │   │   ├── release/        # REL-XXXX (Подготовка и выпуск релизов)
 │   │   │   ├── product.md      # Контекст пакета
 │   │   │   ├── structure.md    # Структура пакета
 │   │   │   ├── tech.md         # Стек пакета
@@ -163,18 +190,20 @@ Agentica строго разделяет уровни ответственнос
 
 Все команды вызываются через `/agentica.<command>`. Аргументы опциональны - агент постарается вывести их из контекста, но явное указание надежнее.
 
-| Команда     | Аргументы | Назначение                                            |
-| :---------- | :-------- | :---------------------------------------------------- |
-| `init`      | `--lang`, | Инициализация и настройка проекта                     |
-| `architect` | `--name`  | Архитектурная спецификация (`AR-XXXX`)                |
-| `reverse`   | `--name`  | Reverse Engineering по существующему коду (`AR-XXXX`) |
-| `create`    | `--name`  | Спецификация новой фичи (`FT-XXXX`)                   |
-| `change`    | `--name`  | Спецификация изменений (`CH-XXXX`)                    |
-| `tasks`     | `--id`    | Декомпозиция спеки на задачи                          |
-| `implement` | `--id`    | Написание кода по задачам                             |
-| `validate`  | `--id`    | Семантическая и техническая приемка                   |
-| `readme`    | `--id`    | Генерация документации                                |
-| `refactor`  | ---       | Улучшение кода без смены API                          |
+| Команда     | Аргументы       | Назначение                                            |
+| :---------- | :-------------- | :---------------------------------------------------- |
+| `init`      | `--lang`,       | Инициализация и настройка проекта                     |
+| `architect` | `--name`        | Архитектурная спецификация (`AR-XXXX`)                |
+| `reverse`   | `--name`        | Reverse Engineering по существующему коду (`AR-XXXX`) |
+| `create`    | `--name`        | Спецификация новой фичи (`FT-XXXX`)                   |
+| `change`    | `--name`        | Спецификация изменений (`CH-XXXX`)                    |
+| `tasks`     | `--id`          | Декомпозиция спеки на задачи                          |
+| `implement` | `--id`          | Написание кода по задачам                             |
+| `validate`  | `--id`          | Семантическая и техническая приемка                   |
+| `commit`    | `--skip-checks` | Коммит с проверками безопасности                      |
+| `release`   | `--type`        | Подготовка релиза (`REL-XXXX`) и черновика changelog  |
+| `readme`    | `--id`          | Генерация документации                                |
+| `refactor`  | ---             | Улучшение кода без смены API                          |
 
 ---
 
@@ -193,8 +222,10 @@ Agentica строго разделяет уровни ответственнос
 
 ```text
 /agentica.init --lang TypeScript
-Сделай CLI для импорта CSV. Нужны команды import, validate.
-Используй commander и chalk.
+
+Проект посвящён разработке CLI-инструментов для управления задачами. Основные функции включают создание, обновление и удаление задач, а также интеграцию с календарём. Важно обеспечить поддержку плагинов и расширений в будущем.
+
+Оснвной стек: TypeScript, Node.js, Commander.js для CLI
 ```
 *Что происходит:* Агент создает структуру `.agentica/`, заполняет `tech.md` и `structure.md` под ваш запрос, готовит промпты.
 
@@ -254,38 +285,40 @@ Agentica строго разделяет уровни ответственнос
 Восстанови карту модулей, просканируй entry-points.
 Найди циклические зависимости и узкие места в текущей реализации.
 ```
-*Агент просканирует кодовую базу и создаст описание системы "As-Is", подсветив зоны риска и архитектурный долг.*
+*Агент просканирует кодовую базу и создаст описание системы "As-Is" в отдельном `AR-XXXX` документе, подсветив зоны риска и архитектурный долг.*
 
 ### 6. Документация
+
+Когда работа над фичей закончена, и нужно быстро сгенерировать понятную документацию:
+
 ```text
 /agentica.readme --id FT-0012
-Сделай короткую доку для разработчиков с примерами.
+Сделай короткую доку для разработчиков с примерами и описанием архитектуры нового решения.
 ```
 
-## CLI
+### 7. Коммит "по богатому"
 
-Чтобы было проще интегрировать Agentica в ваш проект, был создан небольшой, но удобный CLI.
+Используйте, когда нужно автоматически собрать staged-изменения, проверить их на мусор/секреты и создать качественное сообщение коммита.
 
-Agentica CLI поддерживает два формата запуска `init`:
-- **Позиционный (основной):** `agentica init <stack> [targetPath]`
-- **Через опции (совместимость):** `agentica init --stack <type> [--out <path>]`
+Или просто используйте его всегда, когда собираетесь коммитить. Это просто, довольно быстро, а плюсы огромныe:
+- Детальные сообщения которые муторно и лениво писать руками
+- Гарантия, что в коммит не попадет мусор или секреты
+- На основе истории можно будет делать качественные changelog'и и релизы, а не "misc updates" и "fixes"
 
-### Основные команды
+```text
+/agentica.commit
+Подготовь commit для текущих изменений.
+```
+*Агент добавит изменения в stage, предупредит о потенциальных артефактах (`.exe`, `.dll`, `.tgz` и т.п.), предложит обновить `.gitignore`, сформирует сообщение в формате `<change_type>: <Short Change Description>` + детальное описание и выполнит `git commit`.*
 
-```bash
-# Инициализация Agentica в текущей папке
-agentica init typescript/cli
+### 8. Подготовка релиза
 
-# Инициализация с созданием новой папки проекта
-agentica init typescript/spa MyProject
+Используйте, когда нужно пройти предрелизный аудит, собрать changelog из коммитов и подготовить план публикации.
 
-# То же через опции (режим совместимости)
-agentica init --stack typescript/spa --out MyProject
+```text
+/agentica.release --type minor
+Собери релиз для текущего состояния main и подготовь команды публикации.
+```
+*Агент проверит ветку (`main/master`), рассчитает новую версию (patch/minor/major), соберёт черновик changelog с последнего тега, пройдёт предрелизный checklist и создаст `REL-XXXX` документ.*
 
-# Показать доступные шаблоны стеков
-agentica stacks
 
-# Справка по CLI
-agentica --help
-agentica init --help
-```

package/dist/cli.js

@@ -32,14 +32,14 @@ Expecting one of '${J.join("', '")}'`);let Z=`${q}Help`;return this.on(Z,($)=>{l
 
 ---
 
-`,Tz="globals",jz="anti-spaghetti.md",Nz="use-agentica.md";function hq(q,z,J){let Z=E(z,".agentica"),$=E(Z,Vz),Q=E(Z,Rz);if(D($))Lz($,Q);let X=E(q,Tz),Y=`lang-${J}.md`,U=o(E(X,Y),"utf-8"),B=o(E(X,jz),"utf-8"),H=o(E(X,Nz),"utf-8"),G=[U,B,H].join(Pz);Mz($,G,"utf-8")}var __dirname="E:\\Dev\\2026-02-15 - Agentica\\src\\commands",Dz=".agentica",uq="prompts",gq="templates",mq="skills",Ez="stacks",Fz="status.md",dq=1,wz=["prompts","templates","architecture","changes","features"],Sz=["product.md","structure.md","tech.md"];async function lq(q){console.log(W.blue(`
+`,Tz="globals",jz="anti-spaghetti.md",Nz="use-agentica.md";function hq(q,z,J){let Z=E(z,".agentica"),$=E(Z,Vz),Q=E(Z,Rz);if(D($))Lz($,Q);let X=E(q,Tz),Y=`lang-${J}.md`,U=o(E(X,Y),"utf-8"),B=o(E(X,jz),"utf-8"),H=o(E(X,Nz),"utf-8"),G=[U,B,H].join(Pz);Mz($,G,"utf-8")}var __dirname="E:\\Dev\\2026-02-15 - Agentica\\src\\commands",Dz=".agentica",uq="prompts",gq="templates",mq="skills",Ez="stacks",Fz="status.md",dq=1,wz=["prompts","templates","architecture","changes","features","release"],Sz=["product.md","structure.md","tech.md"];async function lq(q){console.log(W.blue(`
 \uD83D\uDE80 Инициализация Agentica...
 `));let z=Az(q.stack);if(!z)_z(q.stack);await new pq(q,z).execute()}class pq{options;stack;repoRoot;targetDir;stackDir;agenticaDir;constructor(q,z){this.options=q;this.stack=z;this.repoRoot=Oz(),this.targetDir=this.options.name?cq(process.cwd(),this.options.name):process.cwd(),this.stackDir=R(this.repoRoot,Ez,this.stack.lang,this.stack.type),this.agenticaDir=R(this.targetDir,Dz)}async execute(){this.ensureStackExists(),this.createProjectDirIfNeeded(),this.createAgenticaDirectories(),this.copyPrompts(),this.copyTemplates(),this.copySkills(),this.copyStackTemplateFiles(),this.createStatusFile(),this.composeAgentsFile(),this.updateVSCodeConfiguration(),this.printSuccessMessage()}ensureStackExists(){if(D(this.stackDir))return;console.error(W.red(`❌ Стек не найден: ${this.stack.lang}/${this.stack.type}`)),console.error(W.yellow(`   Путь проверки: ${this.stackDir}`)),process.exit(dq)}createProjectDirIfNeeded(){if(!this.options.name)return;j(this.targetDir),console.log(W.green(`✓ Создана директория: ${this.options.name}`))}createAgenticaDirectories(){j(this.agenticaDir),console.log(W.green("✓ Создана .agentica/"));for(let q of wz)j(R(this.agenticaDir,q))}copyPrompts(){let q=R(this.repoRoot,uq),z=R(this.agenticaDir,uq);k(q,z),console.log(W.green("✓ Скопирована prompts/"))}copyTemplates(){let q=R(this.repoRoot,gq),z=R(this.agenticaDir,gq);k(q,z),console.log(W.green("✓ Скопирована templates/"))}copySkills(){let q=R(this.repoRoot,mq),z=R(this.agenticaDir,mq);k(q,z),console.log(W.green("✓ Скопирована skills/"))}copyStackTemplateFiles(){for(let q of Sz){let z=R(this.stackDir,q),J=R(this.agenticaDir,q);t(z,J)}console.log(W.green(`✓ Скопирован шаблон стека: ${this.stack.lang}/${this.stack.type}`))}createStatusFile(){let q=xz(this.stack),z=R(this.agenticaDir,Fz);Iz(z,q,"utf-8"),console.log(W.green("✓ Создан status.md"))}composeAgentsFile(){hq(this.repoRoot,this.targetDir,this.stack.lang),console.log(W.green("✓ Сформирован AGENTS.md"))}updateVSCodeConfiguration(){try{fq(this.targetDir),vq(this.targetDir),console.log(W.green("✓ Обновлён .vscode/settings.json")),console.log(W.green("✓ Обновлён .vscode/extensions.json"))}catch(q){console.warn(W.yellow(`⚠ Предупреждение: не удалось обновить настройки VSCode: ${q}`))}}printSuccessMessage(){if(console.log(W.green.bold(`
 ✨ Agentica успешно инициализирована!
-`)),console.log(W.cyan("Следующие шаги:")),this.options.name)console.log(W.white(`  1. cd ${this.options.name}`));console.log(W.white("  2. Открой проект в VSCode: code .")),console.log(W.white(`  3. Начни с промпта /agentica.init d чате Copilot:
+`)),console.log(W.cyan("Следующие шаги:")),this.options.name)console.log(W.white(`  1. cd ${this.options.name}`));console.log(W.white("  2. Открой проект в VSCode: code .")),console.log(W.white(`  3. Начни с промпта /agentica.init в чате Copilot:
     - Опиши свой проект, и стек технологий (после команды)
     - Agentica подстроится под твои нужды
-    - А дальще можно запускать /agentica.create или /agentica.change
+    - А дальше можно запускать /agentica.create, /agentica.change, /agentica.commit или /agentica.release
     - И обязательно прочитай и донастрой AGENTS.md
     `))}}function _z(q){console.error(W.red(`❌ Неверный формат стека: ${q}`)),console.error(W.yellow("   Ожидаемый формат: <lang>/<type>")),console.error(W.yellow("   Примеры: typescript/cli, python/gui")),process.exit(dq)}function Az(q){let z=q.split("/");if(z.length!==2)return null;let[J,Z]=z;if(!J||!Z)return null;return{lang:J,type:Z}}function Oz(){return cq(__dirname,"../..")}function xz(q){return`# Статус Agentica
 

package/globals/use-agentica.md

@@ -13,8 +13,8 @@
 **Корневой уровень** (`.agentica/` в корне проекта):
 ```
 .agentica/
-├── prompts/          # Воркфлоу агентов (init, create, implement, validate)
-├── templates/        # Шаблоны спек (feature, change, architecture)
+├── prompts/          # Воркфлоу агентов (init, create, tasks, implement, validate, commit, release)
+├── templates/        # Шаблоны спек (feature, change, architecture, release)
 ├── product.md        # Глобальное продуктовое видение
 ├── structure.md      # Структура и организация репозитория
 ├── tech.md           # Глобальный тех-стек и стандарты
@@ -27,6 +27,7 @@ packages/my-package/.agentica/
 ├── features/         # Спеки FT-XXXX (новая функциональность)
 ├── changes/          # Спеки CH-XXXX (изменения существующего кода)
 ├── architecture/     # Спеки AR-XXXX (архитектурные решения и паттерны)
+├── release/          # Спеки REL-XXXX (подготовка и выпуск релизов)
 ├── product.md        # Назначение и домен пакета
 ├── structure.md      # Файловая структура пакета
 ├── tech.md           # Стек и паттерны конкретного пакета
@@ -86,7 +87,7 @@ IDE автоматически предоставляет доступ к фак
 - Консистентность > новизна
 
 **4. Следуй процессу**
-Каждый воркфлоу Agentica имеет определённые шаги (init → create → tasks → implement → validate). Если пользователь просит сделать что-то масштабное:
+Каждый воркфлоу Agentica имеет определённые шаги (init → create/change → tasks → implement → validate → commit → release). Если пользователь просит сделать что-то масштабное:
 - Проверь, существует ли связанная спека
 - Если спеки нет - рекомендуй сначала использовать `/agentica.create`
 - Не пиши большие фичи "фристайлом" без спеки
@@ -101,6 +102,8 @@ IDE автоматически предоставляет доступ к фак
 2. Распланируй задачи: `/agentica.tasks --id FT-XXXX`
 3. Реализуй: `/agentica.implement --id FT-XXXX`
 4. Валидируй: `/agentica.validate --id FT-XXXX`
+5. Подготовь коммит: `/agentica.commit`
+6. Подготовь релиз: `/agentica.release --type patch|minor|major`
 
 Это обеспечит:
 - Правильное планирование архитектуры

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jakerdy/agentica",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Spec-driven framework for agent coding with developer-first approach",
   "keywords": [
     "ai",
@@ -39,14 +39,16 @@
   ],
   "scripts": {
     "build": "bun run build.ts",
-    "prepublishOnly": "bun run build"
+    "prepublishOnly": "bun run build",
+    "typecheck": "tsc --noEmit"
   },
   "engines": {
     "node": ">=18.0.0"
   },
   "devDependencies": {
-    "typescript": "^5",
-    "@types/bun": "latest"
+    "@biomejs/biome": "^2.4.2",
+    "@types/bun": "latest",
+    "typescript": "^5"
   },
   "dependencies": {
     "chalk": "^5.6.2",

package/prompts/commit.prompt.md

@@ -0,0 +1,134 @@
+---
+name: agentica.commit
+description: Безопасная подготовка staged-изменений и создание семантического commit message
+---
+
+## Ввод пользователя
+
+```text
+$ARGUMENTS
+```
+
+Ты **ОБЯЗАН** учесть ввод пользователя (аргументы и контекст) перед тем как продолжить.
+
+## Цель и принцип работы
+
+Твоя задача — подготовить и выполнить коммит в безопасном режиме:
+1. Добавить изменения в stage.
+2. Проверить, что в stage нет лишних файлов, секретов и бинарного мусора.
+3. Сформировать корректный commit message.
+4. Выполнить `git commit`.
+
+Работай строго линейно: **Диагностика → Stage → Проверка содержимого stage → Генерация commit message → Commit → Отчёт**.
+
+## Глобальные запреты (Safety Guards)
+
+Останови выполнение и не коммить, если:
+1. Текущая директория не является git-репозиторием.
+2. После staging обнаружены потенциальные секреты, и пользователь не подтвердил продолжение.
+3. В stage есть нежелательные бинарные/сборочные артефакты, и пользователь не подтвердил продолжение.
+4. В stage нет изменений (пустой коммит не запрошен явно).
+
+В случае остановки: объясни причину и покажи, как исправить ситуацию.
+
+## Фаза 1: Диагностика git-контекста
+
+1. Проверь git-контекст:
+   - `git rev-parse --is-inside-work-tree`
+2. Собери текущее состояние:
+   - `git status --short`
+
+## Фаза 2: Stage всех изменений
+
+1. Добавь все изменения в stage:
+   - `git add -A`
+2. Проверь staged-список:
+   - `git diff --cached --name-status`
+
+## Фаза 3: Проверка stage на риски
+
+Если пользователь указал ключ `--skip-checks`, пропусти эту фазу и перейди к генерации commit message.
+
+### 3.1 Поиск мусорных/артефактных файлов
+
+Проверь staged-файлы на признаки артефактов и мусора (например):
+- `*.exe`, `*.dll`, `*.dylib`, `*.so`, `*.a`, `*.o`, `*.obj`
+- `*.tgz`, `*.zip`, `*.tar`, `*.gz`, `*.7z`
+- <другие типы не похожие на исходники>
+- фалйы большого размера (например, >5MB), если это не типичные для проекта ассеты.
+- build-output и временные директории (`dist/`, `build/`, `.cache/`, `coverage/`, и т.д.), если они не должны коммититься по правилам проекта.
+
+Если найдено:
+1. Покажи пользователю список подозрительных файлов.
+2. Предупреди, что эти файлы выглядят как мусор/артефакты/temp.
+3. Предложи обновить `.gitignore` и убрать лишнее из stage.
+4. Через `ask_questions` попроси выбрать действие:
+   - убрать артефакты из stage и продолжить;
+   - убрать и обновить `.gitignore`, затем продолжить;
+   - продолжить как есть (только при явном подтверждении пользователя).
+
+### 3.2 Поиск потенциальных секретов
+
+Проверь staged-изменения на явные признаки секретов:
+- API keys / tokens / private keys / passwords / connection strings.
+- Паттерны вида `AKIA...`, `ghp_...`, `-----BEGIN PRIVATE KEY-----`, `password=`, `secret=`, `token=`.
+
+Если найдено:
+1. Покажи только безопасный контекст (без полного вывода секрета).
+2. Останови авто-коммит.
+3. Через `ask_questions` предложи:
+   - удалить/замаскировать секреты и продолжить;
+   - если это .env создать .env.example и обновить .gitignore; 
+   - исключить файл из stage;
+   - отменить операцию.
+
+### 3.3 Поиск неуместных фраз и матершины в коде
+
+Иногда так бывает, что у разработчика здают нервы, и он пишет в коде нецензурные выражения. Это может быть проблемой, если такие изменения попадут в историю. Поэтому стоит проверять staged-изменения на наличие таких фраз и предупреждать пользователя, сразу предлагая более нейтральные формулировки.
+
+По этому:
+- Проверь изменения на матершину и прочие NSFW вещи в коментариях, именах переменных и прочих текстовых изменениях.
+- Если это часть локализации или "ассетов" - ок, пропускаем.
+
+## Фаза 4: Формирование commit message
+
+Сформируй сообщение в формате:
+
+```text
+<change_type>: <Short Change Description>
+
+Detailed semantic description of changes
+```
+
+Где:
+- `<change_type>` — один из: `feat`, `fix`, `refactor`, `docs`, `test`, `chore`, `build`, `ci`, `perf`, `revert`.
+- `Short Change Description` — коротко, по сути, в одну строку.
+- `Detailed semantic description` — 2+ строк с ключевыми изменениями (списоком, не файлы, а семантика), мотивацией и влиянием.
+
+Правила качества commit message:
+1. Заголовок до ~72 символов.
+2. Без абстрактных формулировок вроде "misc updates".
+3. Опираться только на реально staged изменения.
+4. Семантические описания вместо конкретных файлов/строк.
+4. Если staged содержит несколько несвязанных изменений — предложить пользователю разбить на несколько коммитов.
+
+## Фаза 5: Выполнение commit
+
+1. Выполни:
+   - `git commit -m "<title>" -m "<body>"`
+2. Если commit не выполнен (hook/validation failed) — покажи ошибку и предложи шаги исправления.
+
+## Фаза 6: Отчёт пользователю
+
+Выдай краткий отчёт:
+1. Что было добавлено в stage.
+2. Были ли найдены мусорные файлы/секреты и как решено.
+3. Итоговый commit message.
+4. Результат `git commit` (хеш и краткая сводка файлов).
+
+## Требования к качеству
+
+1. Не выводи секреты в открытом виде.
+2. Не коммить без проверки staged-содержимого.
+3. Если есть сомнения в корректности набора изменений — спроси пользователя через `ask_questions` перед commit.
+4. Всегда явно предупреждай о рисках загрязнения истории бинарными артефактами и предлагай обновить `.gitignore`.

package/prompts/init.prompt.md

@@ -19,7 +19,7 @@ $ARGUMENTS
 ### Глобальные запреты (Safety Guards)
 
 Останови выполнение и не вноси изменения, если:
-1. Запрос требует другого пайплайна (task, implement, refactor, readme), а не инициализации/настройки.
+1. Запрос требует другого пайплайна (tasks, implement, refactor, readme, commit, release), а не инициализации/настройки.
 2. Пользователь просит изменить узкую реализацию, несвязанную с настройкой Agentica.
 3. Входные данные противоречивы.
 4. Проект **уже инициализирован** (есть `.agentica/` и ключевые файлы), и пользователь не выбрал явный режим обновления.
@@ -33,7 +33,7 @@ $ARGUMENTS
 ### Группы артефактов
 1. **[Context]:** `product.md`, `structure.md`, `tech.md`, `status.md`. (Обязательны для любого активного скоупа).
 2. **[Config]:** Директории `prompts/`, `templates/`. (Только в корне проекта/репозитория).
-3. **[Specs]:** Директории `architecture/`, `changes/`, `features/`. (Только там, где лежит код/пакет).
+3. **[Specs]:** Директории `architecture/`, `changes/`, `features/`, `release/`. (Только там, где лежит код/пакет).
 
 ### Матрица размещения
 
@@ -87,6 +87,7 @@ $ARGUMENTS
 5. Обнови **[Config]** в root `.agentica/`:
   - синхронизируй все файлы в `.agentica/prompts/` с новым набором инструментов;
   - обязательно проверь `refactor.prompt.md` и `validate.prompt.md` на конкретные команды;
+  - обязательно адаптируй `release.prompt.md` под стек и реальные команды релизного пайплайна;
   - выполни семантический поиск по запуску инструментов и regex-поиск упоминаний legacy-команд (`bun`, `tsc` и т.п.), затем замени их на актуальные.
 6. Обнови шаблоны в `.agentica/templates/`, чтобы формулировки по сборке, тестам, линтингу и валидации соответствовали реальному техстеку.
 7. Проверь консистентность: одинаковые команды и правила должны использоваться в `tech.md`, промптах и шаблонах без противоречий.
@@ -110,7 +111,7 @@ $ARGUMENTS
 
 Перед выдачей ответа проверь:
 1. Все файлы из групп **[Context]**, **[Config]**, **[Specs]** существуют на своих местах согласно матрице размещения.
-2. В корне Monorepo **нет** папок `architecture`, `changes`, `features`.
+2. В корне Monorepo **нет** папок `architecture`, `changes`, `features`, `release`.
 3. В `status.md` записан актуальный статус.
 4. Файлы `product/structure/tech` не противоречат друг другу.
 

package/prompts/release.prompt.md

@@ -0,0 +1,127 @@
+---
+name: agentica.release
+description: Подготовка релиза, сборка черновика changelog и предрелизный аудит
+---
+
+## Ввод пользователя
+
+```text
+$ARGUMENTS
+```
+
+Ты **ОБЯЗАН** учесть ввод пользователя (аргументы и контекст) перед тем как продолжить.
+
+## Цель и принцип работы
+
+Твоя задача — подготовить релизный пакет в формате `REL-XXXX`:
+1. Проверить готовность репозитория к релизу.
+2. Вычислить новую версию и собрать черновик `Changelog`.
+3. Сформировать документ релиза по шаблону.
+4. Выдать отчёт о рисках и командах публикации.
+
+Работай строго линейно: **Проверка ветки → Выбор версии → Сбор коммитов → Предрелизный аудит → Генерация REL-документа → Отчёт**.
+
+## Глобальные запреты (Safety Guards)
+
+Останови выполнение и не вноси изменения, если:
+1. Текущая ветка не `main` и не `master`.
+2. Невозможно определить предыдущий релиз (нет тегов и нет версии в манифестах).
+3. Репозиторий не является git-репозиторием.
+
+В случае остановки: объясни причину, покажи минимальные шаги для исправления и предложи перезапустить `agentica.release`.
+
+## Топология и размещение файлов
+
+Документ релиза хранится в:
+- `.agentica/release/REL-XXXX - <Release Name>.md`
+
+Шаблон релиза:
+- `.agentica/templates/release/REL-0000 - Release Name.md`
+
+## Фаза 1: Проверка git-контекста
+
+1. Проверь, что репозиторий git и текущая ветка через `run_in_terminal`:
+   - `git rev-parse --is-inside-work-tree`
+   - `git branch --show-current`
+2. Если ветка не `main`/`master` — **STOP**.
+3. Найди предыдущую версию:
+   - сначала `git describe --tags --abbrev=0`
+   - если тега нет, попробуй получить текущую версию из манифестов (`package.json`, `pyproject.toml`, `Cargo.toml`, и т.д. — по стеку проекта).
+
+## Фаза 2: Вычисление новой версии
+
+1. Спроси пользователя через `ask_questions` тип увеличения версии:
+   - `patch`
+   - `minor`
+   - `major`
+2. На основе предыдущей версии вычисли новую семантическую версию (`X.Y.Z`).
+3. Определи новый release id:
+   - Найди существующие документы `REL-XXXX` в `.agentica/release/`.
+   - Новый ID = max + 1.
+
+## Фаза 3: Сбор changelog по коммитам
+
+1. Собери коммиты с последнего тега до `HEAD`:
+   - `git log <prev_tag>..HEAD --pretty=format:"%h|%s|%an|%ad" --date=short`
+   - если тега нет: используй разумный диапазон (например, все коммиты текущей ветки).
+2. Сгруппируй коммиты в черновик changelog:
+   - Features
+   - Fixes
+   - Refactor/Chore
+   - Docs/Test/Build
+3. Пройдись по каждому коммиту и убери шум:
+   - merge-коммиты
+   - технические коммиты без продуктовой ценности (оставляй в отдельном блоке при необходимости).
+
+## Фаза 4: Предрелизный аудит
+
+Проверь и явно зафиксируй статус каждого пункта:
+
+1. Версии в манифестах пакетов совпадают с вычисленной версией.
+2. Все изменения закоммичены (`git status --porcelain` пустой).
+3. Код форматируется, линтится, компилируется и собирается (команды брать из `tech.md`, `README.md`, `package.json`/`pyproject.toml`).
+4. Dry-run публикации работает (если применимо стеку):
+   - npm: `npm publish --dry-run`
+   - bun: `bun publish --dry-run`
+   - python: `python -m build` + `twine check dist/*` (или эквивалент)
+5. Окружение для публикации настроено корректно:
+   - наличие токенов/credentials (без вывода секретов)
+   - корректный registry/repository endpoint
+
+Если проверка неприменима к стеку — отмечай как `N/A` с коротким объяснением.
+
+## Фаза 5: Генерация REL-документа
+
+1. Создай новый файл по шаблону:
+   - `.agentica/release/REL-XXXX - <Release Name>.md`
+2. Заполни:
+   - версию (`previous` → `next`)
+   - дату
+   - pre-release checklist
+   - changelog draft
+   - stack-oriented release plan
+   - блок рисков и блокеров
+
+## Фаза 6: Отчёт пользователю
+
+Выдай короткий отчёт:
+1. Какая версия рассчитана (`from` → `to`).
+2. Где создан REL-документ.
+3. Какие проверки пройдены/провалены/неприменимы.
+4. Точный список команд, которые пользователь должен выполнить для публикации релиза.
+
+## Фаза 7: Помощь в публикации (по запросу)
+
+Предложи пользователю помощь в публикации релиза. Если он согласится, выполни все необходимые действия перед публикацией:
+1. Апнуть версии в манифестах.
+2. Закоммитить изменения с сообщением `chore(release): prepare vX.Y.Z`.
+3. Создать тег `vX.Y.Z` и отправить его в origin.
+4. Обновить Badges в `README.md` (если есть).
+5. Написать финальную команду для публикации релиза и дать краткие инструкции по её запуску.
+
+## Требования к качеству
+
+1. Версия должна быть semver-валидной и согласованной между документом и манифестами.
+2. Changelog должен строиться только из реальных коммитов диапазона релиза.
+3. Если есть блокеры, команды публикации всё равно показать, но пометить как «не запускать до устранения блокеров».
+4. Никакие секреты не выводить в отчёт.

package/stacks/python/cli/structure.md

@@ -8,6 +8,7 @@
 │   ├── templates/                     # Шаблоны для фич/изменений/архитектурных решений
 │   ├── features/                      # Описания фич (требования, UX, acceptance)
 │   ├── changes/                       # Журнал изменений, миграции, заметки по релизам
+│   ├── release/                       # Релизные документы (REL-XXXX)
 │   ├── architecture/                  # Архитектурные решения (ADR), схемы, компромиссы
 │   ├── product.md                     # Описание проекта с продуктовой точки зрения
 │   ├── structure.md                   # Этот файл: структура репозитория

package/stacks/python/gui/structure.md

@@ -8,6 +8,7 @@
 │   ├── templates/                     # Шаблоны для фич/изменений/архитектурных решений
 │   ├── features/                      # Описания фич и UX сценариев
 │   ├── changes/                       # Журнал изменений и миграции
+│   ├── release/                       # Релизные документы (REL-XXXX)
 │   ├── architecture/                  # Архитектурные решения (ADR)
 │   ├── product.md                     # Описание проекта с продуктовой точки зрения
 │   ├── structure.md                   # Этот файл: структура репозитория

package/stacks/python/lib/structure.md

@@ -8,6 +8,7 @@
 │   ├── templates/                     # Шаблоны для фич/изменений/архитектурных решений
 │   ├── features/                      # Описания фич (контракты, примеры, UX)
 │   ├── changes/                       # Изменения, миграции, заметки по версиям
+│   ├── release/                       # Релизные документы (REL-XXXX)
 │   ├── architecture/                  # Архитектурные решения (ADR)
 │   ├── product.md                     # Описание проекта с продуктовой точки зрения
 │   ├── structure.md                   # Этот файл: структура репозитория

package/stacks/python/monorepo/structure.md

@@ -13,6 +13,7 @@
 ├── packages/                          # Набор Python пакетов (каждый со своим `pyproject.toml`)
 │   ├── package1/                      # Пример пакета
 │   │   ├── .agentica/                 # Документы Agentica, относящиеся к этому пакету
+│   │   │   ├── release/               # Релизные документы пакета (REL-XXXX)
 │   │   ├── <package_name>/            # Исходный код пакета
 │   │   ├── tests/                     # Тесты пакета
 │   │   └── pyproject.toml             # Зависимости и конфигурация инструментов пакета

package/stacks/typescript/cli/structure.md

@@ -8,6 +8,7 @@
 │   ├── templates/                     # Шаблоны для фич/изменений/архитектурных решений
 │   ├── features/                      # Описания фич (команды, UX, контракты)
 │   ├── changes/                       # Журнал изменений (breaking changes, миграции)
+│   ├── release/                       # Релизные документы (REL-XXXX)
 │   ├── architecture/                  # Архитектурные решения (ADR)
 │   ├── product.md                     # Описание CLI с продуктовой точки зрения
 │   ├── structure.md                   # Этот файл: структура репозитория

package/stacks/typescript/lib/structure.md

@@ -8,6 +8,7 @@
 │   ├── templates/                     # Шаблоны для фич/изменений/архитектурных решений
 │   ├── features/                      # Описания фич (контракты API, примеры)
 │   ├── changes/                       # Изменения, миграции, заметки по версиям
+│   ├── release/                       # Релизные документы (REL-XXXX)
 │   ├── architecture/                  # Архитектурные решения (ADR)
 │   ├── product.md                     # Описание библиотеки с продуктовой точки зрения
 │   ├── structure.md                   # Этот файл: структура репозитория

package/stacks/typescript/monorepo/structure.md

@@ -13,6 +13,7 @@
 ├── packages/                          # Пакеты монорепозитория
 │   ├── package1/                      # Пример пакета
 │   │   ├── .agentica/                 # Документы Agentica, относящиеся к пакету
+│   │   │   ├── release/               # Релизные документы пакета (REL-XXXX)
 │   │   ├── src/                       # Исходный код пакета
 │   │   ├── tests/                     # Тесты пакета
 │   │   └── ...                        # Прочие файлы пакета (конфиги, assets)

package/stacks/typescript/server/structure.md

@@ -8,6 +8,7 @@
 │   ├── templates/                     # Шаблоны для фич/изменений/архитектурных решений
 │   ├── features/                      # Описания фич и контрактов API
 │   ├── changes/                       # Изменения и миграции
+│   ├── release/                       # Релизные документы (REL-XXXX)
 │   ├── architecture/                  # Архитектурные решения (ADR)
 │   ├── product.md                     # Описание сервиса с продуктовой точки зрения
 │   ├── structure.md                   # Этот файл: структура репозитория

package/stacks/typescript/spa/structure.md

@@ -8,6 +8,7 @@
 │   ├── templates/                     # Шаблоны для фич/изменений/архитектурных решений
 │   ├── features/                      # Описания UI/UX фич и сценариев
 │   ├── changes/                       # Изменения, миграции, заметки по релизам
+│   ├── release/                       # Релизные документы (REL-XXXX)
 │   ├── architecture/                  # Архитектурные решения (ADR)
 │   ├── product.md                     # Описание SPA с продуктовой точки зрения
 │   ├── structure.md                   # Этот файл: структура репозитория

package/templates/release/REL-0000 - Release Name.md

@@ -0,0 +1,81 @@
+# REL-0000 - Release Name
+
+## Сводка релиза
+
+- **Дата:** YYYY-MM-DD
+- **Предыдущая версия:** vX.Y.Z
+- **Новая версия:** vX.Y.Z
+- **Тип релиза:** patch | minor | major
+- **Тег:** vX.Y.Z
+
+## Чеклист предрелизных работ
+
+- [ ] Активная ветка: `main` или `master`
+- [ ] Все изменения закоммичены (`git status` чистый)
+- [ ] Версии в манифестах синхронизированы с тегом релиза
+- [ ] Форматирование проходит успешно
+- [ ] Линт проходит успешно
+- [ ] Компиляция/типизация проходит успешно
+- [ ] Сборка проходит успешно
+- [ ] Dry-run публикации прошёл успешно (если применимо)
+- [ ] Публикационное окружение и credentials проверены
+
+## Черновик Changelog для текущей версии
+
+### Features
+
+- ...
+
+### Fixes
+
+- ...
+
+### Refactor / Chore
+
+- ...
+
+### Docs / Tests / Build
+
+- ...
+
+### Breaking Changes (если есть)
+
+- ...
+
+## План действий (стеко-ориентированный)
+
+### TypeScript / Node / Bun
+
+1. Обновить версии в `package.json` (и package-манифестах, если monorepo).
+2. Выполнить quality gate (`format`, `lint`, `typecheck`, `test`, `build`).
+3. Проверить dry-run публикации (`npm publish --dry-run` или `bun publish --dry-run`).
+4. Создать тег релиза и отправить его в origin.
+5. Выполнить реальную публикацию в registry.
+
+### Python
+
+1. Обновить версию в `pyproject.toml` (и пакетах monorepo).
+2. Выполнить quality gate (`format`, `lint`, `typecheck`, `test`).
+3. Собрать артефакты (`python -m build`) и проверить (`twine check dist/*`).
+4. Создать тег релиза и отправить его в origin.
+5. Опубликовать пакет (`twine upload dist/*` или эквивалент).
+
+### Другое / Custom
+
+1. Зафиксировать команды из `tech.md` и `README.md`.
+2. Проверить dry-run и каналы публикации, применимые к стеку.
+3. Выполнить публикацию по внутреннему release pipeline.
+
+## Блокеры и риски
+
+- [ ] Блокер 1: ...
+- [ ] Блокер 2: ...
+
+## Команды для публикации (заполняется по результатам аудита)
+
+```bash
+# Пример (адаптируется под стек проекта)
+# git tag vX.Y.Z
+# git push origin vX.Y.Z
+# npm publish
+```