claude-dev-env 2.13.0 → 2.14.0

package/skills/pr-converge/pr_converge_skill_constants/AGENTS.md

@@ -0,0 +1,26 @@
+# pr_converge_skill_constants
+
+Importable Python constants module for the `pr-converge` skill. Script-specific constants (CLI args, markdown patterns, reflow settings) live in `scripts/pr_converge_scripts_constants/` and import from here.
+
+## Key files
+
+| File | Purpose |
+|---|---|
+| `__init__.py` | Package marker |
+| `constants.py` | All runtime and API constants: bot logins, review states, GH API path templates, bugbot/bugteam detection patterns, exit codes |
+
+## Exported constants (selected)
+
+| Constant | Purpose |
+|---|---|
+| `CURSOR_BOT_LOGIN` | Login string for the Cursor bugbot reviewer |
+| `COPILOT_REVIEWER_LOGIN` | Login string for the Copilot reviewer bot |
+| `ALL_COPILOT_CLEAN_REVIEW_STATES` | Tuple of review states that count as clean for Copilot |
+| `BUGBOT_DIRTY_BODY_REGEX` | Regex that matches a bugbot review body reporting findings |
+| `GH_REVIEWS_PATH_TEMPLATE` | `gh api` path template for PR reviews |
+| `GH_INLINE_COMMENTS_PATH_TEMPLATE` | `gh api` path template for PR inline comments |
+
+## Conventions
+
+- All path templates use `str.format(**kwargs)` with keys `owner`, `repo`, `number`.
+- `packages/claude-dev-env/skills/pr-converge/scripts/pr_converge_scripts_constants/pr_converge_constants.py` re-exports everything here via `from pr_converge_skill_constants.constants import ...` so scripts can import from either location.

package/skills/pr-converge/pr_converge_skill_constants/CLAUDE.md

@@ -1,26 +1 @@
-# pr_converge_skill_constants
-
-Importable Python constants module for the `pr-converge` skill. Script-specific constants (CLI args, markdown patterns, reflow settings) live in `scripts/pr_converge_scripts_constants/` and import from here.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `__init__.py` | Package marker |
-| `constants.py` | All runtime and API constants: bot logins, review states, GH API path templates, bugbot/bugteam detection patterns, exit codes |
-
-## Exported constants (selected)
-
-| Constant | Purpose |
-|---|---|
-| `CURSOR_BOT_LOGIN` | Login string for the Cursor bugbot reviewer |
-| `COPILOT_REVIEWER_LOGIN` | Login string for the Copilot reviewer bot |
-| `ALL_COPILOT_CLEAN_REVIEW_STATES` | Tuple of review states that count as clean for Copilot |
-| `BUGBOT_DIRTY_BODY_REGEX` | Regex that matches a bugbot review body reporting findings |
-| `GH_REVIEWS_PATH_TEMPLATE` | `gh api` path template for PR reviews |
-| `GH_INLINE_COMMENTS_PATH_TEMPLATE` | `gh api` path template for PR inline comments |
-
-## Conventions
-
-- All path templates use `str.format(**kwargs)` with keys `owner`, `repo`, `number`.
-- `packages/claude-dev-env/skills/pr-converge/scripts/pr_converge_scripts_constants/pr_converge_constants.py` re-exports everything here via `from pr_converge_skill_constants.constants import ...` so scripts can import from either location.
+@AGENTS.md

package/skills/pr-converge/reference/AGENTS.md

@@ -0,0 +1,28 @@
+# pr-converge/reference
+
+Reference documents for the `pr-converge` skill. These files define the per-tick step sequence, convergence gates, fix protocol, stop conditions, state schema, multi-PR orchestration, and examples.
+
+## Key files
+
+| File | Purpose |
+|---|---|
+| `progress-checklist.md` | The per-tick eleven-step checklist (Step 0 open → Step 11 report), each step pointing to its spoke file |
+| `per-tick.md` | Step-by-step procedure for one tick (resolve HEAD, run the internal CODE_REVIEW and BUGTEAM phases, then the terminal BUGBOT and COPILOT_WAIT gates, schedule next wakeup) |
+| `convergence-gates.md` | Six gates that must all pass before the PR is marked ready for review |
+| `fix-protocol.md` | pr-converge deltas on the `pr-fix-protocol` skill: multi-PR teammate obligations and the same-tick bugbot re-trigger rule |
+| `ground-rules.md` | Non-negotiable constraints for the convergence loop |
+| `stop-conditions.md` | Conditions that end the loop without convergence (cap reached, stuck, user stop) |
+| `state-schema.md` | Fields in `pr-converge-state.json` and their meanings |
+| `multi-pr-orchestration.md` | How to run the loop across multiple PRs in parallel |
+| `examples.md` | Worked examples of tick sequences |
+
+## Subdirectories
+
+| Directory | Role |
+|---|---|
+| `obstacles/` | Per-obstacle runbooks for known failure modes in the convergence loop |
+
+## Conventions
+
+- `per-tick.md` is the primary reference loaded during each tick. The pacing workflow lives in `../workflows/schedule-wakeup-loop.md`.
+- Every gate in `convergence-gates.md` must produce evidence before the next gate runs.

