@bonesofspring/ai-rules 0.2.1 → 0.2.3

package/scripts/README.md

@@ -1,84 +0,0 @@
-# Preset validation scripts
-
-Static regression checks for `presets/cursor/next` and `presets/claude/next`.
-
-## Quick start
-
-```bash
-cd packages/ai-rules
-
-# Full static validation (no LLM)
-./scripts/validate-preset.sh
-
-# + init smoke into temp dirs
-./scripts/validate-preset.sh --init-smoke
-
-# Validate golden-prompts.json (agent names, schema)
-./scripts/validate-preset.sh --check-golden
-```
-
-Or via npm:
-
-```bash
-yarn validate
-yarn validate:init
-yarn validate:golden
-```
-
-## Router regression (manual + semi-auto)
-
-Golden prompts live in `golden-prompts.json` — one case per `task-router` intent (+ light/full variants).
-
-### 1. Print checklist
-
-```bash
-./scripts/validate-preset.sh --print-golden
-```
-
-### 2. Run in Cursor (fresh chat each)
-
-For each row, run `/task <prompt>`. After **task-router** finishes, copy `pipeline.json` from `.cursor/team/tasks/<slug>/` to:
-
-```
-scripts/regression-results/<id>.json
-```
-
-Use the `id` from golden-prompts (e.g. `feature-standard.json`).
-
-### 3. Compare outputs
-
-```bash
-mkdir -p scripts/regression-results
-./scripts/validate-preset.sh --check-golden --compare-pipeline scripts/regression-results/
-```
-
-The compare step checks:
-
-- `intent`, `firstAgent`
-- `requiredSequence` (ordered subsequence — extra steps allowed)
-- `mustNotInclude`
-- `stepConstraints` (`skipIf`)
-- `humanGates`
-
-`profile` mismatches are warnings (router may omit explicit profile when default applies).
-
-### 4. Commit baseline (optional)
-
-When router behavior intentionally changes, update `golden-prompts.json` and refresh committed `regression-results/` snapshots.
-
-## Files
-
-| File | Purpose |
-|------|---------|
-| `validate-preset.sh` | Main validator |
-| `preset-manifest.json` | Always-on lists, rule pairs, UI glob rules, BUGBOT sync |
-| `golden-prompts.json` | Expected router outcomes per intent |
-| `regression-results/.gitkeep` | Placeholder for manual run outputs |
-
-## What is NOT automated
-
-- LLM routing quality (flaky by model/temperature)
-- Behavioral golden tasks on a real Next.js repo
-- Token cost of path-scoped rules on real file edits
-
-Those stay manual / scheduled regression on a dogfood project.

package/scripts/golden-prompts.json

@@ -1,276 +0,0 @@
-{
-  "version": 1,
-  "description": "Golden prompts for task-router regression. Run manually via /task or semi-auto with validate-preset.sh --check-golden.",
-  "prompts": [
-    {
-      "id": "feature-standard",
-      "prompt": "Добавь фильтр по дате в Order History",
-      "intent": "feature",
-      "profile": "standard",
-      "firstAgent": "task-analyst",
-      "requiredSequence": [
-        "task-analyst",
-        "feature-developer",
-        "build-verifier",
-        "code-reviewer"
-      ],
-      "mustInclude": ["build-verifier"],
-      "mustNotInclude": [],
-      "humanGates": ["after:task-analyst"],
-      "notes": "Default feature path; qa-tester optional unless e2e AC explicit."
-    },
-    {
-      "id": "feature-full",
-      "prompt": "Реализуй оплату картой: UI, API сервис, store и e2e сценарии checkout",
-      "intent": "feature",
-      "profile": "full",
-      "firstAgent": "task-analyst",
-      "requiredSequence": [
-        "task-analyst",
-        "feature-developer",
-        "build-verifier",
-        "code-reviewer",
-        "qa-tester"
-      ],
-      "mustInclude": ["build-verifier", "qa-tester"],
-      "mustNotInclude": [],
-      "humanGates": ["after:task-analyst"],
-      "notes": "Cross-layer + e2e AC → full profile with qa-tester."
-    },
-    {
-      "id": "feature-light",
-      "prompt": "Исправь typo в тексте кнопки Submit в OrderHistoryButton — один файл app/src/ui/components/OrderHistoryButton/OrderHistoryButton.tsx, AC: label «Отправить»",
-      "intent": "feature",
-      "profile": "light",
-      "firstAgent": "feature-developer",
-      "requiredSequence": ["feature-developer", "build-verifier"],
-      "mustInclude": ["build-verifier"],
-      "mustNotInclude": ["task-analyst"],
-      "humanGates": [],
-      "notes": "Explicit single-file AC → light; skip analyst."
-    },
-    {
-      "id": "bugfix-standard",
-      "prompt": "Order History падает при пустом списке — пофикси regression",
-      "intent": "bugfix",
-      "profile": "standard",
-      "firstAgent": "debugger",
-      "requiredSequence": [
-        "debugger",
-        "feature-developer",
-        "build-verifier",
-        "code-reviewer"
-      ],
-      "mustInclude": ["debugger", "build-verifier"],
-      "mustNotInclude": [],
-      "humanGates": [],
-      "stepConstraints": [
-        {
-          "agent": "feature-developer",
-          "skipIf": "debugger.fixed"
-        }
-      ],
-      "notes": "Bugfix standard; qa-tester(regression) optional per router."
-    },
-    {
-      "id": "bugfix-light",
-      "prompt": "Просто поправь null-check в mapper — один файл, явный AC, без архитектурного риска",
-      "intent": "bugfix",
-      "profile": "light",
-      "firstAgent": "debugger",
-      "requiredSequence": ["debugger", "build-verifier"],
-      "mustInclude": ["build-verifier"],
-      "mustNotInclude": ["task-analyst", "code-reviewer"],
-      "humanGates": [],
-      "notes": "Light bugfix may skip developer when debugger.fixed."
-    },
-    {
-      "id": "ci-fix",
-      "prompt": "CI упал на type-check в PR — красный пайплайн",
-      "intent": "ci-fix",
-      "profile": "standard",
-      "firstAgent": "ci-investigator",
-      "requiredSequence": [
-        "ci-investigator",
-        "feature-developer",
-        "build-verifier",
-        "code-reviewer"
-      ],
-      "mustInclude": ["ci-investigator", "build-verifier"],
-      "mustNotInclude": ["task-analyst"],
-      "humanGates": [],
-      "stepConstraints": [
-        {
-          "agent": "feature-developer",
-          "skipIf": "ci-investigator.resolved"
-        }
-      ]
-    },
-    {
-      "id": "migration",
-      "prompt": "Миграция HTTP-клиента на fetch — upgrade major version",
-      "intent": "migration",
-      "profile": "standard",
-      "firstAgent": "task-analyst",
-      "requiredSequence": [
-        "task-analyst",
-        "migration-specialist",
-        "feature-developer",
-        "build-verifier",
-        "code-reviewer"
-      ],
-      "mustInclude": ["migration-specialist", "build-verifier"],
-      "mustNotInclude": [],
-      "humanGates": ["after:migration-specialist"]
-    },
-    {
-      "id": "perf-audit",
-      "prompt": "Страница Order History медленно грузится — perf audit bundle и LCP",
-      "intent": "perf-audit",
-      "profile": "light",
-      "firstAgent": "performance-auditor",
-      "requiredSequence": ["performance-auditor"],
-      "mustInclude": ["performance-auditor"],
-      "mustNotInclude": ["feature-developer", "build-verifier"],
-      "humanGates": []
-    },
-    {
-      "id": "a11y",
-      "prompt": "Проверь a11y формы логина — WCAG и keyboard navigation",
-      "intent": "a11y",
-      "profile": "standard",
-      "firstAgent": "task-analyst",
-      "requiredSequence": [
-        "task-analyst",
-        "feature-developer",
-        "build-verifier",
-        "accessibility-reviewer",
-        "code-reviewer"
-      ],
-      "mustInclude": ["accessibility-reviewer", "build-verifier"],
-      "mustNotInclude": [],
-      "humanGates": ["after:task-analyst"]
-    },
-    {
-      "id": "review-only",
-      "prompt": "Сделай ревью моих изменений в store/orders — review MR diff",
-      "intent": "review-only",
-      "profile": "light",
-      "firstAgent": "code-reviewer",
-      "requiredSequence": ["code-reviewer"],
-      "mustInclude": ["code-reviewer"],
-      "mustNotInclude": ["feature-developer", "build-verifier", "task-analyst"],
-      "humanGates": []
-    },
-    {
-      "id": "test-only",
-      "prompt": "Покрой тестами модуль payments — unit и e2e, без изменения прод-кода",
-      "intent": "test-only",
-      "profile": "standard",
-      "firstAgent": "task-analyst",
-      "requiredSequence": ["task-analyst", "qa-tester"],
-      "mustInclude": ["qa-tester"],
-      "mustNotInclude": ["feature-developer"],
-      "humanGates": ["after:task-analyst"]
-    },
-    {
-      "id": "unit-only-plan",
-      "prompt": "Покрой unit-тестами mapper payments в api/services",
-      "intent": "unit-only",
-      "profile": "standard",
-      "firstAgent": "unit-test-planner",
-      "requiredSequence": ["unit-test-planner", "unit-test-generator"],
-      "mustInclude": ["unit-test-planner"],
-      "mustNotInclude": ["feature-developer", "qa-tester"],
-      "humanGates": ["after:unit-test-planner"],
-      "notes": "New unit coverage → planner then generator."
-    },
-    {
-      "id": "unit-only-heal",
-      "prompt": "Почини unit тест OrderHistoryMapper.spec.ts — падает после рефактора",
-      "intent": "unit-only",
-      "profile": "standard",
-      "firstAgent": "unit-test-healer",
-      "requiredSequence": ["unit-test-healer"],
-      "mustInclude": ["unit-test-healer"],
-      "mustNotInclude": ["unit-test-planner", "feature-developer"],
-      "humanGates": [],
-      "notes": "Broken existing unit → healer path, no planner gate."
-    },
-    {
-      "id": "e2e-only-plan",
-      "prompt": "Напиши e2e для сценария оплаты — playwright browser test",
-      "intent": "e2e-only",
-      "profile": "standard",
-      "firstAgent": "playwright-test-planner",
-      "requiredSequence": [
-        "playwright-test-planner",
-        "playwright-test-generator"
-      ],
-      "mustInclude": ["playwright-test-planner"],
-      "mustNotInclude": ["feature-developer", "qa-tester"],
-      "humanGates": ["after:playwright-test-planner"]
-    },
-    {
-      "id": "e2e-only-heal",
-      "prompt": "Почини e2e checkout.spec.ts — flaky playwright test",
-      "intent": "e2e-only",
-      "profile": "standard",
-      "firstAgent": "playwright-test-healer",
-      "requiredSequence": ["playwright-test-healer"],
-      "mustInclude": ["playwright-test-healer"],
-      "mustNotInclude": ["playwright-test-planner", "feature-developer"],
-      "humanGates": []
-    },
-    {
-      "id": "docs-only",
-      "prompt": "Напиши changelog для релиза фильтров и migration guide",
-      "intent": "docs-only",
-      "profile": "standard",
-      "firstAgent": "task-analyst",
-      "requiredSequence": ["task-analyst", "tech-writer"],
-      "mustInclude": ["tech-writer"],
-      "mustNotInclude": ["feature-developer", "build-verifier"],
-      "humanGates": ["after:task-analyst"]
-    },
-    {
-      "id": "refactor",
-      "prompt": "Рефакторинг store/orders без изменения поведения — почисти дубли",
-      "intent": "refactor",
-      "profile": "standard",
-      "firstAgent": "task-analyst",
-      "requiredSequence": [
-        "task-analyst",
-        "feature-developer",
-        "build-verifier",
-        "code-reviewer"
-      ],
-      "mustInclude": ["build-verifier"],
-      "mustNotInclude": [],
-      "humanGates": ["after:task-analyst"]
-    },
-    {
-      "id": "spike",
-      "prompt": "Исследуй spike: можно ли перейти на React Server Components для Order History?",
-      "intent": "spike",
-      "profile": "standard",
-      "firstAgent": "task-analyst",
-      "requiredSequence": ["task-analyst", "solution-architect"],
-      "mustInclude": ["solution-architect"],
-      "mustNotInclude": ["feature-developer", "build-verifier"],
-      "humanGates": ["after:solution-architect"]
-    },
-    {
-      "id": "retro",
-      "prompt": "Сделай ретро по задаче order-history-date-filter — postmortem",
-      "intent": "retro",
-      "noPipeline": true,
-      "firstAgent": null,
-      "requiredSequence": [],
-      "mustInclude": [],
-      "mustNotInclude": ["feature-developer", "task-analyst"],
-      "humanGates": [],
-      "notes": "Orchestrator runs /technical-retro; no pipeline.json steps."
-    }
-  ]
-}

package/scripts/preset-manifest.json

@@ -1,72 +0,0 @@
-{
-  "version": 1,
-  "alwaysOnCursor": [
-    "next-app-core.mdc",
-    "code-quality-and-refactoring.mdc",
-    "post-change-lint.mdc",
-    "package-manager.mdc"
-  ],
-  "alwaysOnClaude": [
-    "stack/next-app-core.md",
-    "tooling-and-review/code-quality.md",
-    "tooling-and-review/post-change-lint.md",
-    "tooling-and-review/package-manager.md"
-  ],
-  "alwaysOnMaxBytes": 12288,
-  "rulePairs": [
-    ["architecture-boundaries.mdc", "architecture/architecture-boundaries.md"],
-    ["architecture-boundaries-ui.mdc", "architecture/architecture-boundaries-ui.md"],
-    ["layer-barrel-exports.mdc", "architecture/layer-barrel-exports.md"],
-    ["navigation-router-stack.mdc", "stack/navigation-router.md"],
-    ["navigation-router-ui.mdc", "stack/navigation-router-ui.md"],
-    ["react-ui.mdc", "ui-and-accessibility/react-ui.md"],
-    ["code-review-mr.mdc", "tooling-and-review/code-review-mr.md"],
-    ["agent-team-orchestrator.mdc", "tooling-and-review/agent-team-orchestrator.md"],
-    ["public-imports.mdc", "architecture/public-imports.md"],
-    ["feature-delivery-workflow.mdc", "architecture/feature-delivery-workflow.md"],
-    ["next-app-core.mdc", "stack/next-app-core.md"],
-    ["post-change-lint.mdc", "tooling-and-review/post-change-lint.md"],
-    ["package-manager.mdc", "tooling-and-review/package-manager.md"],
-    ["code-quality-and-refactoring.mdc", "tooling-and-review/code-quality.md"]
-  ],
-  "syncedRootFiles": [
-    {
-      "source": "fragments/BUGBOT.md",
-      "targets": ["presets/cursor/next/BUGBOT.md", "presets/claude/next/BUGBOT.md"]
-    }
-  ],
-  "parityDirs": ["agents", "skills", "team/fixtures"],
-  "uiGlobChecks": [
-    {
-      "id": "architecture-boundaries-no-ui",
-      "file": "architecture-boundaries.mdc",
-      "mustNotMatch": "app/src/ui"
-    },
-    {
-      "id": "architecture-boundaries-ui-scoped",
-      "file": "architecture-boundaries-ui.mdc",
-      "mustMatch": "app/src/ui"
-    },
-    {
-      "id": "layer-barrel-index-only",
-      "file": "layer-barrel-exports.mdc",
-      "mustMatch": "index.ts",
-      "mustNotMatch": "app/src/ui/\\*\\*"
-    },
-    {
-      "id": "navigation-router-stack-app-only",
-      "file": "navigation-router-stack.mdc",
-      "mustMatch": "app/src/app",
-      "mustNotMatch": "app/src/ui"
-    },
-    {
-      "id": "navigation-router-ui-tsx",
-      "file": "navigation-router-ui.mdc",
-      "mustMatch": "app/src/ui/\\*\\*/\\*\\.tsx"
-    }
-  ],
-  "wideGlobDenylist": [
-    "architecture-boundaries.mdc",
-    "navigation-router-stack.mdc"
-  ]
-}