@jakerdy/agentica 0.0.2

package/stacks/python/gui/tech.md

@@ -0,0 +1,29 @@
+# Technology Stack
+
+В этом разделе описывается технологический стек, используемый в этом проекте, и принципы по подбору библиотек и инструментов.
+
+## Базовые технологии
+- Python 3.13+
+- `pyproject.toml` + hatchling (или совместимый backend)
+- Ruff — линтинг/форматирование
+- MyPy — типизация
+- Pytest — тестирование
+
+## GUI
+- PySide6 / Qt — основной UI toolkit (или другой выбранный фреймворк)
+- Чёткое разделение UI и бизнес-логики
+- Асинхронность (если нужно): asyncio + аккуратная интеграция с event loop UI
+
+## Non-goals
+- Не смешиваем UI-код и доменную логику в одном модуле.
+- Не добавляем асинхронность "везде" без причины.
+
+## Качество и проверки
+- Format: `ruff format .`
+- Lint: `ruff check .`
+- Typecheck: `mypy .`
+- Tests: `pytest`
+
+## Зависимости
+- UI toolkit выбираем один (Qt/PySide6 или альтернативу) и фиксируем решение.
+- Зависимости для графики/медиа добавляем только при наличии сценариев и тестовых примеров.

package/stacks/python/lib/product.md

@@ -0,0 +1,41 @@
+# Project Name
+
+Библиотека на Pytohn для ...
+
+## Цели проекта
+
+- Цель 1: ...
+- Цель 2: ...
+- Цель 3: ...
+
+## Портрет целевого пользователя
+
+Идеальный пользователь — это:
+
+- Профиль 1: ...
+- Профиль 2: ...
+- Профиль 3: ...
+
+## Проблемы, которые решает проект
+
+- Проблема 1: ...
+- Проблема 2: ...
+- Проблема 3: ...
+
+## Ключевые функции
+
+- Функция 1: ...
+- Функция 2: ...
+- Функция 3: ...
+
+## Конкуренты и аналоги
+
+- Конкурент 1: ...
+- Конкурент 2: ...
+- Конкурент 3: ...
+
+## Ресурсы и ссылки
+
+- Ресурс 1: ...
+- Ресурс 2: ...
+- Ресурс 3: ...

package/stacks/python/lib/structure.md

@@ -0,0 +1,34 @@
+# Структура проекта
+
+Проект организован следующим образом:
+
+```
+.
+├── .agentica/                         # Документы и артефакты Agentica для этого проекта
+│   ├── templates/                     # Шаблоны для фич/изменений/архитектурных решений
+│   ├── features/                      # Описания фич (контракты, примеры, UX)
+│   ├── changes/                       # Изменения, миграции, заметки по версиям
+│   ├── architecture/                  # Архитектурные решения (ADR)
+│   ├── product.md                     # Описание проекта с продуктовой точки зрения
+│   ├── structure.md                   # Этот файл: структура репозитория
+│   └── tech.md                        # Технический стек, принципы и инструменты
+├── .vscode/                           # Настройки VS Code
+├── src/                               # Исходный код
+│   ├── <package_name>/                # Основной Python пакет (библиотека)
+│   │   ├── __init__.py                # Точка входа пакета
+│   │   ├── py.typed                   # Маркер типизированного пакета (если библиотека экспортирует типы)
+│   │   ├── module1.py                 # Пример модуля
+│   │   └── ...                        # Другие модули
+│   └── main.py                        # Пример использования библиотеки рядом с пакетом
+├── tests/                             # Тесты (unit/integration), если есть
+├── scripts/                           # Автоматизация (генерация, публикация, утилиты)
+├── README.md                          # Документация библиотеки
+└── pyproject.toml                     # Зависимости и конфигурация инструментов
+```
+
+## Правила структуры
+
+- Публичный API библиотеки экспортируется из `<package_name>/__init__.py`.
+- `src/main.py` — короткий пример использования, без production-логики.
+- `tests/` по структуре зеркалит `<package_name>/`.
+- Архитектурные решения фиксируются в `.agentica/architecture/`.

package/stacks/python/lib/tech.md