package/skills/pr-converge/reference/CLAUDE.md

@@ -1,28 +1 @@
-# pr-converge/reference
-
-Reference documents for the `pr-converge` skill. These files define the per-tick step sequence, convergence gates, fix protocol, stop conditions, state schema, multi-PR orchestration, and examples.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `progress-checklist.md` | The per-tick eleven-step checklist (Step 0 open → Step 11 report), each step pointing to its spoke file |
-| `per-tick.md` | Step-by-step procedure for one tick (resolve HEAD, run the internal CODE_REVIEW and BUGTEAM phases, then the terminal BUGBOT and COPILOT_WAIT gates, schedule next wakeup) |
-| `convergence-gates.md` | Six gates that must all pass before the PR is marked ready for review |
-| `fix-protocol.md` | pr-converge deltas on the `pr-fix-protocol` skill: multi-PR teammate obligations and the same-tick bugbot re-trigger rule |
-| `ground-rules.md` | Non-negotiable constraints for the convergence loop |
-| `stop-conditions.md` | Conditions that end the loop without convergence (cap reached, stuck, user stop) |
-| `state-schema.md` | Fields in `pr-converge-state.json` and their meanings |
-| `multi-pr-orchestration.md` | How to run the loop across multiple PRs in parallel |
-| `examples.md` | Worked examples of tick sequences |
-
-## Subdirectories
-
-| Directory | Role |
-|---|---|
-| `obstacles/` | Per-obstacle runbooks for known failure modes in the convergence loop |
-
-## Conventions
-
-- `per-tick.md` is the primary reference loaded during each tick. The pacing workflow lives in `../workflows/schedule-wakeup-loop.md`.
-- Every gate in `convergence-gates.md` must produce evidence before the next gate runs.
+@AGENTS.md

package/skills/pr-converge/reference/obstacles/AGENTS.md

@@ -0,0 +1,23 @@
+# pr-converge/reference/obstacles
+
+Per-obstacle runbooks for known failure modes in the `pr-converge` convergence loop. Each file covers one specific obstacle: what causes it, how to detect it, and how to recover.
+
+## Files
+
+| File | Obstacle |
+|---|---|
+| `fix-post-replies.md` | Posting inline review replies fails or posts to the wrong thread |
+| `fix-publish-summary.md` | Publishing the bugteam summary comment fails |
+| `fix-push.md` | `git push` fails during a fix commit |
+| `fix-read-filelines.md` | Reading file line ranges for a fix fails |
+| `fix-reset-state.md` | State JSON becomes corrupt or inconsistent between ticks |
+| `fix-resolve-threads.md` | Resolving inline comment threads via GraphQL fails |
+| `fix-spawn-clean-coder.md` | Spawning the `clean-coder` subagent fails or produces no output |
+| `fix-stage-commit.md` | Staging or committing a fix fails |
+| `fix-trigger-bugbot.md` | Triggering Cursor Bugbot via an issue comment fails |
+| `fix-write-test.md` | Writing a failing test before a fix fails |
+
+## Conventions
+
+- Each runbook is loaded on demand when the convergence loop hits that specific obstacle.
+- Runbooks do not overlap with `per-tick.md`; they cover edge cases and recovery paths that fall outside the normal tick flow.

package/skills/pr-converge/reference/obstacles/CLAUDE.md

@@ -1,23 +1 @@
-# pr-converge/reference/obstacles
-
-Per-obstacle runbooks for known failure modes in the `pr-converge` convergence loop. Each file covers one specific obstacle: what causes it, how to detect it, and how to recover.
-
-## Files
-
-| File | Obstacle |
-|---|---|
-| `fix-post-replies.md` | Posting inline review replies fails or posts to the wrong thread |
-| `fix-publish-summary.md` | Publishing the bugteam summary comment fails |
-| `fix-push.md` | `git push` fails during a fix commit |
-| `fix-read-filelines.md` | Reading file line ranges for a fix fails |
-| `fix-reset-state.md` | State JSON becomes corrupt or inconsistent between ticks |
-| `fix-resolve-threads.md` | Resolving inline comment threads via GraphQL fails |
-| `fix-spawn-clean-coder.md` | Spawning the `clean-coder` subagent fails or produces no output |
-| `fix-stage-commit.md` | Staging or committing a fix fails |
-| `fix-trigger-bugbot.md` | Triggering Cursor Bugbot via an issue comment fails |
-| `fix-write-test.md` | Writing a failing test before a fix fails |
-
-## Conventions
-
-- Each runbook is loaded on demand when the convergence loop hits that specific obstacle.
-- Runbooks do not overlap with `per-tick.md`; they cover edge cases and recovery paths that fall outside the normal tick flow.
+@AGENTS.md

