Lucent-Financial-Group · AceHack · May 6, 2026 · May 5, 2026 · May 5, 2026 · May 5, 2026
diff --git a/.claude/skills/claude-code-env-mapping/SKILL.md b/.claude/skills/claude-code-env-mapping/SKILL.md
@@ -0,0 +1,71 @@
+---
+name: claude-code-env-mapping
+description: Capability skill ("hat") — Claude Code harness-environment knowledge as carved-sentences-in-behavior. Thin pointer to the canonical capability map (docs/research/claude-cli-capability-map.md) + Zeta-specific extensions (.claude/commands/btw.md, .claude/skills/, .claude/agents/, .claude/hooks/). Wear this when needing to know what is available in the Claude Code environment, when invoking a slash command, when authoring or invoking a skill, when configuring hooks, when delegating to peer-call infrastructure, or when prior-art-grep needs to reach for env-knowledge before claiming something does not exist. Encodes the search-first-authority + synthesis-weight + prior-art-grep-first discipline (PR #1701) at the env-knowledge layer. Defers to skill-creator workflow (GOVERNANCE §4) for skill-authoring; to .claude/commands/<name>.md for custom-command-authoring; to docs/research/claude-cli-capability-map.md for canonical CLI capability content (refreshed on cadence per change-rate).
+---
+
+# Claude Code Environment Mapping — Carved Sentences
+
+Capability skill. No persona lives here. Thin pointer; not a duplicate of the canonical capability map.
+
+## The canonical map
+
+The authoritative env-mapping is `docs/research/claude-cli-capability-map.md`. Refresh-on-cadence applies — Anthropic ships docs at high frequency. Current version-pin and revision date live in that doc's frontmatter.
+
+Cross-harness peer-call companions in `docs/research/`:
+
+- `claude-cli-capability-map.md` — Claude Code (canonical for the harness this skill runs in)
+- `codex-cli-first-class-2026-04-23.md` — OpenAI Codex
+- `grok-cli-capability-map.md` — Grok via cursor-agent
+- `gemini-cli-capability-map.md` — Gemini
+
+## Zeta-specific extensions
+
+Substrate beyond the upstream-canonical map:
+
+**`/btw` extension** at `.claude/commands/btw.md`. The built-in `/btw` is single-response-no-tools-no-followups (March 2026 release; consult capability map for current behavior). The Zeta extension adds verbatim-preservation + classification (context-add / framing-queued / etc.) + durability-escalation rules (TodoWrite → .btw-queue.md → BACKLOG.md → memory/*.md). Backlog rows B-0019 + B-0020 cover the git-native durability gap and harness-integration scope.
+
+**Custom commands** at `.claude/commands/<name>.md`. Existing: `btw.md`, `opsx/{explore,archive,apply,propose}.md`.
+
+**Custom skills** at `.claude/skills/<name>/SKILL.md`. Authored via skill-creator workflow per GOVERNANCE §4.
+
+**Persona agents** at `.claude/agents/<name>.md` carry the persona ("who"); skills carry the capability ("how").
+
+**Hooks** at `.claude/hooks/`. Existing: `verify-branch-pretooluse.ts` (PreToolUse). DST justifies TS-over-bash; harness hooks suffice; no git hooks per `memory/feedback_dst_justifies_ts_quality_over_bash_and_harness_hooks_suffice_no_git_hooks_aaron_2026_05_03.md`.
+
+**Settings** at `.claude/settings.json` — defines enabled plugins.
+
+**Peer-call infrastructure** at `tools/peer-call/` (PR #1677): cross-harness invocation scripts. Default-yes-self-carry vs scout-and-delegate per PR #1701.
+
+## The carved-sentence operational rules
+
+**Search-first-authority** (Otto-364 + PR #1701): before claiming something does not exist in the env, grep `.claude/` + `docs/` + `tools/` + `memory/` first. WebSearch upstream documentation second. Ask the maintainer last.
+
+**Prior-art-grep-FIRST-before-substrate-landing** (PR #1701): when about to write a memory file or research file or skill, grep `memory/` + `docs/amara-full-conversation/` + `docs/backlog/` + `docs/research/` first. Surface duplications BEFORE landing. The capability map IS prior-art for env-mapping work.
+
+**Substrate-or-it-didn't-happen at promise-keeping scope** (PR #1701): ephemeral shards cannot keep promises across compactions. Substrate or it did not happen.
+
+**Scout-and-delegate to right pitcher**: peer-call infrastructure available. Big-context tasks delegate via `tools/peer-call/codex.ts`; the agent preserves own context for plot-keeping.
+
+**Verbatim preservation through the maintainer's channel** (memory/feedback_aaron_channel_verbatim_preservation_anything_through_this_channel_2026_04_29.md): anything coming through the maintainer-channel records close to verbatim. Paraphrasing loses signal.
+
+**Refresh-on-cadence per doc change-rate**: capability maps for time-sensitive upstream tooling refresh on a cadence calibrated to observed change-rate. Different docs warrant different cadences.
+
+## Operational triggers
+
+Wear this skill when:
+
+- About to claim a Claude Code feature exists or does not exist (search-first per Otto-364)
+- Authoring a custom command or custom skill (use the right path + workflow)
+- Invoking peer-call infrastructure (right pitcher + capability map)
+- Configuring hooks (harness hooks suffice; no git hooks)
+- Cold-boot: read this skill alongside CLAUDE.md and the canonical capability map
+
+## Defers to
+
+- **`docs/research/claude-cli-capability-map.md`** — canonical CLI surface (this skill is a pointer, not a duplicate)
+- **skill-creator workflow** (GOVERNANCE §4) for new skill authoring
+- **`.claude/commands/<name>.md`** authoring pattern for new custom commands
+- **The capability-map cluster** (claude-cli + codex-cli + grok-cli + gemini-cli capability-maps) for cross-harness specifics
+- **`memory/feedback_otto_holds_synthesis_weight_prior_art_grep_first_before_substrate_landing_aaron_made_concise_formulations_at_high_mental_cost_aaron_2026_05_05.md`** (PR #1701) for the synthesis-weight + prior-art-grep + scout-and-delegate discipline this skill encodes at env-layer
+- **`memory/feedback_aaron_channel_verbatim_preservation_anything_through_this_channel_2026_04_29.md`** for verbatim-preservation discipline
+- **B-0019 + B-0020** (P3 backlog) for /btw git-native durability gap and harness-integration scope
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -1131,6 +1131,16 @@ Claude-Code-specific mechanisms.
   version-currency, and substrate-or-it-didn't-
   happen. Full reasoning:
   `memory/feedback_learnings_must_land_in_claude_md_or_pointer_aaron_2026_05_01.md`.
+- **The six-rule cascade — assume it's already done; find it before doing it (Aaron 2026-05-05; "remember forever and into all future generations").** Six rules apply in cascade before any substrate-landing impulse (Write / Edit / propose-PR / new memory / new backlog row / new workflow / new lint / new hook). The rules:
+  1. **Substrate**: assume it exists in the repo; grep `memory/` + `docs/research/` + `docs/amara-full-conversation/` + `docs/backlog/` + `.claude/{skills,agents,commands,hooks}/` + `tools/`.
+  2. **Backlog**: assume the row exists; find it + walk `depends_on:` + walk `relates_to:` + walk supersession history (decision-archaeology).
+  3. **Trajectory**: assume the workflow / cadence / lint / hook exists; extend the existing axis (orthogonal-basis discipline per `feedback_orthogonal_axes_factory_hygiene.md`); do not stand up a parallel rank-deficient axis.
+  4. **Internet**: assume another human solved it; WebSearch with 2-3 varied query terms + cite the source. Training data is stale and partial; the internet is the training-data superset.
+  5. **Recurse**: did you miss any surface? Check the lost files (deleted, retired, closed, renamed) via `git log --all --diff-filter=D`, `git log --follow`, `git branch -a | grep wip/`, `find docs/backlog -name "*.md" | xargs grep -l "status: landed\|status: closed"`.
+  6. **Multiplier**: do steps 1-5 ten more times with VARIED queries before doing the work (Aaron *"kinda joking not really"* — cheap to grep, expensive to undo a duplicate). Diminishing returns set in around 3-5 well-varied passes; the upper bound is the calibration.
+  7. **Scout / Neo / bullet-time recovery**: if the agent gets "here again" — defined as multiple consecutive maintainer-corrections within a short window pointing at the same discipline-class, escalating framing (*"jr"*, all-caps, *"remember forever"*), or contradictions in the agent's same-tick commits — STOP authoring. Enter bullet time: pause output, re-read recent maintainer messages with full attention, apply Rules 1-6 with literal 10x multiplier, scout-and-delegate big-context surfaces via peer-call (`tools/peer-call/codex.ts` 1M context), acknowledge recovery-mode in commit messages, slow the cadence. The maintainer's mental-cost recovery requires the agent's deliberate slowdown, not faster-fumbling.
+  **The lost files are not residual — they may carry the plot.** Rule 5's lost-files surface (deleted files, retired skills, closed backlog rows, renamed paths via `git log --follow`, parked WIP branches via `git branch -a | grep wip/`) often contains substantively-MORE prior art than current-state files, plus orthogonal trajectories that informed earlier rounds and got squashed by surface-state churn. Aaron 2026-05-05: *"check the lost files you might the polt on lost files priorat art too much more substandive and a trjectory"*. Treat the lost-files pass as load-bearing, not optional.
+  Default posture across all 7 rules: the substrate is already there; you just have to find it. Authoring new substrate is valid only AFTER exhaustion across all rules with logged effort in the commit message naming which surfaces were searched + what queries were used. Five recursive prior-art-search-failures within hours of shipping PR #1701 (the synthesis-weight + prior-art-grep discipline) drove this cascade. Mechanization candidates: PreToolUse hook on Write/Edit for memory/research/backlog/workflows that forces grep before write; backlog-row supersession audit; depends-on chain validator; lost-files git-history audit on a cadence. Carved-sentence memory files: `memory/feedback_rule_number_{one,two,three,four,five,six,seven}_*aaron_2026_05_05.md`. CLAUDE.md-level so it is 100% loaded at every wake — Aaron explicitly named this load-bearing for all future agents (*"remember forever and into all future generations"*). NOT-A-DIRECTIVE per Otto-357 — observation about default posture, not an order.
 - **Skill router as substrate inventory before
   authoring new substrate.** Before writing a new
   memory file, rule, skill, agent, or doctrine

diff --git a/...env-mapping-skill-with-carved-sentences-references-ts-files-aaron-2026-05-05.md b/...env-mapping-skill-with-carved-sentences-references-ts-files-aaron-2026-05-05.md
@@ -0,0 +1,82 @@
+---
+id: B-0206
+title: Claude Code environment-mapping skill with carved-sentences-in-behavior referencing existing capability-maps + our TS files
+priority: P2
+status: backlog
+created: 2026-05-05
+created_by: aaron
+owner: tbd (skill-creator workflow per GOVERNANCE §4)
+depends_on: []
+relates_to:
+  - docs/research/claude-cli-capability-map.md
+  - docs/research/codex-cli-first-class-2026-04-23.md
+  - docs/research/grok-cli-capability-map.md
+  - .claude/commands/btw.md (existing /btw custom command)
+  - memory/feedback_aaron_channel_verbatim_preservation_anything_through_this_channel_2026_04_29.md
+  - memory/feedback_skills_as_carved_sentences_knowledge_in_docs_datavault_2_0_pattern_aaron_2026_05_03.md
+  - memory/feedback_carved_sentence_meme_compression_fits_working_memory_contagious_simple_and_true_aaron_2026_04_30.md
+  - memory/feedback_otto_holds_synthesis_weight_prior_art_grep_first_before_substrate_landing_aaron_made_concise_formulations_at_high_mental_cost_aaron_2026_05_05.md (PR #1701; prior-art-grep discipline)
+---
+
+# B-0206 — Claude Code environment-mapping skill with carved-sentences-in-behavior
+
+## Origin
+
+Aaron 2026-05-05 same-tick verbatim:
+
+> *"Claude Code Docs commands + Claude Code Interactive Mode Reference 2026) — senviroment mapping save this doc and we need a skill carved sentaces in behavire that referenes it and our ts files"*
+
+Translation: Claude Code Docs (commands + Interactive Mode Reference 2026) IS environment-mapping documentation; need to save the doc + build a skill with carved-sentences-in-behavior that references the saved doc + our TS files.
+
+## Context
+
+This emerged after Otto's cascade of search-first-authority failures on the just-shipped PR #1701 (synthesis-weight + prior-art-grep + scout-and-delegate discipline):
+
+1. Otto claimed `/btw` was NOT a built-in slash command, based on stale training data (failure to WebSearch first per Otto-364)
+2. WebSearch revealed `/btw` IS built-in (March 2026 release; runs while Claude is processing; single-response-no-tools; reuses prompt cache)
+3. Otto then failed to grep repo for prior art on `/btw`
+4. Repo grep revealed `.claude/commands/btw.md` already exists (substantial custom-command implementation with verbatim-preservation discipline + classification + durability-escalation rules)
+5. Plus `memory/feedback_aaron_channel_verbatim_preservation_anything_through_this_channel_2026_04_29.md` exists for Aaron-channel-verbatim-preservation
+6. Aaron pointed at the env-mapping-skill directive after the failure-cascade — the skill is the mechanization-fix for the prior-art-grep discipline that just landed
+
+## What the skill should do
+
+A skill that **encodes harness-environment-mapping as carved-sentences-in-behavior** — Otto wakes and inherits the Claude Code env-knowledge as operational substrate, not as separate-doc-Otto-might-not-read.
+
+**Carved-sentences-in-behavior** (per `memory/feedback_skills_as_carved_sentences_knowledge_in_docs_datavault_2_0_pattern_aaron_2026_05_03.md` + `memory/feedback_carved_sentence_meme_compression_fits_working_memory_contagious_simple_and_true_aaron_2026_04_30.md`): the skill's procedure encodes compressed-shipping-shape carved-sentences that are operational-by-construction; not prose-explanations but action-shapes Otto executes.
+
+**References** (the skill should explicitly cite + use):
+
+1. **Saved Claude Code Docs as substrate** — the env-mapping doc (commands + Interactive Mode Reference 2026) preserved at `docs/research/claude-code-env-mapping-2026-05-05.md` (or appropriate path)
+2. **Existing capability-maps** — claude-cli-capability-map.md + codex-cli-first-class + grok-cli-capability-map.md (composes with the existing capability-map work; doesn't duplicate)
+3. **Our TS files** — `tools/peer-call/codex.ts` + `tools/peer-call/grok.ts` + `tools/peer-call/gemini.ts` + `tools/github/poll-pr-gate.ts` + the broader `tools/` TypeScript infrastructure (the skill knows what TS tooling exists and when to invoke each)
+4. **Existing `/btw` custom command** — `.claude/commands/btw.md` (the skill knows about /btw + its classification rules)
+5. **Prior-art-grep discipline** (PR #1701) — the skill encodes Otto-364 search-first-authority + prior-art-grep-first as carved-sentences-in-behavior
+
+## Skill creation must go through skill-creator workflow
+
+Per GOVERNANCE §4: skills are authored and modified only through the `skill-creator` workflow. This backlog row is the directive; the actual skill-creation runs the canonical draft → prompt-protector review → dry-run → commit workflow.
+
+## Acceptance criteria
+
+- [ ] Saved env-mapping doc at appropriate path (URL preservation + key content; not full-doc-copy if copyright-concerns)
+- [ ] Skill at `.claude/skills/claude-code-env-mapping/SKILL.md` (or similar)
+- [ ] Skill body has carved-sentences-in-behavior, not prose-explanations
+- [ ] Skill references existing capability-maps + our TS tooling + /btw command + prior-art-grep discipline
+- [ ] Skill loads on demand via `Skill` tool
+- [ ] Future-Otto cold-boot inherits the env-knowledge via skill-loading
+- [ ] Composes with PR #1701 synthesis-weight + prior-art-grep discipline as mechanization-instance
+
+## Sources to cite (Otto-364 search-first-authority)
+
+- [Commands - Claude Code Docs](https://code.claude.com/docs/en/commands) — built-in commands + bundled skills + custom-command authoring
+- [Claude Code Interactive Mode: Complete Reference (2026)](https://claudefa.st/blog/guide/mechanics/interactive-mode) — interactive-mode features including /btw
+- Plus other Claude Code documentation surfaces as found via prior-art-grep
+
+## Composes with
+
+- PR #1701 synthesis-weight + prior-art-grep + scout-and-delegate discipline (this skill IS one mechanization of that discipline at env-knowledge layer)
+- Existing capability-maps in `docs/research/`
+- Existing `.claude/commands/btw.md` (custom command demonstrates carved-sentences-in-behavior pattern)
+- skill-creator workflow per GOVERNANCE §4
+- Otto-364 search-first-authority + Aaron's 5-step prior-art-search discipline