@bonesofspring/ai-rules 0.2.10 → 0.2.12

package/presets/cursor/php-laravel/skills/technical-retro/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: technical-retro
+description: Facilitates technical retrospectives for tasks, sprints, incidents, releases, and agent-team pipelines. Use when the user asks for retro, postmortem, process review, or action items after delivery.
+---
+
+# Technical Retro
+
+## Inputs
+
+Ask for missing period, focus, task slug, participants, or format constraints. If a slug is provided, read `.cursor/team/tasks/<slug>/` artifacts and local git status/diff. Do not invent facts not present in artifacts or the user's message.
+
+## Facilitation Principles
+
+- Focus on process and system behavior, not blame.
+- Separate facts, interpretations, and proposed actions.
+- Balance what worked with what slowed delivery.
+- Keep action items concrete, owned, and measurable.
+
+## Default Structure
+
+1. Goal and scope.
+2. Timeline or factual observations.
+3. What worked.
+4. What hurt quality, speed, or confidence.
+5. Root causes for the top one or two issues.
+6. Experiments and action items.
+
+## Agent Team Block
+
+For `/task` pipelines, include router, analyst, developer, **build-verifier** (composer test / vendor/bin/phpunit), reviewer, QA/integration tests, hooks, and rules.
+
+## Wrong-turn taxonomy (optional)
+
+When artifacts or the user mention agent mistakes, tag incidents:
+
+| Kind | Signal |
+|------|--------|
+| `correction` | User pushback («no», «don't», «actually») |
+| `retry` | Same tool/approach 2+ times before success |
+| `waste` | Many searches before the right file |
+| `reversal` | Edit then revert / delete |
+| `dead-end` | Env/tool failure (missing binary, wrong path) |
+
+Severity: **high** (explicit correction / large waste) · **med** · **low**. Confidence 0–100 — be honest; low-confidence items are optional.
+
+## Preset feedback loop
+
+If the same issue appeared in **2+** tasks (or **3+** for packaging a new rule/skill — Rule of Three), add section **Preset updates**:
+
+- Proposed change to `.cursor/rules/`, `.cursor/agents/`, `.cursor/skills/`, or **`.cursor/team/conventions.md`** (prefer conventions for project gotchas)
+- One concrete snippet or file path
+- Whether it belongs in always-on vs globs vs skill vs conventions (see `PRESET-CONTRIBUTION` → Building blocks)
+
+Do not apply preset or conventions changes without user approval.

package/presets/cursor/php-laravel/skills/unit-testing/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: unit-testing
+description: Plans, generates, and heals PHPUnit/Pest unit tests for Laravel Actions, Services, and pure helpers using *Test.php and tests-unit rules. Use for unit-test planning, generation, or healing.
+---
+
+# Unit testing (Laravel)
+
+1. Prefer PHPUnit (or Pest if already in repo/CI) under `tests/Unit/**` (`*Test.php`).
+2. Fake Eloquent collaborators / repos when justified; use `Bus::fake` / `Event::fake` for side effects — no real HTTP kernel or DB unless the harness already boots lightly.
+3. Follow `tests-unit.mdc`; heal with `unit-test-healer` when red.
+
+## Agents
+
+`unit-test-planner` → `unit-test-generator` → `unit-test-healer`.

package/presets/cursor/php-laravel/skills/write-adr/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: write-adr
+description: Author an Architecture Decision Record (ADR) with Context, Decision, Consequences, and Links. Use when capturing a durable technical choice for the team.
+---
+
+# Write ADR
+
+On-demand skill for durable architecture decisions. Stack-agnostic sections — fill with project-specific paths and links.
+
+## When to use
+
+- Choosing between non-trivial alternatives (storage, layering, library, API shape).
+- Recording a decision that future agents/humans should not silently reverse.
+- User asks for an ADR, decision log, or “why did we pick X”.
+
+## Template
+
+Create (or append) a short markdown ADR in the repo’s agreed location (e.g. `docs/adr/`, `.cursor/team/`, wiki). Suggested filename: `NNNN-short-title.md`.
+
+```markdown
+# ADR NNNN: <Title>
+
+## Context
+What problem / constraint / force requires a decision?
+
+## Decision
+What we chose (one clear option). Include rejected alternatives briefly if useful.
+
+## Consequences
+Positive and negative outcomes; follow-up work; what becomes harder.
+
+## Links
+Related PRs, issues, rules, prior ADRs, diagrams.
+```
+
+## Guidelines
+
+- Prefer one decision per ADR.
+- Keep Context factual; Decision imperative and short.
+- Link living gotchas to `team/conventions.md` when the decision becomes a recurring local pattern.
+- Do not put ADR bodies only in root `AGENTS.md` (overwrite on init).

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

@@ -0,0 +1,17 @@
+# Agent team artifacts (preset php-laravel)
+
+Каталог артефактов пайплайна «команда агентов» для Laravel backend.
+
+| Fixture | Pipeline sketch |
+|---------|-----------------|
+| `feature-full.json` | full delivery + integration-test-* + build-verifier |
+| `feature-light.json` | developer → build-verifier (`php artisan test` / configured static analysis) |
+| `bugfix-standard.json` | debugger → fix → build-verifier |
+
+## Local metrics ledger
+
+`metrics.json` is an append-only schema-v1 event ledger for one task run. It contains only allowlisted IDs, task dimensions, timestamps, outcomes, and attribution confidence—never prompts, secrets, file paths, or contents. The router writes `task_started` / `attempt_started`; the hook records host-clock completion and human-gate edges under a per-task lock with temp-and-rename.
+
+`status.json.activeAttempts` is a transient timing bridge keyed by `attemptId`; `lastCompletedAttempt` is diagnostic. For parallel stops, the hook must use a stable payload identity or the sole active attempt. Otherwise an explicit `.metrics-receipts.json` receipt is fallback data marked `source: agent`, `attributionConfidence: fallback`; it must never guess from `currentAgent`.
+
+Aggregate with `node packages/ai-rules/scripts/aggregate-agent-task-metrics.mjs --team-root .cursor/team`. It reports role/agent count, completed count, total/average duration, distinct completed run IDs, separate human-gate wait, and incomplete artifacts.

package/presets/cursor/php-laravel/team/conventions.md

@@ -0,0 +1,21 @@
+# Living conventions (team)
+
+Consumer-owned store for post-init gotchas, patterns, and decisions. **Not** always-on. Fill after `ai-rules init`. Root `AGENTS.md` only points here.
+
+## Gotchas
+
+<!-- e.g. fragile flows, “never do X in this repo” -->
+
+-
+
+## Patterns
+
+<!-- local patterns beyond reference-features table -->
+
+-
+
+## Decisions
+
+<!-- short pointers to ADRs / product choices that affect code -->
+
+-

package/presets/cursor/php-laravel/team/fixtures/bugfix-standard.json

@@ -0,0 +1,12 @@
+{
+  "profile": "standard",
+  "summary": "Laravel bugfix",
+  "steps": [
+    { "agent": "debugger", "label": "Investigate with runtime evidence" },
+    { "agent": "feature-developer", "label": "Apply minimal fix" },
+    {
+      "agent": "build-verifier",
+      "label": "php artisan test / composer test / static analysis"
+    }
+  ]
+}

package/presets/cursor/php-laravel/team/fixtures/feature-full.json

@@ -0,0 +1,15 @@
+{
+  "profile": "full",
+  "summary": "Laravel full feature delivery",
+  "steps": [
+    { "agent": "task-analyst", "label": "Decompose" },
+    { "agent": "solution-architect", "label": "Design", "model": "strong" },
+    { "agent": "feature-developer", "label": "Implement" },
+    { "agent": "unit-test-planner", "label": "Plan unit tests" },
+    { "agent": "unit-test-generator", "label": "Generate unit tests" },
+    { "agent": "integration-test-planner", "label": "Plan Feature/integration tests" },
+    { "agent": "integration-test-generator", "label": "Generate Feature tests" },
+    { "agent": "build-verifier", "label": "php artisan test / composer test / static analysis", "model": "cheap" },
+    { "agent": "code-reviewer", "label": "Review" }
+  ]
+}

package/presets/cursor/php-laravel/team/fixtures/feature-light.json

@@ -0,0 +1,8 @@
+{
+  "profile": "light",
+  "summary": "Laravel light feature delivery",
+  "steps": [
+    { "agent": "feature-developer", "label": "Implement Laravel feature slice" },
+    { "agent": "build-verifier", "label": "php artisan test / composer test / static analysis", "model": "cheap" }
+  ]
+}