package/skills/pr-converge/scripts/AGENTS.md

@@ -0,0 +1,46 @@
+# pr-converge/scripts
+
+Python helper scripts for the `pr-converge` skill, plus their tests and a PowerShell/AutoHotkey toolset for advancing Cursor agents.
+
+## Key files
+
+| File | Purpose |
+|---|---|
+| `check_bugbot_ci.py` | Checks bugbot CI check-run status on a given SHA |
+| `check_convergence.py` | Evaluates whether all convergence gates pass on the current HEAD |
+| `check_convergence_availability.py` | Resolves reviewer waivers from flag, disk-authoritative settings (env fallback), and the availability/quota probe, with waived / enforced / probe_error_reason states |
+| `check_convergence_gates.py` | GitHub REST leaf checks (review and Bugbot) the convergence gates call |
+| `check_convergence_thread_gates.py` | GitHub GraphQL and REST leaf checks (review threads and pending reviewers) the convergence gates call |
+| `check_pending_reviews.py` | Fetches pending review requests and reviewer states |
+| `fetch_copilot_reviews.py` | Fetches Copilot reviewer reviews filtered to the current HEAD |
+| `post_fix_reply.py` | Posts an inline reply to a review comment thread |
+| `reflow_skill_md.py` | Reformats `SKILL.md` to enforce a line width limit |
+| `README.md` | MCP tool reference for PR operations used by the scripts |
+| `_pr_converge_path_setup.py` | Adds the scripts directory to `sys.path` for direct script imports |
+| `conftest.py` | Puts the scripts directory on `sys.path` so pytest collects the suite |
+| `test_check_bugbot_ci.py` | Tests for `check_bugbot_ci.py` |
+| `test_check_convergence.py` | Tests for `check_convergence.py` |
+| `test_check_convergence_availability.py` | Tests for `check_convergence_availability.py` |
+| `test_check_convergence_contract.py` | Contract pins for `check_convergence.py` gate wiring |
+| `test_check_convergence_gates.py` | Tests for `check_convergence_gates.py` |
+| `test_check_convergence_thread_gates.py` | Tests for `check_convergence_thread_gates.py` |
+| `test__pr_converge_path_setup.py` | Tests for `_pr_converge_path_setup.py` |
+| `test_cursor_agents_continue.py` | Tests for the cursor-agents-continue toolset |
+| `test_reflow_skill_md.py` | Tests for `reflow_skill_md.py` |
+| `caller-window-pid.ps1` | Gets the PID of the calling terminal window |
+| `cursor-agents-continue.ahk` | AutoHotkey script to advance Cursor agent prompts |
+| `cursor-agents-continue.cmd` | CMD wrapper for the AHK script |
+| `cursor-agents-continue-stop-others.ps1` | Stops other Cursor agents before advancing one |
+| `cursor-agents-continue-caller.cmd` | Caller-side CMD wrapper |
+
+## Subdirectories
+
+| Directory | Role |
+|---|---|
+| `pr_converge_scripts_constants/` | Script-specific constants (re-exports skill constants plus adds reflow/CLI constants) |
+
+## Conventions
+
+- Scripts import constants from `pr_converge_scripts_constants.pr_converge_constants`, which re-exports everything from `pr_converge_skill_constants.constants`.
+- Run scripts as `python ~/.claude/skills/pr-converge/scripts/<script>.py --owner <O> --repo <R> --pr-number <N>`.
+- The `reflow_skill_md.py` script targets `SKILL.md` in the parent skill directory (resolved via `TARGET_SKILL_PATH` in `pr_converge_scripts_constants/reflow_skill_md_constants.py`).

package/skills/pr-converge/scripts/CLAUDE.md

