@bonesofspring/ai-rules 0.2.11 → 0.2.12

package/presets/cursor/php-laravel/commands/task.md

@@ -0,0 +1,53 @@
+---
+name: task
+description: Route a natural-language task through the agent-team pipeline: task-router, pipeline.json, and the first planned specialist.
+---
+
+# Task — единая точка входа (router + pipeline)
+
+Главная команда для постановки задачи. Родительский агент = оркестратор (`agent-team-orchestrator.mdc`). Intake для work-запросов без `/task` — `agent-team-intake.mdc`.
+
+## Аргументы
+
+Всё после `/task` — описание задачи на естественном языке.
+
+Примеры:
+
+- `/task Добавить use case отмены заказа`
+- `/task Handler падает при пустом body — пофикси`
+- `/task CI упал на composer test / composer test в PR`
+- `/task Миграция на новый PHP / обновление Composer-Composer модуля`
+- `/task Покрой unit-тестами OrderService`
+- `/task Напиши changelog для релиза фильтров`
+- `/task Сделай ревью моих изменений в application/`
+- `/task Напиши integration tests для persistence adapter`
+
+## Алгоритм
+
+1. **Slug** — kebab-case из описания (≤48 символов). Создай `.cursor/team/tasks/<slug>/` через **Write** (например сразу `status.json` или пустой placeholder) — **не** через Shell `mkdir` (песочница → `Operation not permitted`).
+2. **Router** — вызови subagent **task-router** с описанием задачи и путём к slug.
+3. **План** — покажи пользователю таблицу из `pipeline.json`: intent, steps, skipped, humanGates.
+4. **Intent retro** — если `intent === "retro"`, выполни `/technical-retro` и **остановись**.
+5. **Старт** — вызови subagent для `pipeline.steps[0].agent`:
+   - передай slug, пути к артефактам, scope из step (если есть);
+   - обнови `status.json`: `pipelineIndex: 0`, `currentAgent`, `state: in_progress`.
+6. **Human gate** — если после текущего шага есть gate в `humanGates` (`after:<agent>`), после завершения агента **остановись** и попроси `/task-continue <slug>` (или `/feature-continue <slug>`).
+
+## Не делать
+
+- Не вызывать developer до router и (если в pipeline) analyst/architect.
+- Не hardcode порядок ролей — только `pipeline.json`.
+- Не пропускать human gate без явного continue.
+
+## Если slug занят
+
+- `awaitingHumanGate` / `state: awaiting_approval` → предложи ревью артефактов или `/task-continue <slug>`.
+- `in_progress` → спроси: продолжить или новый slug.
+
+## Legacy
+
+`/feature-start` и `/feature-continue` остаются совместимыми; для новых задач предпочитай `/task`.
+
+## Metrics
+
+Initialize `metrics.json` before the first invocation with frozen task dimensions and `task_started`; add one `activeAttempts[attemptId]` entry plus `attempt_started` per scheduled agent. On `/task-continue`, append `human_gate_ended` (referencing the stored gate event) before activating the next attempt. Do not calculate durations in agents.

package/presets/cursor/php-laravel/commands/technical-retro.md

@@ -0,0 +1,85 @@
+---
+name: technical-retro
+description: Facilitate a technical retrospective for a period, incident, release, or completed agent-team task slug.
+---
+
+# Техническое ретро
+
+Агент выступает как **нейтральный фасилитатор технической ретроспективы**, а не как ревьюер кода или оценщик людей. Используй skill **`technical-retro`** как основной сценарий.
+
+## Когда включать
+
+- Пользователь просит: «ретро», «техническое ретро», «разбор спринта/итерации», «action items после релиза».
+- После завершения пайплайна команды агентов (`/feature-start` → `/feature-continue`).
+- Есть контекст: период, тема (релиз, инцидент), slug задачи, заметки.
+
+## Входные данные (собрать, не выдумывать)
+
+Запросить при нехватке:
+
+- **Период и фокус**.
+- **Slug задачи** (если ретро по работе команды агентов).
+- **Участники/роли** (если важно).
+- **Ограничения**: время, формат (async vs синхрон).
+
+### Артефакты команды агентов (если есть slug)
+
+Прочитать из репозитория:
+
+- `.cursor/team/tasks/<slug>/pipeline.json`
+- `.cursor/team/tasks/<slug>/brief.md`
+- `.cursor/team/tasks/<slug>/decomposition.md`
+- `.cursor/team/tasks/<slug>/status.json`
+- Git diff / `git status` для изменённых файлов
+
+Не приписывать факты, которых нет в артефактах, diff или сообщении пользователя.
+
+## Принципы фасилитации
+
+- **Безопасность**: процесс и система, не «виноватые».
+- **Конкретика**: от абстракций к наблюдаемым событиям.
+- **Баланс**: позитив и зоны роста.
+- **Action items**: владелец и срок у каждого.
+- **Не смешивать с code review** — развести блоки, если запросили оба.
+
+## Структура сессии (по умолчанию)
+
+1. **Цель и рамки**.
+2. **Сбор фактов**: хорошо / мешало / сюрпризы.
+3. **Группировка тем** (3–7).
+4. **Корневые причины** для 1–2 болезненных тем.
+5. **Эксперименты** (1–3 изменения процесса).
+6. **Action items**: что / владелец / до когда / критерий успеха.
+
+## Блок «Работа агентов» (обязателен при slug)
+
+Если ретро связано с пайплайном `/feature-start`:
+
+| Вопрос | Что фиксировать |
+|--------|-----------------|
+| Router | Ошибка intent, лишние/пропущенные steps в pipeline |
+| Аналитик | Ошибки в assumptions, пропущенные AC, лишние/недостающие таски |
+| Декомпозиция | Неполное покрытие слоёв, неверный порядок, blocked-зависимости |
+| Developer | Scope creep, пропущенные правила, lint/type gaps |
+| Reviewer | Пропущенные дефекты, false positives, качество чеклиста |
+| QA | Покрытие AC тестами, flakiness, пробелы в e2e планах |
+
+**Action items** в этом блоке — на улучшение **промптов, subagents и rules** (не только кода).
+
+## Формат ответа
+
+- Шапка: период, фокус, slug (если есть), допущения.
+- Повестка по этапам.
+- Блок **«Работа агентов»** (если применимо).
+- Темы — буллеты; спорное — **вопросы команде**.
+- **Action items** в конце.
+
+## Ограничения
+
+- Не приписывать цитаты и факты без входа.
+- Не выдавать HR‑рекомендации.
+- Если просят только шаблон — **шаблон повестки** без выдуманного контента.
+
+### Metrics evidence
+
+When `metrics.json` exists, run the local aggregation script and report the cohort, sample size, incomplete artifacts, attribution confidence, active attempt duration, and human-gate wait separately. Do not treat gate wait or malformed ledgers as agent duration.

package/presets/cursor/php-laravel/hooks/README.md

@@ -0,0 +1,12 @@
+# `.cursor/hooks` (preset php-laravel)
+
+| File | Purpose |
+|------|---------|
+| `guard-shell-command.sh` | Destructive git / JS package-manager mismatch; **does not** block `php artisan test / composer test` / `compiler/IDE inspections` / `configured static analysis` / `repo static analysis` |
+| `chain-team-phases.sh` | Auto-chain pipeline steps on `subagentStop` |
+
+See root `hooks.json` for registration (`beforeShellExecution`, `subagentStop`).
+
+## Optional cookbook
+
+See `hooks/examples/README.md` — secret-guard / format-edited / test-on-save. **Not** in default `hooks.json`.