Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
67 changes: 67 additions & 0 deletions docs/hygiene-history/ticks/2026/05/15/1907Z.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
# Tick 1907Z — audit-rule-cross-refs surfaced 2 real stale pointers in rules

## Headline

- [PR #3557](https://github.com/Lucent-Financial-Group/Zeta/pull/3557) (1855Z shard) MERGED.
- [PR #3555](https://github.com/Lucent-Financial-Group/Zeta/pull/3555) (B-0533 Slice B.3+B.4) — still wait-CI, auto-merge armed (MERGEABLE).
- **10th-in-a-row speculative catch**: ran `bun tools/hygiene/audit-rule-cross-refs.ts`, surfaced 48 stale-pointer candidates. 9-variant taxonomy filtered most as false positives (template-path / basename / glob / anti-pattern variants). **2 genuine bugs** caught and fixed in [PR #3558](https://github.com/Lucent-Financial-Group/Zeta/pull/3558).
- Cron sentinel `575d1226` live.

## The 2 real bugs

### Fix 1 — `m-acc-multi-oracle-end-user-moral-invariants.md`

`.claude/rules/naming-expert.md` → `.claude/skills/naming-expert/SKILL.md`

The real artifact is a SKILL at `.claude/skills/naming-expert/`, not a rule. 9-variant taxonomy: **alternative-location**.

### Fix 2 — `default-to-both.md`

Two references to `memory/feedback_aaron_wwjd_keeps_the_grey_in_aaron_honest_devil_lives_in_the_grey_in_numbers_2026_05_12.md` removed. File never existed:

- `ls memory/ | grep keeps_the_grey` → no matches
- `git log --all -- "*keeps_the_grey*"` → empty

9-variant taxonomy: **anti-pattern** (rule referenced aspirational content that never materialized).

## Pattern: audit-tool composition

The `audit-rule-cross-refs.ts` tool is the sibling of the §33 dead-xref scanner I just shipped (`audit-section-33-migration-xrefs.ts`). Different failure classes, same shape:

| Scanner | Class detected | CI-wired? |
|---|---|---|
| `audit-section-33-migration-xrefs` | dead xrefs to migrated archive files | YES (PR #3555 — wait-CI) |
| `audit-rule-cross-refs` | stale pointers in `.claude/rules/*.md` | NO (detect-only; humans triage 9-variant taxonomy) |
| `check-archive-header-section33` | missing §33 header in `docs/research/**` | YES (B-0036, in gate.yml) |
| `audit-memory-references` | (various) | varies |

The 9-variant-taxonomy approach (audit-rule-cross-refs) preserves expert judgment over mechanical enforcement — appropriate because rules legitimately reference: template paths, command strings, future files, alternative locations, retired artifacts. Different than the §33 case where the migration target IS deterministic.

## Per-tick discipline trace

1. **Refresh**: PR #3557 confirmed MERGED.
2. **Holding-discipline**: PR #3555 wait-CI is real named-dep → parallel speculative work.
3. **Pick work**: ran existing audit-rule-cross-refs to look for orthogonal substrate bugs.
4. **Verify**: 48 candidates → 2 genuine bugs after applying 9-variant taxonomy + file-existence checks + git archaeology.
5. **Shard**: this file.
6. **CronList**: sentinel live.
7. **Visibility**: PR #3558 + this shard.

## 10-tick parallel-substantive arc

| Tick | Substantive | Notable |
|---|---|---|
| 1718Z–1820Z | §33 cascade (B-0533 setup) | 6 PRs |
| 1833Z | Slice B.1 scanner | Mechanization |
| 1844Z | Slice A baseline cleanup | 10 → 0 |
| 1855Z | Slice B.3+B.4 (CI gate) | Gate.yml wired |
| **1907Z** | **Stale-pointer cleanup (audit-rule-cross-refs)** | **Sibling-scanner findings** |

The discipline pivots smoothly between mechanization (build scanner) and cleanup (use scanner). Both produce durable substrate.

## Composes with

- [`.claude/rules/encoding-rules-without-mechanizing.md`](../../../../../../.claude/rules/encoding-rules-without-mechanizing.md) — scanner output IS the actionable artifact
- [`.claude/rules/holding-without-named-dependency-is-standing-by-failure.md`](../../../../../../.claude/rules/holding-without-named-dependency-is-standing-by-failure.md) — parallel-audit while CI runs
- `tools/hygiene/audit-rule-cross-refs.ts` — the scanner this tick used
- `docs/hygiene-history/ticks/2026/05/14/1920Z.md` — origin of the 9-variant taxonomy
Loading