project-bootstrap

Files (28)

• README.md
• README.ru.md
• SKILL.md
• hero-dark.svg · assets/
• hero-light.svg · assets/
• AGENTS.md.tmpl · assets/templates/
• MEMORY.md.tmpl · assets/templates/
• SESSION_HANDOFF.md.tmpl · assets/templates/
• SKILL.md.tmpl · assets/templates/
• YYYY-MM-DD.md.tmpl · assets/templates/
• agent-persona.md.tmpl · assets/templates/
• api-config.example.tmpl · assets/templates/
• command.md.tmpl · assets/templates/
• general-rule.md.tmpl · assets/templates/
• nda-anonymization.md.tmpl · assets/templates/
• opencode-agent.md.tmpl · assets/templates/
• plan.md.tmpl · assets/templates/
• rule.md.tmpl · assets/templates/
• script.py.tmpl · assets/templates/
• script.sh.tmpl · assets/templates/
• grace-anchors.md · references/
• model-profiles.md · references/
• operational-rules.md · references/
• playbook.md · references/
• variant-e-structure.md · references/
• workflow-patterns.md · references/
• classify_project.sh · scripts/
• verify-handoff-gate.sh · scripts/

SKILL.md (first lines)

# project-bootstrap v2.2.0

Создаёт агентскую инфраструктуру с адаптацией под тип проекта, модель и сложность.
**Variant E + GRACE-якоря** — правила неизбежны: в преамбуле (primacy) и closing anchors (recency).

**Быстрый старт:** `bash scripts/classify_project.sh` → классификация → выбор шаблона → генерация → contradiction check → двойной аудит.

## TL;DR (minimum path)

**project-bootstrap = ДОМ для агента.** Создаёт AGENTS.md (Variant E: правила в преамбуле + closing anchors), SESSION_HANDOFF.md, .gitignore, `.agents/memory/MEMORY.md`, rules. Адаптация под тип (ops/code/agent/content) и модель (DeepSeek/GLM/Qwen/universal).

**Это точка входа.** После bootstrap: план спринта → `wave-spec`; нужно ≥2 моделей → `multi-model-orchestration`.

**Не использовать** для мелких правок/аудита/уже настроенного проекта (там режим расширения).

**Next step (вставить в сгенерированный AGENTS.md в Фазе 6)** — роутер-таблица, чтобы владелец видел навигацию в файле проекта:

| Хочу… | Скилл |
|---|---|
| Новый проект / настроить среду | project-bootstrap |
| Спланировать и сделать спринт (волну) | wave-spec |
| Обсудить / отревьюить 2+ моделями | multi-model-orchestration |

---

## Workflow

### Фаза 0: Классификация проекта

1. **Запусти классификатор:**
   ```bash
   bash scripts/classify_project.sh <project_dir>
   ```
2. **Прочитай вывод** — JSON с полями: `type`, `complexity`, `variant`, `model_profile`.
3. **Проверь существующий AGENTS.md:** `ls AGENTS.md 2>/dev/null` — если найден → **режим расширения** (не перезаписывать, дополнять).

**Типы проектов и приоритет гибридов** (ops > code > agent > content):

| Тип | Сигналы | Шаблон |
|-----|---------|--------|
| `ops` / `ops-code` | Docker, SSH, .env, nginx, продакшен-риски | Variant E полный (преамбула + чеклист + IF-THEN) |
| `code` / `code-content` | Исходники (py/ts/js), тесты, CI/CD | Variant E + GRACE-якоря |
| `agent` | Скиллы, агенты, промпты, модели | Variant E + модельно-специфичные CLOSING ANCHORS |
| `content` | Статьи, briefs, Excel, интеграции | Облегчённый: преамбула без тех. правил |
| `undetermined` | <3 файлов, нет AGENTS.md | Базовый шаблон с предложением доработать |

**Шкала сложности:**
- `TRIVIAL` — <3 файлов, нет AGENTS.md → простой шаблон, без VS-architect.
- `MODERATE` — 3-20 файлов или есть AGENTS.md → стандартный workflow.
- `UNCERTAIN` — >20 файлов, нестандартная структура → полный анализ + VS-architect.

**Режим расширения** (AGENTS.md существует):
1. Прочитай существующий AGENTS.md и MEMORY.md.
2. Определи текущую структуру — какие модули уже есть.
3. Примени Фазу 1 только к новым требованиям.
4. В Фазе 2 определи, что добавить (не дублировать).
5. При генерации сохрани существующие файлы, дополни AGENTS.md, создай только новое.
6. В сводке: что было, что добавлено.

---

### Фаза 1: Анализ «тёмных пятен»

Определи, что нужно уточнить ИЗВНЕ (не из памяти модели):

**1a. Внешние инструменты, API и технологии**
- webfetch/websearch: `"<name> best practices 2025 2026"`, `"<name> common pitfalls"`.
- **Не ищи CLI-синтаксис** для не-CLI-инструментов.
- Собери данные с источником: `<!-- source: https://..., YYYY-MM-DD -->`.
- Занеси в MEMORY.md → «Инструменты и ресурсы».

**1b. Существующие проекты**
- `glob ../**/.agents/memory/MEMORY.md` — известные грабли, процедуры.
- Если есть `.opencode/` — просканируй `.opencode/agents/` (не дублируй).

**1c. API и протоколы**
- webfetch документации: эндпоинты, аутентификация, лимиты.
- Занеси в MEMORY.md с источником.

**Decision Framework** — выбери архитектурные решения:

| Ситуация | Решение |
|----------|---------|
| Частая/защищённая операция | MCP (упомянуть в AGENTS.md) |
| Редкая/сложная операция | CLI-команда (commands/) |
| Цепочка действий | Скрипт в skills/*/scripts/ |
| Повторяемый workflow | Skill с SKILL.md |
| Разнотемпературные агенты | `.opencode/agents/` с model+temp |
| Аналитический проект | Multi-model cross-validation |
| Adversarial-проверка | review-агент + цикл review→fix |
| NDA/PII | rules/nda-anonymization.md |
| Бинарные форматы (DOCX, PDF) | scripts/ для экстракции |
| Методология >50 строк | `.agents/memory/<topic>-research.md` |

---

### Фаза 2: Определение структуры

На основе classified-типа и задачи определи модули `.agents/`:

| Модуль | Когда нужен |
|--------|-----------|
| `memory/MEMORY.md` | **Всегда** |
| `rules/general.md` | **Всегда** |
| `rules/*.md` | Повторяемые операции, безопасность |
| `.opencode/agents/` | Сабагенты с model/temperature |
| `agents/` | Role-play персоны |
| `commands/` | Повторяемые /-команды |
| `skills/` | Workflow из нескольких шагов |
| `skills/*/scripts/` | Детерминированные операции |
| `.agents/scripts/` | Утилиты для >1 скилла |
| `docs/` | Формальная спецификация (SPEC/PRD) |

**Выбор варианта AGENTS.md** — см. `references/variant-e-structure.md`:
- `variant-e-full` → полная преамбула + чеклист + closing anchors (DeepSeek).
- `variant-e-grace` → Variant E + GRACE-якоря в кодовых файлах.
- `variant-e-model` → модельно-специфичные closing anchors.
  - **Multi-model project type (3 operational rules):** если classify_project.sh детектит multi-model signals (orca orchestration, dispatch --inject, worker_done в контексте) → обязательно включить operational rules из `references/operational-rules.md` через `${OPERATIONAL_RULES_MULTI_MODEL}` placeholder в преамбуле + `${OPERATIONAL_RULES_RECENCY}` в closing anchors.
- `lightweight` → облегчённая преамбула без технических правил.

From dimkurilo/opencode-skills, MIT.

More from dimkurilo/opencode-skills