@@ -1,46 +1 @@
-# pr-converge/scripts
-
-Python helper scripts for the `pr-converge` skill, plus their tests and a PowerShell/AutoHotkey toolset for advancing Cursor agents.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `check_bugbot_ci.py` | Checks bugbot CI check-run status on a given SHA |
-| `check_convergence.py` | Evaluates whether all convergence gates pass on the current HEAD |
-| `check_convergence_availability.py` | Resolves reviewer waivers from flag, disk-authoritative settings (env fallback), and the availability/quota probe, with waived / enforced / probe_error_reason states |
-| `check_convergence_gates.py` | GitHub REST leaf checks (review and Bugbot) the convergence gates call |
-| `check_convergence_thread_gates.py` | GitHub GraphQL and REST leaf checks (review threads and pending reviewers) the convergence gates call |
-| `check_pending_reviews.py` | Fetches pending review requests and reviewer states |
-| `fetch_copilot_reviews.py` | Fetches Copilot reviewer reviews filtered to the current HEAD |
-| `post_fix_reply.py` | Posts an inline reply to a review comment thread |
-| `reflow_skill_md.py` | Reformats `SKILL.md` to enforce a line width limit |
-| `README.md` | MCP tool reference for PR operations used by the scripts |
-| `_pr_converge_path_setup.py` | Adds the scripts directory to `sys.path` for direct script imports |
-| `conftest.py` | Puts the scripts directory on `sys.path` so pytest collects the suite |
-| `test_check_bugbot_ci.py` | Tests for `check_bugbot_ci.py` |
-| `test_check_convergence.py` | Tests for `check_convergence.py` |
-| `test_check_convergence_availability.py` | Tests for `check_convergence_availability.py` |
-| `test_check_convergence_contract.py` | Contract pins for `check_convergence.py` gate wiring |
-| `test_check_convergence_gates.py` | Tests for `check_convergence_gates.py` |
-| `test_check_convergence_thread_gates.py` | Tests for `check_convergence_thread_gates.py` |
-| `test__pr_converge_path_setup.py` | Tests for `_pr_converge_path_setup.py` |
-| `test_cursor_agents_continue.py` | Tests for the cursor-agents-continue toolset |
-| `test_reflow_skill_md.py` | Tests for `reflow_skill_md.py` |
-| `caller-window-pid.ps1` | Gets the PID of the calling terminal window |
-| `cursor-agents-continue.ahk` | AutoHotkey script to advance Cursor agent prompts |
-| `cursor-agents-continue.cmd` | CMD wrapper for the AHK script |
-| `cursor-agents-continue-stop-others.ps1` | Stops other Cursor agents before advancing one |
-| `cursor-agents-continue-caller.cmd` | Caller-side CMD wrapper |
-
-## Subdirectories
-
-| Directory | Role |
-|---|---|
-| `pr_converge_scripts_constants/` | Script-specific constants (re-exports skill constants plus adds reflow/CLI constants) |
-
-## Conventions
-
-- Scripts import constants from `pr_converge_scripts_constants.pr_converge_constants`, which re-exports everything from `pr_converge_skill_constants.constants`.
-- Run scripts as `python ~/.claude/skills/pr-converge/scripts/<script>.py --owner <O> --repo <R> --pr-number <N>`.
-- The `reflow_skill_md.py` script targets `SKILL.md` in the parent skill directory (resolved via `TARGET_SKILL_PATH` in `pr_converge_scripts_constants/reflow_skill_md_constants.py`).
+@AGENTS.md

package/skills/pr-converge/scripts/pr_converge_scripts_constants/AGENTS.md

@@ -0,0 +1,18 @@
+# pr_converge_scripts_constants
+
+Constants module for the `pr-converge` skill's Python scripts. Re-exports all runtime/API constants from the skill-level module and adds script-specific constants for CLI arguments, markdown patterns, and reflow settings.
+
+## Key files
+
+| File | Purpose |
+|---|---|
+| `__init__.py` | Package marker |
+| `pr_converge_constants.py` | Re-exports all constants from `pr_converge_skill_constants.constants` plus adds script-specific values |
+| `reflow_skill_md_constants.py` | Constants for `reflow_skill_md.py`: line width limit, list item patterns, `TARGET_SKILL_PATH` |
+| `convergence_gate_constants.py` | Constants for `check_convergence_gates.py`: short-SHA length, join separators, and the review-threads GraphQL query |
+
+## Conventions
+
+- `pr_converge_constants.py` uses `from pr_converge_skill_constants.constants import ...` (with `# noqa: F401`) to re-export everything so script files can import from one location.
+- `reflow_skill_md_constants.py` resolves `TARGET_SKILL_PATH` from its own `__file__` path, pointing to `SKILL.md` three directories up.
+- Script-specific regex patterns (ordered list items, bullet list items, unfinished markdown link targets, markdown reference definitions) live in `reflow_skill_md_constants.py`.

package/skills/pr-converge/scripts/pr_converge_scripts_constants/CLAUDE.md

