AI Project Template

Шаблон репозитория для быстрого развертывания AI-агентов и документации в новых проектах.

Что это?

Шаблон с готовой структурой для AI-ориентированной разработки:

• Конфигурация агента — агенты, навыки, workflows и инструмент адаптации для AI-клиентов
• Структура документации — ADR, конвенции, архитектура, гайды
• Настройки CI — настройки для GitLab CI
• HarnessAdapter — инструмент для адаптации конфигурации OpenCode агента под сторонние AI-клиенты (ClaudeCode, KiloCode, Cursor и др.) через символические ссылки

Правила

Не используй как суб-репозиторий. Используй строго как шаблон для дальнейшего развития.

Перепиши и адаптируй инструкции под проект. Чем точнее и конкретнее инструкции, тем качественнее результат.

Не генерируй инструкции через AI. Инструкции — твой инструмент для корректировки поведения.

Сценарий использования

1. Клонируй этот шаблон
2. Запусти AI-агента с инструкцией инициализации (или выполните сами)

   opencode run "Инициализируй этот проект, следуя инструкции @ai_init_workflow.md"
   

3. Агент автоматически настроит всё под проект
   1. Найдёт маркеры-заполнители (<PROJECT>, <FILL>, <CORRECT>)
   2. Проанализирует контекст проекта
   3. Задаст вопросы для заполнения деталей
   4. Переименует директории и заменит заполнители
   5. При необходимости запустит HarnessAdapter для подключения сторонних AI-клиентов

---

Структура после инициализации

YourProjectName/
├── .opencode/                   # Конфигурация AI-агента
│   ├── agents/                  # Суб-агенты и режимы
│   ├── skills/                  # Навыки агента
│   ├── plans/                   # Временная рабочая область
│   └── opencode.json            # Настройки AI-клиента OpenCode
├── YourProjectName.Docs/        # Документация проекта
│   ├── ADR/                     # Архитектурные решения
│   ├── Architecture/            # Техническая архитектура
│   ├── Conventions/             # Конвенции проекта
│   ├── GameFeatures/            # Игровые механики
│   └── Guides/                  # Инструкции
├── YourProjectName.Unity/       # Unity проект (если есть)
├── YourProjectName.Backend/     # Бэкенд (если есть)
├── YourProjectName.Tools/       # Внешние инструменты
├── YourProjectName.Devops/      # Настройки для GitLab CI
└── AGENTS.md                    # Основные инструкции для агента

---