@@ -0,0 +1,30 @@
+# Technology Stack
+
+В этом разделе описывается технологический стек, используемый в этом проекте, и принципы по подбору библиотек и инструментов.
+
+## Базовые технологии
+- Python 3.13+
+- Packaging: `pyproject.toml` + hatchling (или совместимый backend)
+- Ruff — линтинг/форматирование
+- MyPy — строгая типизация
+- Pytest — тестирование
+
+## Библиотеки (Python)
+- Явная публичная API-поверхность
+- Типы везде, где это оправдано
+- Минимум runtime-зависимостей
+- Чёткое разделение: core (логика) / adapters (I/O)
+
+## Non-goals
+- Не тащим тяжёлые зависимости ради удобства импорта/синтаксиса.
+- Не экспортируем внутренние модули как часть публичного API.
+
+## Качество и проверки
+- Format: `ruff format .`
+- Lint: `ruff check .`
+- Typecheck: `mypy .`
+- Tests: `pytest`
+
+## Зависимости
+- Runtime-зависимости минимальны; dev-зависимости — в optional group.
+- Версии пинить/ограничивать осознанно, чтобы обновления были предсказуемы.

package/stacks/python/monorepo/product.md

@@ -0,0 +1,41 @@
+# Project Name
+
+Проект на Python для ...
+
+## Цели проекта
+
+- Цель 1: ...
+- Цель 2: ...
+- Цель 3: ...
+
+## Портрет целевого пользователя
+
+Идеальный пользователь — это:
+
+- Профиль 1: ...
+- Профиль 2: ...
+- Профиль 3: ...
+
+## Проблемы, которые решает проект
+
+- Проблема 1: ...
+- Проблема 2: ...
+- Проблема 3: ...
+
+## Ключевые функции
+
+- Функция 1: ...
+- Функция 2: ...
+- Функция 3: ...
+
+## Конкуренты и аналоги
+
+- Конкурент 1: ...
+- Конкурент 2: ...
+- Конкурент 3: ...
+
+## Ресурсы и ссылки
+
+- Ресурс 1: ...
+- Ресурс 2: ...
+- Ресурс 3: ...

package/stacks/python/monorepo/structure.md

@@ -0,0 +1,29 @@
+# Структура проекта
+
+Проект организован следующим образом:
+
+```
+.
+├── .agentica/                         # Документы Agentica на уровне всей монорепы
+│   ├── templates/                     # Общие шаблоны
+│   ├── product.md                     # Описание монорепы с продуктовой точки зрения
+│   ├── structure.md                   # Этот файл: структура репозитория
+│   └── tech.md                        # Общий технический стек и правила
+├── .vscode/                           # Настройки VS Code для монорепозитория
+├── packages/                          # Набор Python пакетов (каждый со своим `pyproject.toml`)
+│   ├── package1/                      # Пример пакета
+│   │   ├── .agentica/                 # Документы Agentica, относящиеся к этому пакету
+│   │   ├── <package_name>/            # Исходный код пакета
+│   │   ├── tests/                     # Тесты пакета
+│   │   └── pyproject.toml             # Зависимости и конфигурация инструментов пакета
+│   └── ...                            # Другие пакеты
+├── notes/                             # Заметки разработчиков (история, идеи, решения)
+├── scripts/                           # Скрипты автоматизации (качество, сборка, релизы)
+├── README.md                          # Главная документация монорепы
+└── pyproject.toml                     # (Опционально) общая конфигурация (ruff/mypy/pytest)
+```
+
+## Правила структуры
+
+- Каждый пакет в `packages/` самодостаточен и может тестироваться/линтиться отдельно.
+- Общие правила качества можно вынести в корневой `pyproject.toml`, но зависимости задаются на уровне пакета.

package/stacks/python/monorepo/tech.md

@@ -0,0 +1,30 @@
+# Technology Stack
+
+В этом разделе описывается технологический стек, используемый в этом проекте, и принципы по подбору библиотек и инструментов.
+
+## Базовые технологии
+- Python 3.13+
+- `pyproject.toml` для каждого пакета
+- hatchling (или другой PEP 517 backend) для сборки
+- Ruff — единые правила линта/формата
+- MyPy — строгая типизация
+- Pytest — тестирование
+
+## Монорепа (Python)
+- Общие правила качества кода на уровне репозитория
+- Пакеты изолированы: зависимости и версии контролируются на уровне пакета
+- CI запускает: ruff, mypy, pytest для всех пакетов
+
+## Non-goals
+- Не делаем общий "shared" пакет без явного API и версионирования.
+- Не допускаем расхождение настроек ruff/mypy между пакетами без причины.
+
+## Качество и проверки
+- Format: `ruff format .`
+- Lint: `ruff check .`
+- Typecheck: `mypy .`
+- Tests: `pytest`
+
+## Зависимости
+- Зависимости добавляются в конкретный пакет, а не в корень.
+- Если нужен общий tooling-конфиг, фиксируем его в корневом `pyproject.toml`.

package/stacks/typescript/cli/product.md

