@jakerdy/agentica 0.0.3 → 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +69 -56
  2. package/package.json +4 -9
  3. package/prompts/commit.prompt.md +2 -0
  4. package/prompts/release.prompt.md +19 -7
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Agentica
2
2
 
3
- [![Version](https://img.shields.io/badge/version-0.1.0-blue)](https://github.com/jakerdy/agentica/releases/tag/v0.1.0)
3
+ [![Version](https://img.shields.io/badge/version-0.0.5-blue)](https://github.com/jakerdy/agentica/releases/tag/v0.0.5)
4
4
  [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
5
5
  [![Bun Build](https://img.shields.io/badge/build-bun-orange)](https://bun.sh)
6
6
 
@@ -13,16 +13,16 @@
13
13
 
14
14
  ## Prerequisites
15
15
 
16
- - VSCode 1.109.0+
16
+ - [VSCode](https://code.visualstudio.com/) 1.109.0+
17
17
  - GitHub Copilot
18
- - Bun 1.3+ / Node.js 18+ (для запуска CLI)
19
- - Context7 (`Upstash.context7-mcp`) — опционально
18
+ - [Bun](https://bun.com/docs/installation) 1.3+ или [Node.js](https://nodejs.org/en/download) 18+ (для запуска CLI)
19
+ - Расширение Context7 (`Upstash.context7-mcp`) — опционально
20
20
 
21
21
  ## Quick Start
22
22
 
23
23
  ```bash
24
24
  # Запускаем без установки
25
- npx @jakerdy/agentica init typescript/cli MyProject
25
+ bunx @jakerdy/agentica init typescript/cli MyProject
26
26
 
27
27
  # Открываем в VSCode
28
28
  cd MyProject && code .
@@ -44,6 +44,35 @@ cd MyProject && code .
44
44
  - Прочие важные детали
45
45
  ```
46
46
 
47
+ ## CLI
48
+
49
+ Чтобы было проще интегрировать Agentica в ваш проект, был создан небольшой, но удобный CLI.
50
+
51
+ Agentica CLI поддерживает два формата запуска `init`:
52
+ - **Позиционный (основной):** `agentica init <stack> [targetPath]`
53
+ - **Через опции (совместимость):** `agentica init --stack <type> [--out <path>]`
54
+
55
+ ### Основные команды
56
+
57
+ ```bash
58
+ # Инициализация Agentica в текущей папке
59
+ agentica init typescript/cli
60
+
61
+ # Инициализация с созданием новой папки проекта
62
+ agentica init typescript/spa MyProject
63
+
64
+ # То же через опции (режим совместимости)
65
+ agentica init --stack typescript/spa --out MyProject
66
+
67
+ # Показать доступные шаблоны стеков
68
+ agentica stacks
69
+
70
+ # Справка по CLI
71
+ agentica --help
72
+ agentica init --help
73
+ ```
74
+
75
+
47
76
  ## Мотивация
48
77
 
49
78
  Agentica был создан в ходе мучительного поиска "идеального" инструмента для работы с агентными системами.
@@ -161,20 +190,20 @@ Agentica строго разделяет уровни ответственнос
161
190
 
162
191
  Все команды вызываются через `/agentica.<command>`. Аргументы опциональны - агент постарается вывести их из контекста, но явное указание надежнее.
163
192
 
164
- | Команда | Аргументы | Назначение |
165
- | :---------- | :-------- | :---------------------------------------------------- |
166
- | `init` | `--lang`, | Инициализация и настройка проекта |
167
- | `architect` | `--name` | Архитектурная спецификация (`AR-XXXX`) |
168
- | `reverse` | `--name` | Reverse Engineering по существующему коду (`AR-XXXX`) |
169
- | `create` | `--name` | Спецификация новой фичи (`FT-XXXX`) |
170
- | `change` | `--name` | Спецификация изменений (`CH-XXXX`) |
171
- | `tasks` | `--id` | Декомпозиция спеки на задачи |
172
- | `implement` | `--id` | Написание кода по задачам |
173
- | `validate` | `--id` | Семантическая и техническая приемка |
174
- | `commit` | --- | Безопасный коммит staged-изменений |
175
- | `release` | `--type` | Подготовка релиза (`REL-XXXX`) и черновика changelog |
176
- | `readme` | `--id` | Генерация документации |
177
- | `refactor` | --- | Улучшение кода без смены API |
193
+ | Команда | Аргументы | Назначение |
194
+ | :---------- | :-------------- | :---------------------------------------------------- |
195
+ | `init` | `--lang`, | Инициализация и настройка проекта |
196
+ | `architect` | `--name` | Архитектурная спецификация (`AR-XXXX`) |
197
+ | `reverse` | `--name` | Reverse Engineering по существующему коду (`AR-XXXX`) |
198
+ | `create` | `--name` | Спецификация новой фичи (`FT-XXXX`) |
199
+ | `change` | `--name` | Спецификация изменений (`CH-XXXX`) |
200
+ | `tasks` | `--id` | Декомпозиция спеки на задачи |
201
+ | `implement` | `--id` | Написание кода по задачам |
202
+ | `validate` | `--id` | Семантическая и техническая приемка |
203
+ | `commit` | `--skip-checks` | Коммит с проверками безопасности |
204
+ | `release` | `--type` | Подготовка релиза (`REL-XXXX`) и черновика changelog |
205
+ | `readme` | `--id` | Генерация документации |
206
+ | `refactor` | --- | Улучшение кода без смены API |
178
207
 
179
208
  ---
180
209
 
@@ -193,8 +222,10 @@ Agentica строго разделяет уровни ответственнос
193
222
 
194
223
  ```text
195
224
  /agentica.init --lang TypeScript
196
- Сделай CLI для импорта CSV. Нужны команды import, validate.
197
- Используй commander и chalk.
225
+
226
+ Проект посвящён разработке CLI-инструментов для управления задачами. Основные функции включают создание, обновление и удаление задач, а также интеграцию с календарём. Важно обеспечить поддержку плагинов и расширений в будущем.
227
+
228
+ Оснвной стек: TypeScript, Node.js, Commander.js для CLI
198
229
  ```
199
230
  *Что происходит:* Агент создает структуру `.agentica/`, заполняет `tech.md` и `structure.md` под ваш запрос, готовит промпты.
200
231
 
@@ -254,58 +285,40 @@ Agentica строго разделяет уровни ответственнос
254
285
  Восстанови карту модулей, просканируй entry-points.
255
286
  Найди циклические зависимости и узкие места в текущей реализации.
256
287
  ```
257
- *Агент просканирует кодовую базу и создаст описание системы "As-Is", подсветив зоны риска и архитектурный долг.*
288
+ *Агент просканирует кодовую базу и создаст описание системы "As-Is" в отдельном `AR-XXXX` документе, подсветив зоны риска и архитектурный долг.*
258
289
 
259
290
  ### 6. Документация
260
- ```text
261
- /agentica.readme --id FT-0012
262
- Сделай короткую доку для разработчиков с примерами.
263
- ```
264
-
265
- ### 7. Подготовка релиза
266
291
 
267
- Используйте, когда нужно пройти предрелизный аудит, собрать changelog из коммитов и подготовить план публикации.
292
+ Когда работа над фичей закончена, и нужно быстро сгенерировать понятную документацию:
268
293
 
269
294
  ```text
270
- /agentica.release --type minor
271
- Собери релиз для текущего состояния main и подготовь команды публикации.
295
+ /agentica.readme --id FT-0012
296
+ Сделай короткую доку для разработчиков с примерами и описанием архитектуры нового решения.
272
297
  ```
273
- *Агент проверит ветку (`main/master`), рассчитает новую версию (patch/minor/major), соберёт черновик changelog с последнего тега, пройдёт предрелизный checklist и создаст `REL-XXXX` документ.*
274
298
 
275
- ### 8. Безопасный коммит
299
+ ### 7. Коммит "по богатому"
276
300
 
277
301
  Используйте, когда нужно автоматически собрать staged-изменения, проверить их на мусор/секреты и создать качественное сообщение коммита.
278
302
 
303
+ Или просто используйте его всегда, когда собираетесь коммитить. Это просто, довольно быстро, а плюсы огромныe:
304
+ - Детальные сообщения которые муторно и лениво писать руками
305
+ - Гарантия, что в коммит не попадет мусор или секреты
306
+ - На основе истории можно будет делать качественные changelog'и и релизы, а не "misc updates" и "fixes"
307
+
279
308
  ```text
280
309
  /agentica.commit
281
310
  Подготовь commit для текущих изменений.
282
311
  ```
283
312
  *Агент добавит изменения в stage, предупредит о потенциальных артефактах (`.exe`, `.dll`, `.tgz` и т.п.), предложит обновить `.gitignore`, сформирует сообщение в формате `<change_type>: <Short Change Description>` + детальное описание и выполнит `git commit`.*
284
313
 
285
- ## CLI
286
-
287
- Чтобы было проще интегрировать Agentica в ваш проект, был создан небольшой, но удобный CLI.
288
-
289
- Agentica CLI поддерживает два формата запуска `init`:
290
- - **Позиционный (основной):** `agentica init <stack> [targetPath]`
291
- - **Через опции (совместимость):** `agentica init --stack <type> [--out <path>]`
314
+ ### 8. Подготовка релиза
292
315
 
293
- ### Основные команды
294
-
295
- ```bash
296
- # Инициализация Agentica в текущей папке
297
- agentica init typescript/cli
298
-
299
- # Инициализация с созданием новой папки проекта
300
- agentica init typescript/spa MyProject
316
+ Используйте, когда нужно пройти предрелизный аудит, собрать changelog из коммитов и подготовить план публикации.
301
317
 
302
- # То же через опции (режим совместимости)
303
- agentica init --stack typescript/spa --out MyProject
318
+ ```text
319
+ /agentica.release --type minor
320
+ Собери релиз для текущего состояния main и подготовь команды публикации.
321
+ ```
322
+ *Агент проверит ветку (`main/master`), рассчитает новую версию (patch/minor/major), соберёт черновик changelog с последнего тега, пройдёт предрелизный checklist и создаст `REL-XXXX` документ.*
304
323
 
305
- # Показать доступные шаблоны стеков
306
- agentica stacks
307
324
 
308
- # Справка по CLI
309
- agentica --help
310
- agentica init --help
311
- ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jakerdy/agentica",
3
- "version": "0.0.3",
3
+ "version": "0.0.5",
4
4
  "description": "Spec-driven framework for agent coding with developer-first approach",
5
5
  "keywords": [
6
6
  "ai",
@@ -16,18 +16,13 @@
16
16
  "license": "MIT",
17
17
  "repository": {
18
18
  "type": "git",
19
- "url": "https://github.com/jakerdy/agentica.git"
20
- },
21
- "bugs": {
22
- "url": "https://github.com/jakerdy/agentica/issues"
19
+ "url": "git+https://github.com/jakerdy/agentica.git"
23
20
  },
21
+ "bugs": "https://github.com/jakerdy/agentica/issues",
24
22
  "homepage": "https://github.com/jakerdy/agentica#readme",
25
23
  "module": "src/index.ts",
26
24
  "main": "dist/cli.js",
27
25
  "type": "module",
28
- "bin": {
29
- "agentica": "./dist/cli.js"
30
- },
31
26
  "files": [
32
27
  "dist",
33
28
  "prompts",
@@ -54,4 +49,4 @@
54
49
  "chalk": "^5.6.2",
55
50
  "commander": "^14.0.3"
56
51
  }
57
- }
52
+ }
package/prompts/commit.prompt.md CHANGED
@@ -47,6 +47,8 @@ $ARGUMENTS
47
47
 
48
48
  ## Фаза 3: Проверка stage на риски
49
49
 
50
+ Если пользователь указал ключ `--skip-checks`, пропусти эту фазу и перейди к генерации commit message.
51
+
50
52
  ### 3.1 Поиск мусорных/артефактных файлов
51
53
 
52
54
  Проверь staged-файлы на признаки артефактов и мусора (например):
package/prompts/release.prompt.md CHANGED
@@ -13,7 +13,7 @@ $ARGUMENTS
13
13
 
14
14
  ## Цель и принцип работы
15
15
 
16
- Твоя задача — подготовить релизный пакет в формате `REL-XXXX`:
16
+ Твоя задача — подготовить релизный пакет в формате `REL-vX.Y.Z`:
17
17
  1. Проверить готовность репозитория к релизу.
18
18
  2. Вычислить новую версию и собрать черновик `Changelog`.
19
19
  3. Сформировать документ релиза по шаблону.
@@ -33,7 +33,7 @@ $ARGUMENTS
33
33
  ## Топология и размещение файлов
34
34
 
35
35
  Документ релиза хранится в:
36
- - `.agentica/release/REL-XXXX - <Release Name>.md`
36
+ - `.agentica/release/REL-vX.Y.Z - <Release Name>.md`
37
37
 
38
38
  Шаблон релиза:
39
39
  - `.agentica/templates/release/REL-0000 - Release Name.md`
@@ -55,9 +55,11 @@ $ARGUMENTS
55
55
  - `minor`
56
56
  - `major`
57
57
  2. На основе предыдущей версии вычисли новую семантическую версию (`X.Y.Z`).
58
- 3. Определи новый release id:
59
- - Найди существующие документы `REL-XXXX` в `.agentica/release/`.
60
- - Новый ID = max + 1.
58
+ 3. Определи новый release id как `REL-vX.Y.Z`.
59
+ 4. Обнови версии в манифестах (но не коммить изменения):
60
+ - `package.json` → `version`
61
+ - `pyproject.toml` → `version`
62
+ - и т.д. по стеку проекта.
61
63
 
62
64
  ## Фаза 3: Сбор changelog по коммитам
63
65
 
@@ -93,7 +95,7 @@ $ARGUMENTS
93
95
  ## Фаза 5: Генерация REL-документа
94
96
 
95
97
  1. Создай новый файл по шаблону:
96
- - `.agentica/release/REL-XXXX - <Release Name>.md`
98
+ - `.agentica/release/REL-vX.Y.Z - <Release Name>.md`
97
99
  2. Заполни:
98
100
  - версию (`previous` → `next`)
99
101
  - дату
@@ -108,7 +110,17 @@ $ARGUMENTS
108
110
  1. Какая версия рассчитана (`from` → `to`).
109
111
  2. Где создан REL-документ.
110
112
  3. Какие проверки пройдены/провалены/неприменимы.
111
- 4. Точный список команд, которые пользователь должен выполнить для публикации релиза.
113
+ 4. Попроси пользователя
114
+
115
+ ## Фаза 7: Помощь в публикации (по запросу)
116
+
117
+ Проведи всю предрелизную подготовку, но не выполняй публикацию. Вместо этого:
118
+ 1. Апнуть версии в манифестах.
119
+ 2. Закоммитить изменения с сообщением `chore(release): prepare vX.Y.Z`.
120
+ 3. Создать тег `vX.Y.Z` и отправить его в origin.
121
+ 4. Обновить Badges в `README.md` (если есть).
122
+ 5. Дописать все изменения из черновика changelog в `CHANGELOG.md` (если есть).
123
+ 6. Написать финальную команду для публикации релиза и дать краткие инструкции по её запуску.
112
124
 
113
125
  ## Требования к качеству
114
126