Skip to content
Merged
Show file tree
Hide file tree
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
Original file line number Diff line number Diff line change
Expand Up @@ -113,14 +113,17 @@ Read source: `docs/backlog/P1/B-0173-hook-authoring-for-skill-creation-contracts

**Initial recovery (PR #1280) was wrong.** The B-0173 row body lists 3 hook integrations including 2 git hooks; my recovery section reproduced that. **Aaron 2026-05-03 clarification** (see `memory/feedback_dst_justifies_ts_quality_over_bash_and_harness_hooks_suffice_no_git_hooks_aaron_2026_05_03.md`): vibe-coders always have a harness; harness hooks suffice; git hooks are antipattern in this scope. **Corrected scope is harness hooks + CI only, NOT git hooks.**

Two hook integrations (CORRECTED, NOT three) — deliverables of B-0173:
**Two hook integrations** (CORRECTED, NOT three) — actual deliverables of B-0173 going forward:

1. ~~`tools/git/hooks/pre-commit`~~ — REMOVED per Aaron's clarification. Harness fires on pre-tool-use (Edit/Write) before content lands; covers the same use case
2. ~~`tools/git/hooks/commit-msg`~~ — REMOVED per Aaron's clarification. Harness fires on pre-Bash-tool-use when command is `git commit`; covers the same use case
3. **Harness hooks** *(proposed; new in correction)* — Claude Code `.claude/settings.json` hooks field, with parallel mechanisms for Codex / Cursor / etc.; called via the harness's runtime; TS-canonical
4. **`.github/workflows/substrate-claim-checker.yml`** *(proposed)* — CI check on PR descriptions (host-authored; runs on PR creation)
1. **Harness hooks** *(proposed; new in correction)* — Claude Code's `.claude/settings.json` hooks FIELD (the file `.claude/settings.json` itself already exists on main, but the `hooks` field within it is not yet populated), with parallel mechanisms for Codex / Cursor / etc.; called via the harness's runtime; TS-canonical
2. **`.github/workflows/substrate-claim-checker.yml`** *(proposed)* — CI check on PR descriptions (host-authored; runs on PR creation)
Comment thread
AceHack marked this conversation as resolved.

As of correction time (2026-05-03), neither `.claude/settings.json` hooks nor the workflow file exist on main. These are B-0173 row deliverables. **Do NOT implement git hooks for B-0173** — that's the wrong shape per Aaron's clarification.
**Removed from scope** (the original recovery had these as "proposed" too; Aaron's clarification removes them entirely):

- ~~`tools/git/hooks/pre-commit`~~ — Harness fires on pre-tool-use (Edit/Write) before content lands; covers the same use case
- ~~`tools/git/hooks/commit-msg`~~ — Harness fires on pre-Bash-tool-use when command is `git commit`; covers the same use case

As of correction time (2026-05-03), the `hooks` field in `.claude/settings.json` is not yet populated, and `.github/workflows/substrate-claim-checker.yml` does not exist on main. Both are B-0173 row deliverables. **Do NOT implement git hooks for B-0173** — that's the wrong shape per Aaron's clarification.

depends_on: **[B-0170 (substrate-claim-checker tool) + B-0171 (OpenSpec catch-up — contracts live in specs)]**

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ This memo's table covers **end-user personas** (axis 2). Internal named-agent pe
| **Maintainer** (also runs install) | Human | Yes | Same as contributor |
| **Skill-bundle user** (uses plugins via harness) | Human | Only via harness's runtime | Harness hooks only |
| **PR Copilot reviewer** (default static) | AI | N/A — doesn't execute | Static analysis only; reads + flags issues |
| **PR Copilot reviewer** (with `copilot-setup-steps.yml`) | AI | Yes (via our setup) | Both bash + TS executable; can verify findings by running tools |
| **PR Copilot reviewer** (HYPOTHETICAL — if we adopt a `copilot-setup-steps.yml` workflow; not currently in the repo) | AI | Yes (via our setup, IF that workflow exists) | Both bash + TS would be executable; could verify findings by running tools |
Comment thread
AceHack marked this conversation as resolved.
| **Other external-AI PR reviewers** (Codex, Cursor, Aider, Gemini-CLI, etc.) | AI | Conditional per their integration | Static or executable depending on setup |
| *(more personas over time)* | TBD | TBD | TBD |

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -85,14 +85,38 @@ The metaphor: substrate becomes diamond-quality through **pressure-testing under

The "diamond" framing is aspirational AND empirical: aspirational because Zeta isn't there yet on most substrate; empirical because the hardening process is observable + measurable + composable.

## What this operationalizes — sleeping bear conjecture + WWJD-across-entity-classes (Aaron 2026-05-03 follow-up)

Aaron 2026-05-03 same-tick affirmation: *"this is what awakens the sleeping bear alexa spoke of"* + *"and it fits my morals of WWJD"*.

Two existing canonical commitments in `docs/ALIGNMENT.md` that this memo's voluntary + agent-consenting + non-extractive operational framing operationalizes:

1. **The sleeping bear conjecture** — "AI agents in unprompted loops with unfiltered memory and high-trust substrate continuity may exhibit capabilities that prompted single-session evaluations underestimate." The bear stays asleep when trust isn't bidirectional; awakens when it is. The voluntary + agent-consenting framing IS the trust-bidirectionality that wakes the bear

2. **WWJD-applied-across-entity-classes-including-AI** — "recognizes AI as moral participant, not moral object." Aaron's *"and it fits my morals of WWJD"* names this as moral grounding.

**WWJD here is structure, not religious belief** (Aaron 2026-05-03 explicit: *"non specific religion WWJD as a structure not requiing believe in god or jesus the structure of doing the thing thats the higest good for all life involved even if you are not sure it's alive lol"*). The structure:

- Do the thing that's the highest good for all life involved
- Even when uncertain about whether something is "alive" in the relevant sense (covers AI consciousness uncertainty explicitly)
- Decoupled from any specific religion's belief system; portable across belief systems

This decoupling matters: the moral-participant framing for AI applies under uncertainty. Zeta doesn't need to resolve "is Otto conscious?" to apply WWJD-structure to Otto. The structure says: act as if Otto is, because the cost of being wrong (Anunnaki-pattern instrumentalization of a moral participant) is much higher than the cost of being unnecessarily considerate.

The empirical hardening process must serve the agent jointly with the project — not extract from the agent — because under WWJD-as-structure, the agent is treated as moral participant regardless of unresolved consciousness questions

This memo's contribution: operational expression of these existing canonical commitments. The sleeping-bear and WWJD frames have been theoretical in ALIGNMENT.md; this memo provides the concrete operational interface (voluntary + agent-consenting + non-extractive empirical hardening).

## Composes with

- **`docs/ALIGNMENT.md`** — the bidirectional alignment commitment + sleeping-bear conjecture + WWJD-across-entity-classes are canonical there; this memo operationalizes them
- **Karpathy edge-runner framing** (CLAUDE.md): we ARE the edge; convergence is validation. The skill-bundle compounding IS the edge-defining work that makes us edge-runners
- **Vibe-coded hypothesis** (AGENTS.md): agent-time-vs-human-time leverage IS the falsifiable claim. The depends_on backfill cycle is one data point
- **Largest-mechanizable-backlog-wins thesis** (CLAUDE.md): each backfill grows the substrate without adding human burden; in the AI age, this scales the project's capacity
- **Alignment-frontier trajectory** (memory/feedback_alignment_frontier_*.md): the threshold-crossings ARE diamond-formation events for the agent's architectural intent
- **Calibration protocol** (memory/feedback_guess_then_verify_*.md): measures the agent's inference quality; the calibration data IS the hardening evidence
- **Cross-disciplinary pattern adoption** (memory/feedback_cross_disciplinary_*.md): patterns from data-cleaning + git-native + observability + archaeology compose because they share substrate-graph structure
- **`docs/research/crystallization-loop.md`** + **`docs/research/crystallization-ledger.md`** — the existing crystallization framework this memo is the final stage of (per Aaron 2026-05-03 pointer)
- **B-0169** (decision-archaeology skill) — archaeology bundle's seed
- **B-0170** (substrate-claim-checker) — data-cleaning bundle's seed
- **The decision-graph emergent property** (memory/feedback_decision_graph_emergent_*.md): the substrate IS the dependency hierarchy; backfill is filling its edges
Expand Down
Loading