@@ -0,0 +1,41 @@
+# Project Name
+
+TypeScript CLI предназначенное для ...
+
+## Цели проекта
+
+- Цель 1: ...
+- Цель 2: ...
+- Цель 3: ...
+
+## Портрет целевого пользователя
+
+Идеальный пользователь — это:
+
+- Профиль 1: ...
+- Профиль 2: ...
+- Профиль 3: ...
+
+## Проблемы, которые решает проект
+
+- Проблема 1: ...
+- Проблема 2: ...
+- Проблема 3: ...
+
+## Ключевые функции
+
+- Функция 1: ...
+- Функция 2: ...
+- Функция 3: ...
+
+## Конкуренты и аналоги
+
+- Конкурент 1: ...
+- Конкурент 2: ...
+- Конкурент 3: ...
+
+## Ресурсы и ссылки
+
+- Ресурс 1: ...
+- Ресурс 2: ...
+- Ресурс 3: ...

package/stacks/typescript/cli/structure.md

@@ -0,0 +1,34 @@
+# Структура проекта
+
+Проект организован следующим образом:
+
+```
+.
+├── .agentica/                         # Документы и артефакты Agentica для этого проекта
+│   ├── templates/                     # Шаблоны для фич/изменений/архитектурных решений
+│   ├── features/                      # Описания фич (команды, UX, контракты)
+│   ├── changes/                       # Журнал изменений (breaking changes, миграции)
+│   ├── architecture/                  # Архитектурные решения (ADR)
+│   ├── product.md                     # Описание CLI с продуктовой точки зрения
+│   ├── structure.md                   # Этот файл: структура репозитория
+│   └── tech.md                        # Технический стек, принципы и инструменты
+├── .vscode/                           # Настройки VS Code
+├── src/                               # Исходный код CLI
+│   ├── index.ts                       # Главная точка входа приложения (wiring)
+│   ├── commands/                      # Подкоманды/handler'ы
+│   └── ...                            # Остальной код (services, utils)
+├── bin/                               # Entrypoints/обёртки для запуска
+├── tests/                             # Тесты (unit/integration)
+├── scripts/                           # Скрипты автоматизации (release, генерация)
+├── README.md                          # Документация и примеры использования
+├── biome.json                         # Линт/форматирование Biome
+├── tsconfig.json                      # Конфигурация TypeScript
+└── package.json                       # Зависимости, скрипты, метаданные пакета
+```
+
+## Правила структуры
+
+- `src/` содержит только runtime-код; без сгенерённых артефактов.
+- Публичный API (если есть) экспортируется через `src/index.ts`.
+- `tests/` по структуре зеркалит `src/`.
+- Архитектурные решения фиксируются в `.agentica/architecture/`.

package/stacks/typescript/cli/tech.md

@@ -0,0 +1,31 @@
+# Technology Stack
+
+В этом разделе описывается технологический стек, используемый в этом проекте, и принципы по подбору библиотек и инструментов.
+
+## Базовые технологии
+- Node.js 20+
+- Bun — рантайм и пакетный менеджер
+- Biome — линтинг и форматирование кода
+- TypeScript — основной язык
+- Bun test — тестирование
+
+## CLI Приложения
+- Commander — парсинг аргументов, help, подкоманды
+- Inquirer — интерактивные промпты
+- Chalk — форматирование текста в терминале
+- Ora — спиннер/прогресс
+- Стандартизированные exit codes и машиночитаемый вывод при необходимости
+
+## Non-goals
+- Не делаем интерактивный TUI, если достаточно обычного CLI.
+- Не дублируем бизнес-логику: CLI — тонкая оболочка над `src/`.
+
+## Качество и проверки
+- Format: `bun format`
+- Lint: `bun lint`
+- Typecheck: `bun typecheck`
+- Tests: `bun test`
+
+## Зависимости
+- Предпочитай стандартную библиотеку Node/TS и маленькие утилиты вместо больших фреймворков.
+- Любая зависимость должна быть оправдана: размер, поддержка, лицензия, безопасность.

package/stacks/typescript/lib/product.md

@@ -0,0 +1,41 @@
+# Project Name
+
+TypeScript библиотека предназначенная для ...
+
+## Цели проекта
+
+- Цель 1: ...
+- Цель 2: ...
+- Цель 3: ...
+
+## Портрет целевого пользователя
+
+Идеальный пользователь — это:
+
+- Профиль 1: ...
+- Профиль 2: ...
+- Профиль 3: ...
+
+## Проблемы, которые решает проект
+
+- Проблема 1: ...
+- Проблема 2: ...
+- Проблема 3: ...
+
+## Ключевые функции
+
+- Функция 1: ...
+- Функция 2: ...
+- Функция 3: ...
+
+## Конкуренты и аналоги
+
+- Конкурент 1: ...
+- Конкурент 2: ...
+- Конкурент 3: ...
+
+## Ресурсы и ссылки
+
+- Ресурс 1: ...
+- Ресурс 2: ...
+- Ресурс 3: ...

