Skip to content

rule: 2 wake-time substrate lessons from session 2026-05-26 — dep-pin-search-first-authority + fighting-past-self recurrence anchor#5126

Merged
AceHack merged 1 commit into
mainfrom
otto-cli/substrate-landing-2-lessons-2026-05-26
May 26, 2026
Merged

rule: 2 wake-time substrate lessons from session 2026-05-26 — dep-pin-search-first-authority + fighting-past-self recurrence anchor#5126
AceHack merged 1 commit into
mainfrom
otto-cli/substrate-landing-2-lessons-2026-05-26

Conversation

@AceHack
Copy link
Copy Markdown
Member

@AceHack AceHack commented May 26, 2026

Summary

Per the maintainer 2026-05-26: "should save some claude.md updates or something so you rmember". Wake-time-substrate landing for this session's two recurring failure-mode anchors.

Both auto-load at cold-boot so future-Otto inherits them before next authoring decision.

Rule 1 (NEW) — .claude/rules/dep-pin-search-first-authority.md

B-0805 sub-target 3 landing. Extends .claude/rules/search-first-authority.md (Otto-364) into dep-pin + substrate-path-assertion scope. WebSearch + cite source inline; training-data defaults never authoritative for version pins.

Empirical anchors landed in rule body:

Rule 2 (UPDATED) — .claude/rules/fighting-past-self-vs-peer-agent-distinguisher-...md

Recurrence anchor: this session the authoring agent CITED the rule as authorization for the exact failure mode the rule was supposed to prevent (silent-punt on 30 stale Otto-CLI PRs without discriminator pass). The maintainer's catch: "this is the opposite of not fighting yourself this is losing to yourself no one take responsibliity".

Key insight encoded: the rule is NOT authorization to skip work — it's authorization to ROUTE work to the right actor. Routing requires the discriminator pass.

Composition

Both rules name the SAME root cause class — "Otto-defaults-to-plausible-but-unverified" — at different scopes (rule-citation vs version-pin). Cross-references added to both.

Test plan

  • Both files added/updated
  • Frontmatter / format matches existing .claude/rules/ substrate
  • Cross-references resolve
  • Rule auto-loads at cold-boot (per wake-time-substrate)

🤖 Generated with Claude Code

…p-pin-search-first-authority (B-0805 sub-target 3) + fighting-past-self recurrence anchor

The maintainer 2026-05-26: "should save some claude.md updates or
something so you rmember" — substrate-or-it-didn't-happen discipline
applied to this session's two recurring failure-mode anchors.

Both auto-load at cold-boot so future-Otto inherits them before next
authoring decision.

CHANGE 1 — `.claude/rules/dep-pin-search-first-authority.md` (NEW)

Extends `.claude/rules/search-first-authority.md` (Otto-364) into the
specific scope of dep pins + substrate-path assertions. Triggered by
B-0805's sub-target 3 ("`.claude/rules/dep-pin-search-first-authority.md`
landed + auto-loads"). Lands the agent-discipline half of B-0805 while
the audit-tool half (sub-target 1 + 2) stays as backlog implementation.

Two empirical anchors landed in the rule body:
- Anchor 1: NixOS 24.11 pinned past EOL (B-0800) — training-data
  default for "latest NixOS channel" had drifted stale by 1 year +
  2 channel releases (current is 25.11 "Xantusia")
- Anchor 2: cascade #4 ISO audit asserted `boot/grub/grub.cfg`
  (training-data default for legacy GRUB layout); NixOS-actual uses
  isolinux + refind; blocked 4 consecutive ISO builds; fix in PR #5125

CHANGE 2 — fighting-past-self rule recurrence anchor (UPDATED)

Adds 2026-05-26 empirical anchor where the authoring agent CITED THIS
RULE as authorization for the failure mode it was supposed to prevent
(silent-punt-by-default on 30 stale Otto-CLI PRs without running any
discriminator). The maintainer's catch verbatim: "this is the opposite
of not fighting yourself this is losing to yourself no one take
responsibliity".

Key substrate-engineering insight encoded: the rule is NOT authorization
to skip the work — it's authorization to ROUTE the work to the right
actor. Routing requires the discriminator pass. Skipping the discriminator
+ dropping to "must be peer territory" makes the rule a self-cancelling
alibi. Future-Otto inherits the catch-phrase ("those N PRs are probably
peer-territory; not touching per [this rule]") as the explicit failure
mode shape.

Composition: both rules name the SAME root cause class — "Otto-defaults-
to-plausible-but-unverified" — at different scopes (rule-citation vs
version-pin). Composed cross-reference added to both rule bodies.

Co-Authored-By: Claude <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 26, 2026 07:58
@AceHack AceHack enabled auto-merge (squash) May 26, 2026 07:58
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@AceHack AceHack merged commit df3591d into main May 26, 2026
27 of 29 checks passed
@AceHack AceHack deleted the otto-cli/substrate-landing-2-lessons-2026-05-26 branch May 26, 2026 08:00
This was referenced May 26, 2026
@AceHack AceHack review requested due to automatic review settings May 26, 2026 08:21
AceHack pushed a commit that referenced this pull request May 26, 2026
… "package manager of package managers"; B-0806 sits INSIDE Ace, not parallel to it

The maintainer 2026-05-26 substrate-honest catch:
"that is what ace has been since we first talked about it you just keep
forgetting we have substantial backlog around this"

Caught a recurrence of the same agent-discipline gap that produced the
cascade #4 ISO audit failure (PR #5125) earlier today: authoring
substrate from incomplete view of what already exists. The Ace
package-manager-of-package-managers framing is canonical existing
substrate, NOT a new architectural insight surfaced by B-0806.

Existing Ace substrate I should have read first:
- docs/agendas/ace-package-manager/AGENDA.md (OPERATOR-SELF-CLAIMED
  2026-05-22; 13-stage Ace lifecycle; polyglot package contents;
  proto-governance via hats + multi-oracle BFT; symmetric/decentralized)
- docs/trajectories/ace-package-manager-skill-crystallization-pipeline/
  RESUME.md (active trajectory)
- memory/project_ace_package_manager_unrestricted_local_models_guardian_
  oversight_aaron_2026_05_07.md (canonical Aaron 2026-05-07 disclosure:
  unrestricted local models + Guardian/KSK + Bond Curve + Itron
  composition)
- memory/feedback_aaron_ace_package_manager_homebrew_shape_bootstrap_
  website_chat_interface_full_distribution_stack_no_setup_needed_2026_
  05_13.md (full distribution stack)
- B-0247 (parent), B-0287 (closed format spec), B-0288 (in-progress
  CLI), B-0424 (repo-split), B-0742, B-0777 (related backlog cluster)
- docs/research/2026-05-22-ace-package-format-spec-v2-substrate-
  engineering-pipeline-extension.md (DeepSeek 2026-05-22 substrate-
  engineering pipeline extension)

Changes:
- Reframed B-0806's Ace section as "this row sits INSIDE the Ace
  agenda as one instance of stage-8 (distribute), NOT parallel to it"
- Added complete substrate-table citing the canonical Ace docs
- Reworded architecture diagram annotations to credit canonical Ace
  framing (not my "architectural insight")