@@ -1,18 +1 @@
-# pr_converge_scripts_constants
-
-Constants module for the `pr-converge` skill's Python scripts. Re-exports all runtime/API constants from the skill-level module and adds script-specific constants for CLI arguments, markdown patterns, and reflow settings.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `__init__.py` | Package marker |
-| `pr_converge_constants.py` | Re-exports all constants from `pr_converge_skill_constants.constants` plus adds script-specific values |
-| `reflow_skill_md_constants.py` | Constants for `reflow_skill_md.py`: line width limit, list item patterns, `TARGET_SKILL_PATH` |
-| `convergence_gate_constants.py` | Constants for `check_convergence_gates.py`: short-SHA length, join separators, and the review-threads GraphQL query |
-
-## Conventions
-
-- `pr_converge_constants.py` uses `from pr_converge_skill_constants.constants import ...` (with `# noqa: F401`) to re-export everything so script files can import from one location.
-- `reflow_skill_md_constants.py` resolves `TARGET_SKILL_PATH` from its own `__file__` path, pointing to `SKILL.md` three directories up.
-- Script-specific regex patterns (ordered list items, bullet list items, unfinished markdown link targets, markdown reference definitions) live in `reflow_skill_md_constants.py`.
+@AGENTS.md

package/skills/pr-converge/workflows/AGENTS.md

@@ -0,0 +1,16 @@
+# pr-converge/workflows
+
+Pacing workflow specification for the `pr-converge` loop.
+
+## Key files
+
+| File | Purpose |
+|---|---|
+| `schedule-wakeup-loop.md` | Specifies `ScheduleWakeup` call parameters, delays, and stop/convergence conditions for each tick |
+
+## Conventions
+
+- `per-tick.md` (in `../reference/`) references this file for Step 4 (schedule next wakeup). Read it before running Step 4.
+- Default delay: `delaySeconds: 360`. Exception: BUGBOT inline-lag branch uses `delaySeconds: 90`.
+- On convergence or a hard stop condition, omit the `ScheduleWakeup` call entirely.
+- The `reason` field in each `ScheduleWakeup` call names what is being awaited, including the current `phase` and `bugbot_clean_at` SHA when set.

package/skills/pr-converge/workflows/CLAUDE.md

@@ -1,16 +1 @@
-# pr-converge/workflows
-
-Pacing workflow specification for the `pr-converge` loop.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `schedule-wakeup-loop.md` | Specifies `ScheduleWakeup` call parameters, delays, and stop/convergence conditions for each tick |
-
-## Conventions
-
-- `per-tick.md` (in `../reference/`) references this file for Step 4 (schedule next wakeup). Read it before running Step 4.
-- Default delay: `delaySeconds: 360`. Exception: BUGBOT inline-lag branch uses `delaySeconds: 90`.
-- On convergence or a hard stop condition, omit the `ScheduleWakeup` call entirely.
-- The `reason` field in each `ScheduleWakeup` call names what is being awaited, including the current `phase` and `bugbot_clean_at` SHA when set.
+@AGENTS.md

package/skills/prototype/reference/honest-limitations.md