package/stacks/typescript/lib/structure.md

@@ -0,0 +1,33 @@
+# Структура проекта
+
+Проект организован следующим образом:
+
+```
+.
+├── .agentica/                         # Документы и артефакты Agentica для этого проекта
+│   ├── templates/                     # Шаблоны для фич/изменений/архитектурных решений
+│   ├── features/                      # Описания фич (контракты API, примеры)
+│   ├── changes/                       # Изменения, миграции, заметки по версиям
+│   ├── architecture/                  # Архитектурные решения (ADR)
+│   ├── product.md                     # Описание библиотеки с продуктовой точки зрения
+│   ├── structure.md                   # Этот файл: структура репозитория
+│   └── tech.md                        # Технический стек, принципы и инструменты
+├── .vscode/                           # Настройки VS Code
+├── src/                               # Исходный код библиотеки
+│   ├── index.ts                       # Точка входа публичного API
+│   ├── internal/                      # Внутренняя реализация (не экспортируется напрямую)
+│   └── ...                            # Прочие модули
+├── tests/                             # Тесты (unit/integration), если есть
+├── scripts/                           # Автоматизация (сборка, публикация, генерация типов)
+├── README.md                          # Документация библиотеки
+├── biome.json                         # Линт/форматирование Biome
+├── tsconfig.json                      # Конфигурация TypeScript
+└── package.json                       # Зависимости, скрипты и `exports`
+```
+
+## Правила структуры
+
+- Публичные импорты идут только через `src/index.ts` и `exports` в `package.json`.
+- `src/internal/` можно менять без breaking changes; наружу не торчит.
+- `tests/` по структуре зеркалит `src/`.
+- Архитектурные решения фиксируются в `.agentica/architecture/`.

package/stacks/typescript/lib/tech.md

@@ -0,0 +1,31 @@
+# Technology Stack
+
+В этом разделе описывается технологический стек, используемый в этом проекте, и принципы по подбору библиотек и инструментов.
+
+## Базовые технологии
+- Node.js 20+
+- Bun — рантайм и пакетный менеджер
+- Biome — линтинг и форматирование кода
+- TypeScript — основной язык
+- Bun test — тестирование (unit/integration)
+
+## Библиотека (TS)
+- ESM-first дизайн
+- Экспорт типов через `.d.ts`
+- Сборка бандла через `bun build` (или совместимый bundler)
+- Явные `exports` в `package.json`
+- Минимальная публичная API-поверхность и стабильная семантика версий
+
+## Non-goals
+- Не публикуем внутренние модули как часть публичного API.
+- Не вводим тяжёлые зависимости ради синтаксического сахара.
+
+## Качество и проверки
+- Format: `bun format`
+- Lint: `bun lint`
+- Typecheck: `bun typecheck`
+- Tests: `bun test`
+
+## Зависимости
+- Предпочитай зависимости без транзитивной "пирамиды" и с хорошей поддержкой.
+- Добавляя dependency, сразу продумывай влияние на API и на размер бандла.

package/stacks/typescript/monorepo/product.md

@@ -0,0 +1,41 @@
+# Project Name
+
+Проект направлен на ...
+
+## Цели проекта
+
+- Цель 1: ...
+- Цель 2: ...
+- Цель 3: ...
+
+## Партрет идеального пользователя
+
+Идеальный пользователь - это:
+
+- Профиль 1: ...
+- Профиль 2: ...
+- Профиль 3: ...
+
+## Проблемы, которые решает проект
+
+- Проблема 1: ...
+- Проблема 2: ...
+- Проблема 3: ...
+
+## Ключевые функции
+
+- Функция 1: ...
+- Функция 2: ...
+- Функция 3: ...
+
+## Конкуренты и аналоги
+
+- Конкурент 1: ...
+- Конкурент 2: ...
+- Конкурент 3: ...
+
+## Ресурсы и ссылки
+
+- Ресурс 1: ...
+- Ресурс 2: ...
+- Ресурс 3: ...

package/stacks/typescript/monorepo/structure.md

