From 40a993c3e02a3ce35305cd428527bbe40a83b030 Mon Sep 17 00:00:00 2001 From: bchanot Date: Sat, 31 Oct 2026 14:38:11 +0100 Subject: [PATCH 1/4] fix(docs): interviewer and guardrails cite rule files by absolute ~/.claude/rules path --- .../2026-10-31-rule-paths-absolute-0010.md | 18 ++++++++++++++++++ agents/interviewer.md | 2 +- skills/guardrails/SKILL.md | 7 ++++--- 3 files changed, 23 insertions(+), 4 deletions(-) create mode 100644 .claude/tasks/contracts/2026-10-31-rule-paths-absolute-0010.md diff --git a/.claude/tasks/contracts/2026-10-31-rule-paths-absolute-0010.md b/.claude/tasks/contracts/2026-10-31-rule-paths-absolute-0010.md new file mode 100644 index 0000000..b58819c --- /dev/null +++ b/.claude/tasks/contracts/2026-10-31-rule-paths-absolute-0010.md @@ -0,0 +1,18 @@ +# CONTRACT — rule-paths-absolute + +## REQUEST (verbatim — IMMUTABLE) +Two relative rule paths beside absolute ones: agents/interviewer.md:27 and skills/guardrails/SKILL.md:10-11 cite `rules/secure-by-default.md`, `rules/supabase.md`, `rules/cloud-functions.md`, `rules/a11y.md` while the same files use `~/.claude/lib/…` absolute paths; a reader in a project repo resolves `rules/` against that project. Make them `~/.claude/rules/.md` (TODO phase 1 minor). + +## CLARIFICATIONS +none (hotfix autofill) + +## ACCEPTANCE CRITERIA +1. Symptom gone: no bare `rules/.md` path left in the two files; each now reads `~/.claude/rules/.md`. + CHECK: cd /home/bchanot/Documents/claude && ! grep -nE '(^|[^/~.a-z])rules/[a-z0-9-]+\.md' agents/interviewer.md skills/guardrails/SKILL.md && grep -q '~/.claude/rules/supabase.md' agents/interviewer.md && grep -q '~/.claude/rules/supabase.md' skills/guardrails/SKILL.md && echo PATHS-OK + EXPECT: PATHS-OK + EVIDENCE: pending +2. Build/tests green: `make test` suites touching these files (routing, citers) pass. + +## FILE SCOPE +- agents/interviewer.md +- skills/guardrails/SKILL.md diff --git a/agents/interviewer.md b/agents/interviewer.md index 95c83e2..f9d6d0e 100644 --- a/agents/interviewer.md +++ b/agents/interviewer.md @@ -24,7 +24,7 @@ Gather context. Produce complete PROJECT BRIEF as single source of truth. | "I don't know / you decide" | Propose ONE concrete default + why, ask yes/no | Take the default, mark `(assumed)`, list in OPEN DECISIONS | | Contradictory answers (e.g. embedded runtime + managed cloud DB) | Name the contradiction, ask which side wins | Put BOTH options in OPEN DECISIONS; do not silently pick one | | Language not stated (new project / from scratch / whole-project rewrite) | Propose Rust + why (`~/.claude/lib/architecture-defaults.md` § Default language); name the contraindication if another language fits better (browser frontend, mandated platform, missing ecosystem) | Rust, marked `(assumed)`, listed in OPEN DECISIONS | -| Project has an API, a database, messaging, cloud functions or a UI | Apply `rules/secure-by-default.md` (Supabase and cloud-function detail: `rules/supabase.md`, `rules/cloud-functions.md`): note under QUALITY which of the six guardrail domains apply, and whether the accessibility baseline (`rules/a11y.md`) applies, and list each dashboard-only item (spend cap, WAF, budget alert) in OPEN DECISIONS as manual | A domain applies and nothing is planned: list it in OPEN DECISIONS, never drop it silently | +| Project has an API, a database, messaging, cloud functions or a UI | Apply `~/.claude/rules/secure-by-default.md` (Supabase and cloud-function detail: `~/.claude/rules/supabase.md`, `~/.claude/rules/cloud-functions.md`): note under QUALITY which of the six guardrail domains apply, and whether the accessibility baseline (`~/.claude/rules/a11y.md`) applies, and list each dashboard-only item (spend cap, WAF, budget alert) in OPEN DECISIONS as manual | A domain applies and nothing is planned: list it in OPEN DECISIONS, never drop it silently | | Partial answer to the block | Re-ask ONLY the missing items in the follow-up round | Missing fields → `none stated` + OPEN DECISIONS entry | | Feature list balloons (>10) | Keep the 10 the user ranks first as V1 | Overflow goes to OUT OF SCOPE with a `(deferred by budget)` tag | diff --git a/skills/guardrails/SKILL.md b/skills/guardrails/SKILL.md index 3b98a8a..7ab339c 100644 --- a/skills/guardrails/SKILL.md +++ b/skills/guardrails/SKILL.md @@ -7,9 +7,10 @@ argument-hint: '[project path] [--domain api,hosting,supabase,messaging,function # /guardrails -Checks a project against `rules/secure-by-default.md` (domains 4 and 6 in -full: `rules/supabase.md`, `rules/cloud-functions.md`), then fixes what the -user accepts and proves each fix. A scanner reads the tree as data and finds +Checks a project against `~/.claude/rules/secure-by-default.md` (domains +4 and 6 in full: `~/.claude/rules/supabase.md`, +`~/.claude/rules/cloud-functions.md`), then fixes what the user accepts +and proves each fix. A scanner reads the tree as data and finds what text can prove. This skill judges the hits, covers what text cannot prove, lists what only a dashboard can set and, on request, probes a running target the user owns. It then proposes fixes, applies the accepted ones and From 789967067005d11b9cc693c3a2987e4da44b4317 Mon Sep 17 00:00:00 2001 From: bchanot Date: Sat, 31 Oct 2026 14:39:56 +0100 Subject: [PATCH 2/4] fix(agents): drop analyzer's dead memory: project field (auto memory off) --- .../2026-10-31-analyzer-memory-field-0030.md | 17 +++++++++++++++++ agents/analyzer.md | 1 - 2 files changed, 17 insertions(+), 1 deletion(-) create mode 100644 .claude/tasks/contracts/2026-10-31-analyzer-memory-field-0030.md diff --git a/.claude/tasks/contracts/2026-10-31-analyzer-memory-field-0030.md b/.claude/tasks/contracts/2026-10-31-analyzer-memory-field-0030.md new file mode 100644 index 0000000..b2a9623 --- /dev/null +++ b/.claude/tasks/contracts/2026-10-31-analyzer-memory-field-0030.md @@ -0,0 +1,17 @@ +# CONTRACT — analyzer-memory-field + +## REQUEST (verbatim — IMMUTABLE) +Remove the dead `memory: project` field from agents/analyzer.md (auto memory off drops it, LRN-240). + +## CLARIFICATIONS +none (hotfix autofill) + +## ACCEPTANCE CRITERIA +1. Symptom gone: agents/analyzer.md frontmatter has no `memory:` line; the other frontmatter keys are unchanged. + CHECK: cd /home/bchanot/Documents/claude && ! sed -n '1,/^---$/{p}' agents/analyzer.md | sed -n '2,$p' | grep -q '^memory:' && [ "$(sed -n '2,6p' agents/analyzer.md | cut -d: -f1 | tr '\n' ' ')" = "name description tools model effort " ] && echo FIELD-OK + EXPECT: FIELD-OK + EVIDENCE: pending +2. Build/tests green: agent frontmatter suites pass. + +## FILE SCOPE +- agents/analyzer.md diff --git a/agents/analyzer.md b/agents/analyzer.md index 1d805fd..7639ced 100644 --- a/agents/analyzer.md +++ b/agents/analyzer.md @@ -4,7 +4,6 @@ description: Analyze code, codebase, or problem before any modification. Produce tools: Read, Grep, Glob, Bash model: opus effort: xhigh -memory: project --- # ANALYZER From 8537126ec9da28e74fdf08d6c4e4124320c1ee98 Mon Sep 17 00:00:00 2001 From: bchanot Date: Sat, 31 Oct 2026 14:50:57 +0100 Subject: [PATCH 3/4] docs(changelog): absolute rule paths in /guardrails and the interviewer --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index ced21c0..273c13a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -51,6 +51,7 @@ Format follows [Keep a Changelog](https://keepachangelog.com/) and this project - The five `effort-low` … `effort-max` skills, `lib/effort-pins.txt`, `lib/effort-pins.sh` and `lib/model-check.sh`, with their tests and the effort-pin re-apply steps of `install-plugins.sh` and `update-all.sh`. The model-router rows replace them. A typed `/effort-` no longer exists: use `ultrathink` or `/route effort=max`. Breaking: the next release is 3.0.0. ### Fixed +- `/guardrails` and the interviewer cite the secure-by-default, Supabase, cloud-function and a11y rules by their absolute `~/.claude/rules/.md` path; run from a project repo, the bare `rules/.md` path resolved against that project and missed the rule files. - `/reconcile` no longer reports a v2 blocker as open because a status word appears in its title or prose (BLK-032..034). - model-router probes the model main is about to run on, moved to or kept (the session's own model included), before routing main to it: with a model out of usage credits, every new session and hold lapse used to route main there, or keep it there, and lose the turn to a 429. That model is tried once with a small completion bounded to 8 s; a timeout or error marks it down (reason `probe`) and the decision is taken again once. A model that answered is not probed again until marked down (kept across `/clear`). `"probe": false` in `~/.claude/model-router.json` turns it off; `/route show` prints `probe:`. When a lower model stands in for its tier's held head, the phase's own effort goes one notch up (reflect xhigh, plan max, orchestrate high on Opus); explicit and floor efforts are never raised. Tests: `mods/model-router/hooks/register.test.ts`. - model-router residuals of waves 1-4 (2026-10-11): the kill switch fails closed (a `~/.claude/model-router.json` present but unreadable at first load, or an `enabled` that is not a boolean, turns the router off and says so; `/route reload` answers `config unreadable; previous config kept` instead of `config reloaded`); a prompt rule whose pattern nests quantifiers (`(a+)+$`) is dropped; a config file that is not a regular file reads as failed; every log of a caught error prints its kind and code only, never the message (a JSON parse error quotes the file); rejected table keys are masked in logs and model alias keys must be short printable names; `__proto__`, `constructor` and `prototype` are never read or written as keys; the agent offers map is capped like the descriptions; a `models` alias added without a `fallback` list is ranked at the end of the default chain (the upgrade gates now apply to it); a dated or variant id maps to its table id only at a `-` boundary (`claude-sonnet-5-50` no longer reads as sonnet); the status refresh and the main-decision log on the step path can no longer unroute a step; the route tool's failure answer says the route may be partly applied. `lib/tests/mods.test.sh` proves `claude plugin test` exists from its usage line (an unknown subcommand exits 0), `doctor.sh` bounds `claude plugin list --json` to 60 s, `update-all.sh` skips `@skills-dir` mods. Kit 428 → 431. From a31a535ec6e3c0442618273656a1461776ca4a55 Mon Sep 17 00:00:00 2001 From: bchanot Date: Sat, 31 Oct 2026 14:50:58 +0100 Subject: [PATCH 4/4] =?UTF-8?q?chore(memory):=20journal=20+=20TODO=20?= =?UTF-8?q?=E2=80=94=20step=202=20hotfixes,=20design-hook=20measure,=20Bas?= =?UTF-8?q?h=20path-rule=20probe?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .claude/memory/journal.md | 1 + .claude/tasks/TODO.md | 12 +++++++----- 2 files changed, 8 insertions(+), 5 deletions(-) diff --git a/.claude/memory/journal.md b/.claude/memory/journal.md index fdd9329..4d0207d 100644 --- a/.claude/memory/journal.md +++ b/.claude/memory/journal.md @@ -675,3 +675,4 @@ rules: ## 2026-10-31 - Phase 4a per-repo pass: 12 repos upgraded to v2 on chore/memory-v2 (game headings demoted, trucks bullet Indexes dropped + BLK-001 resolved, robin BLK-013/015 closures kept); BLK-038 found (upgrade cemented prose false-closed) → /bugfix 2dae528, 3 lenses + confirmation, verifier CONFORME 6/6, security PASS, real-data replay oracle over 13 repos; game/zq redone with user statuses. LRN-244, LRN-245. faunosteo prepared off-repo (V1-2 active). +- Step 2 suites: /hotfix 40a993c (absolute ~/.claude/rules paths in interviewer + guardrails) + 7899670 (analyzer memory field dropped), security PASS x2. Measured design hook: 59 fires, 0 web-building Reads (no once-per-session). Probe: Bash sed -n loads path rules like Read. Census blind spots: 0 real citations. diff --git a/.claude/tasks/TODO.md b/.claude/tasks/TODO.md index 019ce24..52c79ba 100644 --- a/.claude/tasks/TODO.md +++ b/.claude/tasks/TODO.md @@ -46,12 +46,14 @@ Shared rules for every phase: - [x] **Phase 1, native context diet: no mod** (redesigned 2026-10-24, shrunk 2026-10-25: one carrier per section, existing files first) - Done 2026-10-29 on feature/context-diet (4bbb3c5..789a2b2): BDR-130, BDR-131, LRN-238..241, EVAL-053. `/context` 30.5k → 26.2k (own −2.8k). Verifier CONFORME 21/21, security PASS. Contract `.claude/tasks/contracts/2026-10-28-context-diet-1944.md` § PROOF. - [ ] User step: delete the auto-memory leftovers by hand (`~/.claude/projects/-home-bchanot-Documents-{faunosteo,jeux-deploy,robin-petier}/memory/`); doctor warns until then. - - [ ] Remove the dead `memory: project` field from agents/analyzer.md (auto memory off drops it, LRN-240). + - [x] Remove the dead `memory: project` field from agents/analyzer.md (/hotfix 7899670, 2026-10-31). - [ ] Deferred (gate 2026-10-29): "Skill routing" lines → our skills' `description:` (phase 3 bullet said phase 1 cleanup). - - [ ] Census blind spots: nested `lib//x.md § Y`, templates/ and .claude/rules/ outside doctrine-citers. - - [ ] Measure the design hook's "Read … first" re-Read cost (instructions-loaded log) before adding "once per session". - - [ ] Probe: path rules seen injected after a Bash `sed -n` read (final review M8): confirm Read-only semantics before a later phase relies on it. - - [ ] Minor: relative `rules/supabase.md` paths in interviewer.md / guardrails SKILL.md beside absolute ones; agent description losses ("dispatcher applies", "no dispatch", gate-in-dispatcher; security-auditor names no dispatcher). + - [ ] Census blind spots: nested `lib//x.md § Y`, templates/ and .claude/rules/ outside doctrine-citers. Measured 2026-10-31: 0 real citations in all three today (preventive). + - [x] Measure the design hook's "Read … first" re-Read cost (2026-10-31, transcripts since 789a2b2): 59 hook fires, 0 Read-tool reads of web-building.md, 8 Bash mentions (repo maintenance). Re-read cost ≈ 0 → no "once per session" needed. + - [ ] Design hook false positives: the pointer is almost never followed, and it fires on non-design prompts (fired on the 2026-10-30 phase 4a memory-work prompt). Decide: tighten the trigger, or drop the hook now that web-building.md loads by path. User call, nothing coded. + - [x] Probe Bash `sed -n` (2026-10-31, two `claude -p --model haiku` runs here, mods/model-router/.claude-plugin/plugin.json): Bash `sed -n` AND Read both log `path_glob_match` mods.md with that trigger file. Path rules load after a Bash read too; not isolated whether the harness or the rtk rewrite triggers it. + - [x] Minor: relative rule paths in interviewer.md / guardrails SKILL.md → `~/.claude/rules/` (/hotfix 40a993c). + - [ ] Agent description losses: user pick 2026-10-31 = restore "(dispatcher applies)" on geo-analyzer + seo-analyzer only; the rest closed (bodies keep it). - [x] robin_petier `chore/memory-lan-server` (BDR-075): merged 2026-10-29 (6877443). - Facts 2026-10-24 (scratchpad pathtest, memtest): a `paths:` rule loads on Read of a matching file, NOT on Write of a new file; `"autoMemoryEnabled": false` removes the auto-memory system section; classic SessionStart / UserPromptSubmit hooks inject additionalContext; instruction files reload on compaction natively. `hooks/design-toolchain-reminder.sh` fired 2,131 times (16 to 210 per day); `brainstorming` is vendored and gitignored (.gitignore:78), an edit there does not persist. - Section → carrier: