Gabe Align — Alignment Guardian
Gabe execution contract (E1–E7)
This skill runs under the suite execution contract — E1 EVIDENCE · E2 RUN-BEFORE-✅ · E3 NO SILENT DOWNGRADE · E4 REUSE FIRST · E5 STATE SYNC · E6 MISSING ANCHOR = STOP · E7 REPORT WHERE — floors, not ceilings; a skill's own gate may be stricter, never looser. Full text: ../gabe-docs/references/execution-contract.md (if that file is missing, E6 applies — STOP).
What this does
Two responsibilities: (1) Manual alignment checks — test proposed work against curated values BEFORE building, in shallow / standard / deep modes; (2) Automatic checkpoint — at commit/PR boundaries, evaluate values + test scenario coverage via hooks, no manual invocation needed. Values load from three stacking sources: structural (VALUES.md, A1-A7), user-level (~/.kdbp/VALUES.md), and project-level (.kdbp/VALUES.md), plus advisory Architecture Principles in standard/deep modes.
Usage / modes
/gabe-align [mode] [target] or /gabe-align init [project]
Manual checks
| Mode |
Alias |
Values Checked |
Output |
Use Case |
| shallow |
sf, bf |
Core only (A1-A3) + project values |
3-5 lines inline |
Quick sanity check, auto-trigger in gabe-roast |
| standard |
(default) |
All Standard (A1-A7+) + project values + advisory AP checks |
Full alignment document |
Before design, implementation, or non-trivial tasks |
| deep |
dp |
All values + advisory AP checks + brief |
Alignment document + alignment brief |
Greenfield projects, new architectures, major decisions |
Automatic checkpoint
Fires at git commit / gh pr create via hook: values evaluation (session+story altitude only) + scenario check (3 realistic scenarios per changed file) + inline summary before the commit proceeds.
Subcommands
| Command |
What it does |
/gabe-align init [name] |
Create .kdbp/ with BEHAVIOR.md + VALUES.md (interactive), then run readiness check |
/gabe-align init-user |
Create ~/.kdbp/VALUES.md (interactive) |
/gabe-align install-hooks |
Check ~/.claude/settings.json for KDBP hooks and install missing ones (with confirmation) |
/gabe-align status |
Show current values (user + project) |
/gabe-align migrate |
Convert old _kdbp/ to new .kdbp/ format |
/gabe-align evolve |
Review value PASS/CONCERN frequency, suggest changes |
Procedure
- Treat any text after the invocation as
$ARGUMENTS.
- Read
references/align-spec.md IN FULL before executing — the binding spec. If missing, E6 applies — STOP.
- Load values: structural
VALUES.md (A1-A7), ~/.kdbp/VALUES.md (user), .kdbp/VALUES.md (project); for standard/deep also load the architecture-principles catalog.
- Identify mode (shallow/standard/deep) and target; for artifact targets, locate and read all referenced files.
- For each applicable value: state handle, apply the test question, produce PASS/CONCERN/FAIL with cited evidence; in standard/deep run advisory AP checks separately.
- If
.kdbp/RULES.md exists, run an implicit rule-violation cross-check against the target.
- Produce the mode's output format; list action items for CONCERN/FAIL; propose new values for uncovered gaps; deep mode also produces the alignment brief.
- Automatic checkpoint (commit/PR hook): evaluate Hot-tier values + scenario coverage, append one thin-index row (tag
ALIGN) to .kdbp/LEDGER.md, and route untested ❌ scenarios to .kdbp/PENDING.md.
Output contract (summary)
Shallow: inline 3-5 line verdict. Standard/deep: full alignment document with PASS/CONCERN/FAIL counts, an advisory AP section, action items, and a deterministic verdict (any FAIL → DO NOT PROCEED; else any CONCERN → PROCEED WITH CONCERNS; else PROCEED). Deep mode appends an alignment brief. Automatic checkpoint always appends one thin-index row to .kdbp/LEDGER.md and, on user-proceeded ❌ scenarios, writes deferred rows to .kdbp/PENDING.md. The full output contract in the spec is binding.
1---2name: gabe-align3description: Alignment guardian — values + AP advisory checks at commit/PR boundaries, shallow/standard/deep.4---56# Gabe Align — Alignment Guardian78## Gabe execution contract (E1–E7)910This skill runs under the suite execution contract — E1 EVIDENCE · E2 RUN-BEFORE-✅ · E3 NO SILENT DOWNGRADE · E4 REUSE FIRST · E5 STATE SYNC · E6 MISSING ANCHOR = STOP · E7 REPORT WHERE — floors, not ceilings; a skill's own gate may be stricter, never looser. Full text: `../gabe-docs/references/execution-contract.md` (if that file is missing, E6 applies — STOP).1112## What this does1314Two responsibilities: (1) **Manual alignment checks** — test proposed work against curated values BEFORE building, in shallow / standard / deep modes; (2) **Automatic checkpoint** — at commit/PR boundaries, evaluate values + test scenario coverage via hooks, no manual invocation needed. Values load from three stacking sources: structural (`VALUES.md`, A1-A7), user-level (`~/.kdbp/VALUES.md`), and project-level (`.kdbp/VALUES.md`), plus advisory Architecture Principles in standard/deep modes.1516## Usage / modes1718`/gabe-align [mode] [target]` or `/gabe-align init [project]`1920### Manual checks2122| Mode | Alias | Values Checked | Output | Use Case |23|------|-------|---------------|--------|----------|24| **shallow** | `sf`, `bf` | Core only (A1-A3) + project values | 3-5 lines inline | Quick sanity check, auto-trigger in gabe-roast |25| **standard** | (default) | All Standard (A1-A7+) + project values + advisory AP checks | Full alignment document | Before design, implementation, or non-trivial tasks |26| **deep** | `dp` | All values + advisory AP checks + brief | Alignment document + alignment brief | Greenfield projects, new architectures, major decisions |2728### Automatic checkpoint2930Fires at `git commit` / `gh pr create` via hook: values evaluation (session+story altitude only) + scenario check (3 realistic scenarios per changed file) + inline summary before the commit proceeds.3132### Subcommands3334| Command | What it does |35|---------|-------------|36| `/gabe-align init [name]` | Create `.kdbp/` with BEHAVIOR.md + VALUES.md (interactive), then run readiness check |37| `/gabe-align init-user` | Create `~/.kdbp/VALUES.md` (interactive) |38| `/gabe-align install-hooks` | Check `~/.claude/settings.json` for KDBP hooks and install missing ones (with confirmation) |39| `/gabe-align status` | Show current values (user + project) |40| `/gabe-align migrate` | Convert old `_kdbp/` to new `.kdbp/` format |41| `/gabe-align evolve` | Review value PASS/CONCERN frequency, suggest changes |4243## Procedure44451. Treat any text after the invocation as `$ARGUMENTS`.462. Read `references/align-spec.md` IN FULL before executing — the binding spec. If missing, E6 applies — STOP.473. Load values: structural `VALUES.md` (A1-A7), `~/.kdbp/VALUES.md` (user), `.kdbp/VALUES.md` (project); for standard/deep also load the architecture-principles catalog.484. Identify mode (shallow/standard/deep) and target; for artifact targets, locate and read all referenced files.495. For each applicable value: state handle, apply the test question, produce PASS/CONCERN/FAIL with cited evidence; in standard/deep run advisory AP checks separately.506. If `.kdbp/RULES.md` exists, run an implicit rule-violation cross-check against the target.517. Produce the mode's output format; list action items for CONCERN/FAIL; propose new values for uncovered gaps; deep mode also produces the alignment brief.528. Automatic checkpoint (commit/PR hook): evaluate Hot-tier values + scenario coverage, append one thin-index row (tag `ALIGN`) to `.kdbp/LEDGER.md`, and route untested ❌ scenarios to `.kdbp/PENDING.md`.5354## Output contract (summary)5556Shallow: inline 3-5 line verdict. Standard/deep: full alignment document with PASS/CONCERN/FAIL counts, an advisory AP section, action items, and a deterministic verdict (any FAIL → DO NOT PROCEED; else any CONCERN → PROCEED WITH CONCERNS; else PROCEED). Deep mode appends an alignment brief. Automatic checkpoint always appends one thin-index row to `.kdbp/LEDGER.md` and, on user-proceeded ❌ scenarios, writes deferred rows to `.kdbp/PENDING.md`. The full output contract in the spec is binding.
khujta