@@ -10,7 +10,7 @@ Promotion records the controls applied to the real diff:
 
 - review and verification under the [review guide](../../reviews/SKILL.md#review-workflow);
 - the `privacy-hygiene` sweep for personal data and secrets;
-- the pull-request review (AGENTS.md criteria and any PR-loop reviewers).
+- the pull-request review criteria and any PR-loop reviewers.
 
 Say plainly: the write-time rule engine did not see this code; the verifier and review are what cover it.
 

package/skills/rebase/AGENTS.md

@@ -0,0 +1,32 @@
+# rebase
+
+Rebase a branch onto its base ref with verification gates that catch logically broken results before pushing.
+
+**Trigger:** `/rebase`, "rebase this branch", "PR has merge conflicts", "rebase onto main", force-push to update remote branch history.
+
+## Purpose
+
+The default failure mode for a rebase is shipping code that compiled but does not run. This skill prevents that by running real import checks, test collection, and symbol scans after every rebase — not just syntax validation.
+
+## Key files
+
+| File | Purpose |
+|---|---|
+| `SKILL.md` | The complete skill — four phases (pre-rebase analysis, during rebase, verification gates, push). No companion files. |
+
+## Four phases
+
+| Phase | Key actions |
+|---|---|
+| 1 — Pre-rebase analysis | Resolve base via `gh pr view`, classify scenario (stacked/squash/long-lived), fetch fresh, scan commit messages for deleted/renamed symbols |
+| 2 — During rebase | Verify `--skip` with a diff, audit auto-merged files with `git diff --name-only --diff-filter=M ORIG_HEAD` |
+| 3 — Verification gates | `python -m compileall`, `pytest --collect-only -q`, targeted test run, reference scan for removals |
+| 4 — Push | Explicit authorization required; `--force-with-lease=<branch>:<sha>` only; verify mergeability after push |
+
+## Conventions
+
+- Force-push requires explicit operator authorization every time — auto mode does not bypass this.
+- `--force-with-lease=<branch>:<sha>` only; bare `--force` is refused.
+- Never force-push `main`, `master`, `release/*`, `production`, or any multi-author branch.
+- Symbol scans prefer Serena (`find_referencing_symbols`) then the Grep tool, then shell grep as a last resort.
+- `ORIG_HEAD` is the correct ref for auto-merged file audits mid-rebase; `HEAD@{1}` shifts per step.

package/skills/rebase/CLAUDE.md

@@ -1,32 +1 @@
-# rebase
-
-Rebase a branch onto its base ref with verification gates that catch logically broken results before pushing.
-
-**Trigger:** `/rebase`, "rebase this branch", "PR has merge conflicts", "rebase onto main", force-push to update remote branch history.
-
-## Purpose
-
-The default failure mode for a rebase is shipping code that compiled but does not run. This skill prevents that by running real import checks, test collection, and symbol scans after every rebase — not just syntax validation.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `SKILL.md` | The complete skill — four phases (pre-rebase analysis, during rebase, verification gates, push). No companion files. |
-
-## Four phases
-
-| Phase | Key actions |
-|---|---|
-| 1 — Pre-rebase analysis | Resolve base via `gh pr view`, classify scenario (stacked/squash/long-lived), fetch fresh, scan commit messages for deleted/renamed symbols |
-| 2 — During rebase | Verify `--skip` with a diff, audit auto-merged files with `git diff --name-only --diff-filter=M ORIG_HEAD` |
-| 3 — Verification gates | `python -m compileall`, `pytest --collect-only -q`, targeted test run, reference scan for removals |
-| 4 — Push | Explicit authorization required; `--force-with-lease=<branch>:<sha>` only; verify mergeability after push |
-
-## Conventions
-
-- Force-push requires explicit operator authorization every time — auto mode does not bypass this.
-- `--force-with-lease=<branch>:<sha>` only; bare `--force` is refused.
-- Never force-push `main`, `master`, `release/*`, `production`, or any multi-author branch.
-- Symbol scans prefer Serena (`find_referencing_symbols`) then the Grep tool, then shell grep as a last resort.
-- `ORIG_HEAD` is the correct ref for auto-merged file audits mid-rebase; `HEAD@{1}` shifts per step.
+@AGENTS.md

package/skills/recall/AGENTS.md

@@ -0,0 +1,30 @@
+# recall
+
+Retrieves prior session context and decisions from the Obsidian vault for the current project.
+
+**Trigger:** `/recall [search query or project name]`.
+
+## Purpose
+
+Surfaces relevant session reports, decision notes, and research from the Obsidian vault before starting work. Prevents repeating decisions already made or missing known gotchas.
+
+## Key files
+
+| File | Purpose |
+|---|---|
+| `SKILL.md` | The complete skill — six steps (resolve query, frontmatter search, content search, read top matches, present with attribution, handle no results). No companion files. |
+
+## How the skill runs
+
+1. Uses `$ARGUMENTS` as the search query, or infers the project name from conversation context.
+2. Searches by frontmatter first (`mcp__obsidian__search_notes` with `searchFrontmatter: true`) to catch session reports and decision notes tagged with the project.
+3. Falls back to content keyword search when frontmatter search returns few results.
+4. Reads the top 3 most relevant notes via `mcp__obsidian__read_note`, preferring recent notes and decision summaries over raw research.
+5. Reports each note with its path, date, relevant excerpts, and whether any decisions are marked `status: Superseded`.
+6. States clearly when no vault history exists — never infers or invents history.
+
+## Conventions
+
+- `disable-model-invocation: true` is not set; this skill does invoke the model to synthesize results.
+- The skill is read-only: it never writes to the vault.
+- Companion to `/remember` (which writes decisions) and `/session-log` (which writes session reports).

package/skills/recall/CLAUDE.md

@@ -1,30 +1 @@
-# recall
-
-Retrieves prior session context and decisions from the Obsidian vault for the current project.
-
-**Trigger:** `/recall [search query or project name]`.
-
-## Purpose
-
-Surfaces relevant session reports, decision notes, and research from the Obsidian vault before starting work. Prevents repeating decisions already made or missing known gotchas.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `SKILL.md` | The complete skill — six steps (resolve query, frontmatter search, content search, read top matches, present with attribution, handle no results). No companion files. |
-
-## How the skill runs
-
-1. Uses `$ARGUMENTS` as the search query, or infers the project name from conversation context.
-2. Searches by frontmatter first (`mcp__obsidian__search_notes` with `searchFrontmatter: true`) to catch session reports and decision notes tagged with the project.
-3. Falls back to content keyword search when frontmatter search returns few results.
-4. Reads the top 3 most relevant notes via `mcp__obsidian__read_note`, preferring recent notes and decision summaries over raw research.
-5. Reports each note with its path, date, relevant excerpts, and whether any decisions are marked `status: Superseded`.
-6. States clearly when no vault history exists — never infers or invents history.
-
-## Conventions
-
-- `disable-model-invocation: true` is not set; this skill does invoke the model to synthesize results.
-- The skill is read-only: it never writes to the vault.
-- Companion to `/remember` (which writes decisions) and `/session-log` (which writes session reports).
+@AGENTS.md

package/skills/remember/AGENTS.md

@@ -0,0 +1,31 @@
+# remember
+
+Saves a decision, gotcha, or architectural choice to the Obsidian vault as a structured note.
+
+**Trigger:** User-initiated only. `/remember [what to remember]`.
+
+## Purpose
+
+Writes a decision, fact, procedure, or gotcha to `decisions/[Project] - [Short Title].md` in the Obsidian vault. Each note carries structured frontmatter and a body shaped by its type, making it searchable and readable via `/recall`.
+
+## Key files
+
+| File | Purpose |
+|---|---|
+| `SKILL.md` | The complete skill — six steps (parse input, classify type, infer project, generate title, write to vault, confirm). No companion files. |
+
+## Four note types
+
+| Type | Body format |
+|---|---|
+| `decision` | Decision + Reasoning + Alternatives + Consequences |
+| `gotcha` | Gotcha + Symptom + Fix |
+| `procedural` | 1–3 clear sentences describing the how-to |
+| `fact` | 1–3 clear sentences stating the fact |
+
+## Conventions
+
+- `disable-model-invocation: true` is set — runs without a secondary LLM call.
+- Writes via `mcp__obsidian__write_note` only; never edits existing notes.
+- Path pattern: `decisions/[Project] - [Short Title].md`.
+- Companion to `/recall` (reads vault) and `/session-log` (triggers decision extraction at session end).

package/skills/remember/CLAUDE.md

@@ -1,31 +1 @@
-# remember
-
-Saves a decision, gotcha, or architectural choice to the Obsidian vault as a structured note.
-
-**Trigger:** User-initiated only. `/remember [what to remember]`.
-
-## Purpose
-
-Writes a decision, fact, procedure, or gotcha to `decisions/[Project] - [Short Title].md` in the Obsidian vault. Each note carries structured frontmatter and a body shaped by its type, making it searchable and readable via `/recall`.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `SKILL.md` | The complete skill — six steps (parse input, classify type, infer project, generate title, write to vault, confirm). No companion files. |
-
-## Four note types
-
-| Type | Body format |
-|---|---|
-| `decision` | Decision + Reasoning + Alternatives + Consequences |
-| `gotcha` | Gotcha + Symptom + Fix |
-| `procedural` | 1–3 clear sentences describing the how-to |
-| `fact` | 1–3 clear sentences stating the fact |
-
-## Conventions
-
-- `disable-model-invocation: true` is set — runs without a secondary LLM call.
-- Writes via `mcp__obsidian__write_note` only; never edits existing notes.
-- Path pattern: `decisions/[Project] - [Short Title].md`.
-- Companion to `/recall` (reads vault) and `/session-log` (triggers decision extraction at session end).
+@AGENTS.md

package/skills/reviews/SKILL.md

@@ -8,7 +8,7 @@ description: >-
 # Code Review Guide
 
 Use this guide to evaluate a pull request or code change. Apply the repository's
-`AGENTS.md` and `CODE_RULES.md` as its project-specific quality rubric.
+the repository's checked-in review contract and `CODE_RULES.md` as its project-specific quality rubric.
 
 ## Review Judgment
 

package/skills/session-log/AGENTS.md

@@ -0,0 +1,32 @@
+# session-log
+
+Logs a session report as a self-contained HTML page in the Obsidian vault, publishes it with the `Artifact` tool, extracts unrecorded decisions, tidies the project session folder, and outputs a `/rename` command.
+
+**Trigger:** `/session-log`, "journal this session", "log this work", "session report", "save session", "capture session", "document what we did".
+
+## Purpose
+
+Produces a self-contained HTML session report shaped to the session's character (feature build, incident, research, etc.) rather than a fixed template. The skill owns the vault path, session numbering, frontmatter contract, HTML composition and publishing, decision extraction, and folder hygiene.
+
+## Key files
+
+| File | Purpose |
+|---|---|
+| `SKILL.md` | Hub — six steps, gotchas, backend detection, run-and-report checklist. |
+| `templates/frontmatter.md` | The session-page frontmatter contract and the Step 3 notes block. |
+
+## Six steps
+
+1. **Backend detection** — headless vault (`ob --version` + `OBSIDIAN_VAULT_PATH`) then local vault (`~/.claude/vault/`). Session number from `[N]. *.html` and `[N]. *.md` files in the project folder.
+2. **Session metadata** — project name, session number, session ID from `CLAUDE_CODE_SESSION_ID`, date, title.
+3. **Compose and publish via the Artifact tool** — loads the `artifact-design` skill first, designs the shape for the session's character (e.g., a PR-writeup shape for feature builds, a timeline shape for incidents), writes the HTML, then publishes it with the `Artifact` tool using the fixed favicon `📓`.
+4. **Vault context tracking** — two Edit calls set `vault_context_retrieved` and append a vault-context line, then redeploy via `Artifact` on the same `file_path` so the URL stays the same.
+5. **Decision extraction** — scans conversation for unrecorded decisions; prompts user via `AskUserQuestion` before invoking `/remember`.
+6. **Session tidy** — audits `.html` files in the project folder for naming and frontmatter; auto-fixes minor issues and redeploys via `Artifact`.
+
+## Conventions
+
+- Session reports use HTML — the Artifact tool publishes HTML or Markdown, and HTML gives the report designer more visual structure.
+- `write_existing_file_blocker` rejects Write on existing paths — use Edit for all vault-context updates.
+- The `Artifact` tool redeploys to the same URL on repeat calls with the same `file_path` within the current run — edits made in steps 3 and 5 to the session created this run never mint a new URL.
+- Final step copies `/rename [Project] - [Primary Outcome]` to the clipboard via `pwsh Set-Clipboard`.

package/skills/session-log/CLAUDE.md

@@ -1,32 +1 @@
-# session-log
-
-Logs a session report as a self-contained HTML page in the Obsidian vault, publishes it with the `Artifact` tool, extracts unrecorded decisions, tidies the project session folder, and outputs a `/rename` command.
-
-**Trigger:** `/session-log`, "journal this session", "log this work", "session report", "save session", "capture session", "document what we did".
-
-## Purpose
-
-Produces a self-contained HTML session report shaped to the session's character (feature build, incident, research, etc.) rather than a fixed template. The skill owns the vault path, session numbering, frontmatter contract, HTML composition and publishing, decision extraction, and folder hygiene.
-
-## Key files
-
-| File | Purpose |
-|---|---|
-| `SKILL.md` | Hub — six steps, gotchas, backend detection, run-and-report checklist. |
-| `templates/frontmatter.md` | The session-page frontmatter contract and the Step 3 notes block. |
-
-## Six steps
-
-1. **Backend detection** — headless vault (`ob --version` + `OBSIDIAN_VAULT_PATH`) then local vault (`~/.claude/vault/`). Session number from `[N]. *.html` and `[N]. *.md` files in the project folder.
-2. **Session metadata** — project name, session number, session ID from `CLAUDE_CODE_SESSION_ID`, date, title.
-3. **Compose and publish via the Artifact tool** — loads the `artifact-design` skill first, designs the shape for the session's character (e.g., a PR-writeup shape for feature builds, a timeline shape for incidents), writes the HTML, then publishes it with the `Artifact` tool using the fixed favicon `📓`.
-4. **Vault context tracking** — two Edit calls set `vault_context_retrieved` and append a vault-context line, then redeploy via `Artifact` on the same `file_path` so the URL stays the same.
-5. **Decision extraction** — scans conversation for unrecorded decisions; prompts user via `AskUserQuestion` before invoking `/remember`.
-6. **Session tidy** — audits `.html` files in the project folder for naming and frontmatter; auto-fixes minor issues and redeploys via `Artifact`.
-
-## Conventions
-
-- Session reports use HTML — the Artifact tool publishes HTML or Markdown, and HTML gives the report designer more visual structure.
-- `write_existing_file_blocker` rejects Write on existing paths — use Edit for all vault-context updates.
-- The `Artifact` tool redeploys to the same URL on repeat calls with the same `file_path` within the current run — edits made in steps 3 and 5 to the session created this run never mint a new URL.
-- Final step copies `/rename [Project] - [Primary Outcome]` to the clipboard via `pwsh Set-Clipboard`.
+@AGENTS.md