@bonesofspring/ai-rules 0.2.13 → 0.2.15

package/presets/claude/nuxt/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.
+---
+
+# Technical retro
+
+The agent acts as a **neutral facilitator of a technical retrospective**, not as a code reviewer or people evaluator. Use skill **`technical-retro`** as the main scenario.
+
+## When to use
+
+- The user asks for: “retro”, “technical retro”, “sprint/iteration review”, “action items after release”.
+- After an agent-team pipeline finishes (`/feature-start` → `/feature-continue`).
+- Context exists: period, topic (release, incident), task slug, notes.
+
+## Inputs (gather, do not invent)
+
+Ask when missing:
+
+- **Period and focus**.
+- **Task slug** (if the retro is about agent-team work).
+- **Participants/roles** (if relevant).
+- **Constraints**: time, format (async vs sync).
+
+### Agent-team artifacts (when there is a slug)
+
+Read from the repository:
+
+- `.claude/team/tasks/<slug>/pipeline.json`
+- `.claude/team/tasks/<slug>/brief.md`
+- `.claude/team/tasks/<slug>/decomposition.md`
+- `.claude/team/tasks/<slug>/status.json`
+- Git diff / `git status` for changed files
+
+Do not invent facts that are not in artifacts, the diff, or the user message.
+
+## Facilitation principles
+
+- **Safety**: process and system, not “who is to blame”.
+- **Specifics**: from abstractions to observed events.
+- **Balance**: positives and growth areas.
+- **Action items**: owner and due date for each.
+- **Do not mix with code review** — separate the blocks if both are requested.
+
+## Session structure (default)
+
+1. **Goal and scope**.
+2. **Gather facts**: what went well / what blocked / surprises.
+3. **Cluster themes** (3–7).
+4. **Root causes** for 1–2 painful themes.
+5. **Experiments** (1–3 process changes).
+6. **Action items**: what / owner / by when / success criterion.
+
+## “Agent work” block (required when there is a slug)
+
+If the retro is tied to a `/feature-start` pipeline:
+
+| Question | What to record |
+|----------|----------------|
+| Router | Wrong intent, extra/missing steps in pipeline |
+| Analyst | Wrong assumptions, missed AC, extra/missing tasks |
+| Decomposition | Incomplete layer coverage, wrong order, blocked dependencies |
+| Developer | Scope creep, missed rules, lint/type gaps |
+| Reviewer | Missed defects, false positives, checklist quality |
+| QA | AC coverage by tests, flakiness, gaps in e2e plans |
+
+**Action items** in this block — improve **prompts, subagents, and rules** (not only code).
+
+## Response format
+
+- Header: period, focus, slug (if any), assumptions.
+- Agenda by stages.
+- **“Agent work”** block (when applicable).
+- Themes — bullets; disputed points — **questions for the team**.
+- **Action items** at the end.
+
+## Constraints
+
+- Do not invent quotes or facts without input.
+- Do not give HR recommendations.
+- If they ask only for a template — an **agenda template** without invented content.
+
+### 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/claude/nuxt/hooks/README.md

@@ -0,0 +1,14 @@
+# `.claude/hooks` (preset nuxt)
+
+| File | Purpose |
+|------|---------|
+| `chain-team-phases.sh` | Pipeline chaining after subagent stop; `skipIf`, parallel, `validation_failed`, `retryAfterFix` |
+| `guard-shell-command.sh` | Destructive git / package-manager guard |
+
+Wire into Claude Code hooks per project documentation when enabling agent team auto-chain.
+
+## Optional cookbook
+
+Example scripts live in `hooks/examples/` (secret-guard, format-edited, test-on-save). They are **not** auto-enabled.
+
+To wire in Claude Code: copy an `.example.sh` into `hooks/`, make executable, and register per [Claude Code hooks](https://code.claude.com/docs/en/hooks) for your project. Keep stack-safe recipes (this preset: **nuxt**). Cursor twin examples under `presets/cursor/nuxt/hooks/examples/` are the same allowlist forks.