@@ -0,0 +1,34 @@
+# Структура проекта
+
+Проект организован следующим образом:
+
+```
+.
+├── .agentica/                         # Документы Agentica на уровне всей монорепы
+│   ├── templates/                     # Шаблоны для фич/изменений/архитектурных решений
+│   ├── product.md                     # Описание проекта с продуктовой точки зрения
+│   ├── structure.md                   # Этот файл: структура репозитория
+│   └── tech.md                        # Технологии, архитектурные принципы, правила
+├── .vscode/                           # Настройки Visual Studio Code
+├── packages/                          # Пакеты монорепозитория
+│   ├── package1/                      # Пример пакета
+│   │   ├── .agentica/                 # Документы Agentica, относящиеся к пакету
+│   │   ├── src/                       # Исходный код пакета
+│   │   ├── tests/                     # Тесты пакета
+│   │   └── ...                        # Прочие файлы пакета (конфиги, assets)
+│   └── ...                            # Другие пакеты
+├── notes/                             # Заметки разработчиков (контекст, история решений)
+├── scripts/                           # Автоматизация (сборка, тесты, релизы, утилиты)
+├── .gitignore                         # Игнорируемые файлы для Git
+├── README.md                          # Главная документация проекта
+├── AGENTS.md                          # Инструкции для агентов (правила и контекст)
+├── tsconfig.json                      # References на пакеты и общие настройки TS
+├── tsconfig.base.json                 # Базовые настройки TypeScript для всех пакетов
+└── package.json                       # Зависимости и скрипты корня монорепы
+```
+
+## Правила структуры
+
+- Каждый пакет в `packages/` самодостаточен: свои зависимости, сборка и тесты.
+- Общий код выносится в отдельный пакет; не делаем скрытых импортов через относительные пути между пакетами.
+- Архитектурные решения уровня всей монорепы фиксируются в `.agentica/architecture/` (если используется).

package/stacks/typescript/monorepo/tech.md

@@ -0,0 +1,47 @@
+# Technology Stack
+
+В этом разделе описывается технологический стек, используемый в этом проекте, и принципы по подбору библиотек и инструментов.
+
+## Базовые технологии
+- Bun — в качестве рантайма и пакетного менеджера
+- Biome — для линтинга и форматирования кода
+- TypeScript — основной язык программирования для всего проекта (backend/frontend/lib/CLI)
+- Tailwind 4 — для стилизации фронтенда
+- Bun test — тестирование (unit/integration/e2e)
+- watcher (Fabio Spampinato) — отслеживание файловой системы
+
+## CLI Приложения
+- Commander - парсинг аргументов, справка, подкоманды
+- Inquirer - для создания диалоговых CLI-приложений
+- Chalk - для покраски текста в терминале
+- Ora - для отображения спиннера в CLI
+
+## Серверные приложения
+- ElysiaJS - основной серверный фреймворк, 
+- Drizzle - для работы с базой данных
+- Zod - для валидации данных
+
+## SPA
+- SolidJS - для разработки фронтенда
+- Solid Primitives - в качестве набора утилит и хуков для SolidJS
+- Vite - для сборки фронтенда, и dev-сервера
+
+## Библиотеки
+- ESM
+- .d.ts
+- сборка в bundle 
+- bun build, c экспортом типов в d.ts файлах
+
+## Non-goals
+- Не делаем "общую папку" с кодом вне пакетов; общий код — отдельным пакетом.
+- Не смешиваем разные форматтеры/линтеры в одной монорепе.
+
+## Качество и проверки
+- Format: `bun format`
+- Lint: `bun lint`
+- Typecheck: `bun typecheck`
+- Tests: `bun test`
+
+## Зависимости
+- Зависимости добавляются в правильный пакет (не в корень без необходимости).
+- Следить за версиями в workspace, чтобы избегать дублирования и конфликтов.

package/stacks/typescript/server/product.md

@@ -0,0 +1,41 @@
+# Project Name
+
+TypeScript server application aimed at ...
+
+## Цели проекта
+
+- Цель 1: ...
+- Цель 2: ...
+- Цель 3: ...
+
+## Портрет целевого пользователя
+
+Идеальный пользователь — это:
+
+- Профиль 1: ...
+- Профиль 2: ...
+- Профиль 3: ...
+
+## Проблемы, которые решает проект
+
+- Проблема 1: ...
+- Проблема 2: ...
+- Проблема 3: ...
+
+## Ключевые функции
+
+- Функция 1: ...
+- Функция 2: ...
+- Функция 3: ...
+
+## Конкуренты и аналоги
+
+- Конкурент 1: ...
+- Конкурент 2: ...
+- Конкурент 3: ...
+
+## Ресурсы и ссылки
+
+- Ресурс 1: ...
+- Ресурс 2: ...
+- Ресурс 3: ...