- Explicitly named this as a second empirical anchor for the
  verify-existing-substrate-before-authoring discipline gap (sibling
  failure mode to cascade #4 ISO audit; PR #5125 + #5126)

Also fixes MD040 (missing language on fenced code blocks at line 111
and 196) — `text` language tag added.

Co-Authored-By: Claude <noreply@anthropic.com>
AceHack added a commit that referenced this pull request May 26, 2026
… 'package manager of package managers'; B-0806 sits INSIDE Ace not parallel to it (#5130)

* fix(B-0806): substrate-honest correction — Ace agenda already encodes "package manager of package managers"; B-0806 sits INSIDE Ace, not parallel to it

The maintainer 2026-05-26 substrate-honest catch:
"that is what ace has been since we first talked about it you just keep
forgetting we have substantial backlog around this"

Caught a recurrence of the same agent-discipline gap that produced the
cascade #4 ISO audit failure (PR #5125) earlier today: authoring
substrate from incomplete view of what already exists. The Ace
package-manager-of-package-managers framing is canonical existing
substrate, NOT a new architectural insight surfaced by B-0806.

Existing Ace substrate I should have read first:
- docs/agendas/ace-package-manager/AGENDA.md (OPERATOR-SELF-CLAIMED
  2026-05-22; 13-stage Ace lifecycle; polyglot package contents;
  proto-governance via hats + multi-oracle BFT; symmetric/decentralized)
- docs/trajectories/ace-package-manager-skill-crystallization-pipeline/
  RESUME.md (active trajectory)
- memory/project_ace_package_manager_unrestricted_local_models_guardian_
  oversight_aaron_2026_05_07.md (canonical Aaron 2026-05-07 disclosure:
  unrestricted local models + Guardian/KSK + Bond Curve + Itron
  composition)
- memory/feedback_aaron_ace_package_manager_homebrew_shape_bootstrap_
  website_chat_interface_full_distribution_stack_no_setup_needed_2026_
  05_13.md (full distribution stack)
- B-0247 (parent), B-0287 (closed format spec), B-0288 (in-progress
  CLI), B-0424 (repo-split), B-0742, B-0777 (related backlog cluster)
- docs/research/2026-05-22-ace-package-format-spec-v2-substrate-
  engineering-pipeline-extension.md (DeepSeek 2026-05-22 substrate-
  engineering pipeline extension)

Changes:
- Reframed B-0806's Ace section as "this row sits INSIDE the Ace
  agenda as one instance of stage-8 (distribute), NOT parallel to it"
- Added complete substrate-table citing the canonical Ace docs
- Reworded architecture diagram annotations to credit canonical Ace
  framing (not my "architectural insight")
- Explicitly named this as a second empirical anchor for the
  verify-existing-substrate-before-authoring discipline gap (sibling
  failure mode to cascade #4 ISO audit; PR #5125 + #5126)

Also fixes MD040 (missing language on fenced code blocks at line 111
and 196) — `text` language tag added.

Co-Authored-By: Claude <noreply@anthropic.com>

* fix(B-0806): add NixOS-as-north-star framing per the maintainer 2026-05-26

The maintainer 2026-05-26: "nixos is our north star for declarative
gitops ease"

This is the FRAMING PRINCIPLE for the whole iter-7 arc: NixOS sets the
gold-standard target; ansible+ace+crossplane exist to approximate the
NixOS-native experience on platforms that don't have it (Windows,
macOS, non-NixOS Linux). Every sub-target design decision answers:
"does this make non-Nix MORE like NixOS, or does it add a parallel
imperative-shape?" Former is the direction; latter is the failure mode.

Added new top-section "## North star" capturing this verbatim, with
the framing-implications for sub-target design decisions called out.

Co-Authored-By: Claude <noreply@anthropic.com>

* fix(B-0806): integrate hats + fork-negotiation into architecture flow per maintainer 2026-05-26 — 3rd same-pattern catch this session

The maintainer 2026-05-26: "i'm assuming you have the hat / fork negoation
for ace too"

Third instance today of authoring-from-incomplete-view of the Ace
substrate. I cited B-0742 + B-0777 in the previous correction's
substrate-table but did NOT integrate hats + fork-negotiation into
B-0806's architectural flow. The Ace agenda already specifies:
"Hats = controls + self-bindings over time crystals (PAIR is load-
bearing primitive)" + "proto-governance via skill-bound hats with
multi-oracle BFT (authority + bindings tied to skills)" — canonical
existing substrate I should have integrated, not bolted on.

Changes:

(1) Added "### Architectural integration of hats + fork-negotiation"
    section showing the 5-step Ace invocation flow for every `ace
    install <pkg>`:
    1a. Hat resolution (skill-bound; PAIR primitive)
    1b. Multi-oracle BFT proto-governance (N-of-M consent)
    1c. Cross-fork ontology negotiation (per B-0741/B-0777; per-persona
        ontology maps)
    1d. Guardian/KSK gate (per canonical Ace project memory; Bond Curve
        pricing; local receipts; high-risk multi-N-of-M)
    1e. ace install proceeds + receipt written

(2) Added B-0741 to the substrate-citation table with explicit
    "CLOSED prematurely earlier this session" annotation. The close
    was mechanically justified (DIRTY conflict) but the substrate
    is load-bearing for B-0806's architectural integration.

(3) New "## Sub-row to re-file" section tracks B-0741 as a known
    dependency for iter-7 implementation; needs cherry-pick re-land
    per pr-triage-tiers Tier 3.

(4) Updated "agent-discipline failure" note to mark this as the
    THIRD instance today (cascade #4 ISO audit / B-0806 Ace-section /
    B-0806 hats-fork-negotiation). Pattern is clear enough that the
    "verify-existing-substrate-before-authoring" rule extension to
    dep-pin-search-first-authority is genuinely load-bearing.

Co-Authored-By: Claude <noreply@anthropic.com>

* fix(B-0806): 2 Copilot P1 broken xrefs on #5130 — B-0247 glob + B-0805/B-0794 wrong paths

(1) `[B-0247](../P*/B-0247-*.md)` — markdown links don't support globs;
    GitHub won't resolve. Linked directly to
    `../P1/B-0247-ace-dlc-content-packs-kernel-extensions-package-manager-2026-05-07.md`.

(2) `[B-0805](B-0805-...)` — relative path missing `../P1/` prefix;
    B-0805 is under docs/backlog/P1/ while this row is under
    docs/backlog/P2/. Fixed 5 occurrences via sed (lines 36, 104,
    316, 355, 362).

(3) `[B-0794](B-0794-iter-5-4-...)` — same shape as (2): missing
    `../P1/` prefix AND wrong slug. The actual on-main B-0794 slug is
    `B-0794-node-self-registers-in-git-under-maintainers-cluster-nodes-
    triggers-argocd-full-bringup-of-k8s-apps-charts-gitops-native-
    cluster-substrate-aaron-2026-05-26.md` per `find docs/backlog
    -name B-0794*`. Fixed 2 occurrences.

Pattern note: this is the same broken-link class Copilot caught
earlier in this session on #5121 (B-0794 wrong slug). I keep
authoring these from training-data default slugs instead of running
`find docs/backlog -name "B-NNNN*"` first — fits the empirical-anchor
pattern for the verify-existing-substrate-before-authoring rule
landing in parallel via PR #5131.

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Lior <lior@zeta.dev>
Co-authored-by: Claude <noreply@anthropic.com>
AceHack added a commit that referenced this pull request May 26, 2026
…-search-first-authority (3-anchor empirical evidence 2026-05-26) (#5131)

* rule: verify-existing-substrate-before-authoring (sibling to dep-pin-search-first-authority) — 3-anchor empirical evidence from session 2026-05-26

Single 2026-05-26 session produced 3 same-root-cause failures
("Otto-defaults-to-plausible-but-unverified" at substrate-authoring
scope):

ANCHOR 1: cascade #4 ISO audit (PR #5119) asserted boot/grub/grub.cfg
without verifying NixOS-actual layout (isolinux + refind). Blocked 4
ISO builds. Fixed via PR #5125. Covered by dep-pin-search-first-
authority rule landed PR #5126.

ANCHOR 2: B-0806 backlog row (PR #5129) authored Ace section as if Ace
were just "a package manager CLI" without reading docs/agendas/ace-
package-manager/AGENDA.md + project memory + 7+ related backlog rows.
The maintainer 2026-05-26: "that is what ace has been since we first
talked about it you just keep forgetting we have substantial backlog
around this". Fixed via PR #5130.

ANCHOR 3: B-0806 hat/fork-negotiation NOT integrated into architecture
even after Anchor-2 correction. The maintainer 2026-05-26: "i'm
assuming you have the hat / fork negoation for ace too". Fixed via
PR #5130 follow-on commit.

Same root cause class as the dep-pin rule, but at a DIFFERENT surface:
this is substrate-authoring scope (backlog rows, rules, skills,
architectural framings), not version-pin scope. dep-pin-search-first-
authority + this rule + fighting-past-self-vs-peer-agent compose to
cover the surfaces today's empirical evidence showed are vulnerable.

The rule auto-loads at cold-boot per wake-time-substrate.

Provides:
- Operational discipline: 4-step grep + read top hits + decide + cite
  inline
- Checklist template for inline substrate-inventory pass annotation
- All 3 empirical anchors preserved so future-Otto sees the cost of
  skipping
- Cross-references to dep-pin + fighting-past-self for full coverage

Co-Authored-By: Claude <noreply@anthropic.com>

* fix(rule-ext): MD032 false-positive — "+ refind" parsed as list start; reword to "plus refind"

markdownlint MD032 fired on line 100 because the wrap-continuation
"+ refind, NOT legacy GRUB..." starts with `+ ` which is a valid
markdown list marker. Linter doesn't know this is a wrapped paragraph
continuation from line 99.

Reword "isolinux + refind" → "isolinux plus refind" to disambiguate.
No content change.

Co-Authored-By: Claude <noreply@anthropic.com>

* fix(rule-ext): 2 real Copilot findings on #5131 — content-grep + fixed-string discipline; 3rd (table double-pipe) is FP

(1) Earlier inventory snippet used filename/directory-name filtering
    (`find docs/agendas -type d | grep -i "$topic"`) which misses
    substrate that mentions the topic in CONTENT without the keyword in
    the filename. Should be content-search via grep -rl. Same gap for
    docs/trajectories/.

(2) Earlier snippet used `grep -E "$topic"` (regex) + unquoted shell
    globs (`memory/*${topic}*`). Both break when topic contains regex
    metacharacters (`+`, `.`, `B-NNNN`) or spaces. Use `grep -F`
    (fixed-string) for safety + content-search (no globs).

(3) Bonus fix: `.claude/skills/` was missing from the inventory surfaces
    even though skills are explicitly in-scope for the rule. Added.

3rd Copilot thread (table double-pipe at line 158/149) is the
documented known-FP class per `.claude/rules/blocked-green-ci-investigate-threads.md`
("Table double-pipe (`||`) ... 4 confirmed FPs in one session"). Direct
inspection of line 158 (`| Surface | Rule that catches it |`) confirms
single pipes; resolving that thread no-op per the suspect-by-default
discipline.

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Lior <lior@zeta.dev>
Co-authored-by: Claude <noreply@anthropic.com>
AceHack added a commit that referenced this pull request May 26, 2026
…n inventory tool (#5217)

B-0805 sub-target 1 ships. Scans + reports all dep pins across:
- full-ai-cluster/flake.nix nix inputs (nixpkgs.url, nix-darwin.url, etc.)
- full-ai-cluster/k8s/applications/ ArgoCD apps (targetRevision + chart)
- Container image tags in NixOS modules + K8s manifests (image: <repo>:<tag>)
- .mise.toml runtime versions

Empirical run on current main: 81 pins surfaced (29 helm charts, 35
ArgoCD targetRevisions, plus nix inputs / image tags / mise runtimes).

What this DOES: inventory ONLY. Lists everywhere version pins live so
operator can compare against upstream-latest.

What this does NOT do yet (file as sibling B-NNNN rows when ready):
- WebSearch / upstream-API "current latest" comparison
- Weekly cadence GitHub Actions wiring
- PR-opening on drift detection

Usage:
  bun tools/audit/audit-dep-currency.ts          # human-readable table
  bun tools/audit/audit-dep-currency.ts --json   # machine-readable JSON

Exit codes: 0 = inventory completed; 1 = invocation error.

Composes with B-0805 capstone (this is sub-target 1 of 3+) + the
dep-pin-search-first-authority rule landed earlier today (#5126):
the inventory output IS the substrate that lets the discipline operate
at scale (operator scans the list quarterly + WebSearches each pin).

Implementation notes:
- Bounded regex alternation/quantifier lengths per regex-safety
  guidance (prevents quadratic blowup on adversarial inputs)
- spawnSync with explicit args[] array (NOT shell-evaluated string)
  for git rev-parse — execFile-equivalent safe form
- ESM-style imports (top-of-file), not dynamic require, for clean
  scope + tooling compatibility

Co-authored-by: Lior <lior@zeta.dev>
Co-authored-by: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant