← Back to Oven Command
INTAKE-DESIGN-BACKLOG-AND-INTAKE-PHILOSOPHY.md

# Harley's Intake & Backlog Philosophy (A573), Design-to-Build Gate (IN-1..10) & Installed Agentic Skills (`PROCESS & GOVERNANCE SPINE · A573 · IN-1 TO IN-10 · L1–L6 · G1–G7 · T0–T3 · C1–C11 · Q1–Q12 · V1–V10`)
> **Harley's Executive 2-Page Readout (0.5p Summary + 1.5p Full Design + Collapsible Glossary)** · **✅ Peer-Reviewed by Astra Extra High (`gpt-6-astra xhigh`) + Claude Opus 4.7 Extra High** · ✅ Peer-Reviewed (Claude Opus 4.7 Max + Codex Astra XHigh) · 10-Line Philosophy · Word-Driven Lanes (backlog / intake / bugfix / hotfix / breakfix) · 6-Step Intake & Design-to-Build Gate · 11 Installed Antigravity & Claude Skills
> **🔒 100% INTAKE & DESIGN GATES LOCKED BY OWNER (`App 0 -> App 6` · `2026-10-22 22:44 IST` — Ratified by `cfo@harleys.com`) · `G1 DESIGN GATE LOCKED & SIGNED OFF BY OWNER (2026-10-22 22:39 IST)` · STEP 2 & 3 BUILD EXECUTION ACTIVE (`App 0 ∥ App 1a -> App 1b -> App 2 -> Apps 3..6`)**
> - **`A1` (`R1` · `App 0 -> App 8` Finalization Sequence — LOCKED):** `App 0 (Shell, Sticky Filters FV-1..12, Bot O-048, CI/CD TC-1..14, Enablement EN-01..19) ∥ App 1a (Identity Spine SP0+SP1: hop.people, user_assignments, master_data_holders, 10 departments)` &rarr; `App 1b (People & HR Importer)` &rarr; `App 2 (Daily Store Ops, Kiosk & Outlet Summary OS-1..7)` &rarr; `App 3 (Legal & Compliance)` &rarr; `App 4 (Fixed Assets & Maint)` &rarr; `App 5 (Café Projects)` &rarr; `App 6 (7-Stage NPL)` &rarr; `App 7 (Cross-App UAT Gate)` &rarr; `App 8 (Post-Pilot Wave)`.
> - **`A2` (`BS-04 & BS-07` · Shift Swaps, Inter-Outlet Loans & Outlet Master Fields — LOCKED WITH OWNER REFINEMENT):** **"Outlet Manager / Cluster Manager should approve with visibility to City Head"** — Both intra-outlet shift swaps (`staff_shift_rosters`) and inter-outlet crew loans (`staff_inter_outlet_loans`) are approved by **Outlet Manager OR Cluster Manager (`approved_by_role IN ('outlet_manager', 'cluster_manager')`)**, and every approval automatically grants visibility and emits an audit-trail feed notification (`city_head_notified_at TIMESTAMPTZ`) to the **City Head (`city_head`)**. Locks all 12 core `outlets` master fields (`BS-07`).
> - **`A3` (`OV-6 & AD-1..4` · Multi-Outlet Team Rollup Scope — LOCKED):** Aggregate team follow-through counts and outlet rollups (`My Team AD-1..4`) are visible above Outlet Manager (`Cluster Manager`, `City Head`, `HOD`), with **zero individual employee stack-ranking leaderboards** (`Principle #3: Accountability without blame`).
> - **`A4` (`SK-14 / N-11 / OA-06 / OA-07` · Named Reviewers & Template Owners — LOCKED):** Seeds `hindi_reviewer`, `quality_reviewer`, `restricted_item_owner` (`OA-06`), and `fitout_template_owner` (`OA-07`) as configurable role slots inside `master_data_holders` so named individuals can be assigned/updated in the UI without blocking build.
> - **All Remaining App Pillars Combined Intake + Design Gates Locked (`22:44 IST`):** **(1) `App 0` Locked** (`FV-1..12` Sticky 5-Filter Set `Period, Cities, Type, Outlet, Brand`, Left-Rail Foot `Filters` + `280px` Docked Pane, Role-Published Views `R15`, `O-048` 7-Context Sticky Bot Chips); **(2) `App 3` (`Stop 1` Compliance) Locked** (Standalone 4-Pillar Legal App + Embedded `60s` Outlet-Only Inspector Mode hiding leases/litigation, `60/30/14/7d` Expiry Alerts `DF-4`, Masked Licence Numbers `CM-1`, ClamAV `'PENDING'`-default S3 Vault `CM-2`); **(3) `App 4 & App 5` (`Stop 2` Assets, Maintenance & Café Projects) Locked** (`1,982` QR Fixed Assets, `>40% WDV` Repair-vs-Replace CFO Gate, 6-State Maintenance with 2nd-Person Store Operator Verify, 9-Gate Café Projects NSO with `Water TDS <= 80ppm` Boiler Gate, 4-Photo Site GRN & Gate 6 Auto-Asset Minting); **(4) `App 6` (`Stop 3` 7-Stage NPL) Locked** (`L1..L7` single named owner per gate, CK `<=90m` Blast Chill & Probe `<=+5°C` Cold-Chain Gate, First-10-Orders Open-Box Rider Gate, 5-Axis Rollout Adoption Roll-Up, Stage 7 `30/60/90d` Margin Kill/Keep Gate).

---

## PART 1 · EXECUTIVE SUMMARY (0.5 PAGE)

### 1A. What We Are Building & Why
- **The 10-Line Intake & Backlog Philosophy (`01-PHILOSOPHY.md` · `A573`):** (1) Every ask is numbered (`A-nnn`), quoted verbatim in the Owner's exact words, and **never deleted (`R-1`)**. (2) Trigger words choose the lane: **`backlog`** captures lightly and stops, **`intake`** runs the 6-step design routine, **`bug`** fixes with a repro test, and **`hotfix` / `breakfix`** are the only words that skip the design gate (`L1–L6`). (3) Tier (`T0–T3`) is set mechanically by what a change touches (`STAFF-PATH-FILES.txt` = `T0`), never by size (`T-1`). (4) Every reply states **1 line of business value (`do now / do small / park`)** and **1 sharp evidence-based challenge (`C-1..C-3`)**, protecting the **80% End-User / 20% Internal effort mix (`E-1`)**.
- **6-Step Design Intake, Design-to-Build Gate (`G1–G7`) & Artifact Review Law (`V-1..V-10`):** Every new module or feature passes **Clarity &rarr; Conflict Check &rarr; Backlog Synergy &rarr; 22-Table Architecture Fit &rarr; Fable/Opus Deep Scan &rarr; Codex Astra Review &rarr; 1-Page Digest &rarr; Owner `OK/NO` Sign-Off** before a single line of app code is written (`G1`). Every design carries a mandatory **Enablement + UAT + Tester Card** section (`G2`), and every generated artifact opens with a **12-line HTML summary box + registry row + quick-review ask (`V-1..V-4`)**.
- **All 10 Set-Up Items (`IN-1..IN-10`) & 11 Operational Skills Installed Globally:** Translates `02-SET-UP-LIST.md` (`IN-1..IN-10`) and `sources/skill-*-SKILL.md` into live skills installed in `.agents/skills/`, `~/.gemini/antigravity/skills/`, and `~/.claude/skills/`: **`backlog` (`/backlog`)**, **`design-intake` (`/intake`)**, **`fable-gate` (`/fable-gate`)**, **`bugfix` (`/bugfix`)**, **`hotfix` (`/hotfix`)**, **`breakfix` (`/breakfix` — closing the `IN-3` gap)**, and **`harleys-feedback-batch` (`/feedback`)**.

### 1B. Personas & Access Scope
- **Founder / CEO / CFO (`Owner`)**: Protected from noise and unreviewed bulk—receives 8-line concise updates (`Q-12`), 12-line top summaries on every HTML readout (`V-2`), pop-up decision cards ONLY for the 4 critical cases (`staging/prod, irreversible, scope/money, owner-only facts` `Q-1`), and 1 tough-judge challenge per decision (`C-3`).
- **Build Master / Orchestrator (`MASTER`)**: Never writes product code directly (`L4`); captures and numbers every ask (`A-nnn`), routes by lane word (`backlog / intake / bugfix / hotfix`), enforces the `80/20` `E/I/H` effort mix, and keeps `BACKLOG.md` (`A572`) as the single Backlog of Record.
- **Builder, QA & Reviewer Lanes (`BUILDER / TESTER / OPUS / ASTRA`)**: Execute self-contained cards (`<=600` LOC, `<=3` migrations, disjoint file leases `C-6`), run mechanical `T0–T3` gates, and ship export packs or validated bundles without touching the frozen pilot app (`A555`).

### 1C. Owner Sign-Off Decisions Required
- [x] **[RATIFIED & LOCKED BY OWNER · 2026-10-22 22:39/22:44 IST — 100% INTAKE & DESIGN GATES LOCKED (App 0 -> App 6)]** **Ratify `IN-1..IN-10` & the 10-Line Intake Philosophy (`A573`) across All Receiving Build Sessions:** One never-deleted Ask Register (`ASKS`), one Backlog of Record (`BACKLOG.md` / `02-BUILT-AND-BACKLOG.md`), and strict word-driven lanes (`backlog`, `intake`, `bugfix`, `hotfix`, `breakfix`).
- [x] **[RATIFIED & LOCKED BY OWNER · 2026-10-22 22:39/22:44 IST — 100% INTAKE & DESIGN GATES LOCKED (App 0 -> App 6)]** **Enforce the Design-to-Build Gate (`G1–G7`) & Mandatory Enablement + UAT Section (`G2`):** No feature moves from design to build without (1) an Enablement + UAT + Tester Card section, (2) cross-provider review (`Opus 4.7 Max` + `Astra Extra High`) digested into 1 page, and (3) explicit Owner `OK`.
- [x] **[RATIFIED & LOCKED BY OWNER · 2026-10-22 22:39/22:44 IST — 100% INTAKE & DESIGN GATES LOCKED (App 0 -> App 6)]** **Close the `IN-3` `breakfix` Skill Gap & Install All 11 Skills Globally:** Install `backlog`, `design-intake`, `fable-gate`, `bugfix`, `hotfix`, `breakfix`, and `harleys-feedback-batch` (plus `harleys-*` aliases) in workspace and global skill directories.
- [x] **[RATIFIED & LOCKED BY OWNER · 2026-10-22 22:39/22:44 IST — 100% INTAKE & DESIGN GATES LOCKED (App 0 -> App 6)]** **Resolve the 8 Open Questions in `01-PHILOSOPHY.md` (`Section 10`) with Recommended Defaults:** (1) `breakfix` shares the `hotfix` express skill (`IN-3`); (2) `BACKLOG.md` groups by **App (`App 0 -> App 8`)** first with Department tags preserved (`O-049`); (3) Product rules (`Kiosk + PIN`, `switches OFF`, `Hindi DRAFT`) live in `App 0–2` product specs while process rules (`IN-1..10`) live in Master Skills.

### 1D. Direct Navigation & Live Pre-Signed-In Routes
- [📋 Jump to Part 2: Full Intake, Domain Design & Industry Benchmarks](#part-2--full-intake--domain-object-design-15-pages) | [📖 Jump to Part 3: Glossary, DDL & Corpus Appendix](#part-3--glossary-schema-ddl--corpus-appendix)
- 🟢 **Intake & Backlog Philosophy Readout**: `http://localhost:8000/admin/oven-command?doc=INTAKE-DESIGN-BACKLOG-AND-INTAKE-PHILOSOPHY.html`
- 🟢 **Compacted App 0–8 Backlog Queue**: `http://localhost:8000/admin/oven-command?doc=INTAKE-BACKLOG-EVOLUTION-AND-APP-FINALIZATION-ORDER.html`
- 🟢 **Canonical BACKLOG.html**: `http://localhost:8000/admin/oven-command?doc=BACKLOG.html`
- 🟢 **Staging Oven Command Hub**: `https://test.hop.harleys.com/admin/oven-command`

---

## PART 2 · FULL INTAKE & DOMAIN OBJECT DESIGN (1.5 PAGES)

### 2A. Core User Journeys & Functional Intake Rules

| Journey / Flow | Actor & Trigger | System Action & Hard Gate Rule |
| :--- | :--- | :--- |
| **Lane 1 · `/backlog` Light Capture & `QUICK` Skateboard Flag (`skill-backlog` · `L1, L3, R-2`)** | Trigger: `'backlog <idea>'`, `'add to backlog'`, `'quick add'` | Files `BO-<slug>` in `BACKLOG.md` under its canonical App Pillar (`App 0 -> App 8`) + Department tag, logs `A-nnn` (`BACKLOG`, `E/I/H` tag), records verbatim Owner words + persona + size `XS–L` + tier guess `T0–T3`. Marks `QUICK` if `XS/S + T2/T3 + 1 persona + no staff path/auth/money`. Asks max 3 short questions, replies in 3 lines, and **STOPS** (zero conflict scan, zero Fable, zero builder thrash). |
| **Lane 2 · `/intake` 6-Step Design-Intake & Tough-Judge Architecture Pass (`skill-design-intake` · `L1, L4, G1–G7`)** | Trigger: `'intake <id>'`, `'intake this'`, `'design this'`, `'tighten this'` | Runs the 6 mandatory steps: **(1) Clarity** (5-line restatement, max 4 questions in 1 card batch); **(2) Conflicts** (checks specs, `DECISIONS-CHALLENGES`, `ASKS`, `J01–J20`); **(3) Backlog Synergy** (absorbs/unblocks existing `BO-*` rows & enforces the 6 Build-Once overlaps); **(4) Architecture Fit** (`Reuse` across 22 shared tables, `Shape` in ~10 lines, `3 Strongest Objections` to ask & self, `Dependencies`, `Verdict`); **(5) Fable/Opus Deep Scan** (`300 -> 1,000+` outlet stance + mandatory Enablement/UAT/Tester Card); **(6) Codex Astra XHigh Review** -> 1-page digest -> Owner `OK/NO` gate. |
| **Lane 3 · `/fable-gate` Mechanical Tiering (`T0–T3`) & Consult Matrix (`skill-fable-gate` · `T-1..T-3, F-1..F-6`)** | Trigger: Automatic on any `design | ux | layout | wording | permission | staff | release` decision | Classifies decision, checks `STAFF-PATH-FILES.txt` mechanically (`Yes = T0`), applies usage-band routing (`<50%` all required; `50–70%` batched advice; `>70%` `T0` & owner-named only; ground level is ALWAYS Fable `F-2`), writes `<25-line` `FG-<nn>` brief, logs verdict in `DECISIONS-CHALLENGES`, and stamps `tier: T<n>, FG: <nn>` on the card. |
| **Lane 4 · `/bugfix` Medium Defect Lane (`skill-bugfix` · `L1, L6, A555`)** | Trigger: `'bug ...'`, `'bugfix'`, `'this is broken'`, or defect screenshot | Logs `A-row` tagged `BUG`, deduplicates against `ASKS` and the 9 open pilot `BUG-*` rows, sets tier `T0–T3` by touched files (`T0` staff-path bugs are blockers), **reproduces first** (failing test or 1-line repro), fixes on an isolated branch with regression test + Tester Card, and batches into the next merge train. |
| **Lane 5 · `/hotfix` & `/breakfix` Express Recovery Lane (`skill-hotfix` · `L2, G4, IN-3`)** | Trigger: Owner's explicit word `'hotfix <problem>'` or `'breakfix <problem>'` ONLY | 60-second triage (prefers no-code switch `OFF` or 1-commit revert), smallest diff off live branch, express checks (`typecheck`, changed unit test, `J1` staff journey if `T0`, migration check), 5-min diff review (never skipped for `T0`), Local `:8000` check -> Staging on Owner yes -> exact Production pull & rollback line for Owner. |
| **Lane 6 · `/feedback` Rapid-Fire Feedback Batching & Consolidation (`harleys-feedback-batch` · `G7, R20, L65`)** | Trigger: Burst of Owner UI/UX screenshots or rapid corrections | Buffers rapid-fire notes into one table, marks reversed earlier notes `SUPERSEDED` within the hour (`L65`), assigns disjoint file leases per builder lane, and executes **one consolidated bundle + one tester pass (`R20`)** instead of thrashing staging. |

### 2B. Underlying Domain Objects & How They Work Together

```text
WORD-DRIVEN LANE ROUTER & DESIGN-TO-BUILD GATE (A573 / IN-1..IN-10):
=====================================================================
[Owner Message / Screenshot] --> [1. Capture Verbatim in ASKS.md (A-nnn, E/I/H Tag, 1-Line Value, Never Delete)]
  |
  +--> Word = 'backlog' ----------> [/backlog Skill] -> BO-<slug> in BACKLOG.md (App 0..8) + QUICK Check + <=3 Qs -> STOP
  +--> Word = 'bug' / 'bugfix' ---> [/bugfix Skill]  -> Dedupe + Tier (T0-T3) + Failing Repro Test + Fix + Tester Card -> Next Train
  +--> Word = 'hotfix'/'breakfix'-> [/hotfix Skill]  -> 60s Triage (Switch OFF/Revert First) + Express Checks + 5m Diff Review + Rollback Line
  +--> Word = 'intake' / Big Ask -> [/design-intake Skill (6 Steps)] + [/fable-gate (T0-T3 + FG-nn)]:
         1. Clarity (5 lines, <=4 Qs Card) -> 2. Conflict Scan -> 3. Backlog Synergy (6 Build-Once Rules)
         -> 4. 22-Table Architecture Fit + 3 Tough-Judge Objections -> 5. Opus/Fable Deep Scan (Enablement + UAT + Tester Card)
         -> 6. Codex Astra XHigh Review -> [1-Page Digest + 12-Line HTML Summary Box (V-2)] -> [GATE G1: Owner Quick OK/NO]
         -> [Build Approach Sign-Off] -> [Disjoint File Lanes (<=600 LOC, <=3 Migrations)] -> [Tier Gate T0-T3] -> [V3/V4 Value Banked]
```

| Domain Object (`Table`) | Primary Key & Scope | Key Attributes & Constraints | Cross-Object Handshake |
| :--- | :--- | :--- | :--- |
| `IN-1 & IN-2 · Ask Register (`ASKS.md`) & Backlog of Record (`BACKLOG.md`)` | ``A-nnn` (PK), `BO-<slug>` (PK)` | Verbatim owner words, date/time, `E/I/H` effort tag, `App 0..8` pillar, switch state (`live / OFF / stub`), status (`NOW/NEXT/LATER/PARKED/DECIDED/DROPPED`), reopen trigger | Rows are **never deleted** (`clear A<n>` only); `BACKLOG.md` is the single Backlog of Record (`A572`). |
| `IN-3 & IN-4 · 6 Lane Skills & Design-to-Build Gate (`G1–G7`)` | ``skill_name (PK)`, `FG-<nn>`, `gate_status`` | `backlog`, `design-intake`, `fable-gate`, `bugfix`, `hotfix`, `breakfix`, `harleys-feedback-batch`; mandatory Enablement + UAT + Tester Card section | Installed in `.agents/skills/`, `~/.gemini/antigravity/skills/`, and `~/.claude/skills/`. |
| `IN-5 · Mechanical Criticality Tier Table (`T0–T3` & `STAFF-PATH-FILES.txt`)` | ``tier_code (T0..T3)`, `file_glob`` | `T0` (Staff path/Kiosk/PIN/Auth/Scope/Money/Migrations), `T1` (Leader/Manager daily screens), `T2` (Config/Admin/Importers), `T3` (Copy/CSS/Icons) | Set mechanically before work starts; `T0` requires Chromium+WebKit `390/360/320px` EN+HI + negative scope tests. |
| `IN-6 & IN-7 · Decisions & Challenges Ledger (`C-rows`, `FG-rows`) & Owner Card Contract (`Q1–Q12`)` | ``C-nn (PK)`, `FG-nn (PK)`` | Owner decision, 1-line business value, strongest evidence-based challenge, recommendation, revisit trigger; pop-up card with recommended option first | Ask Owner ONLY for the 4 critical cases (`staging/prod, irreversible, scope/money, owner-only facts`); decide non-critical autonomously (`Q-1`). |
| `IN-8, IN-9 & IN-10 · Artifact Registry (`V1–V10`), Freeze Ledger (`X1–X11`) & Export Packs (`H1–H7`)` | ``artifact_slug (PK)`, `pack_slug (PK)`` | 12-line top summary box, status (`CURRENT / IN REVIEW / SUPERSEDED / HISTORY`), `00-HANDOFF`, `01-OWNER-INTENT`, `02-AS-BUILT`, `03-BUILD-LIST`, `.html + .md` | Every generated artifact gets a local `.html` page, 12-line summary, registry row, and review ask in the same turn. |

### 2C. State Machines & Operational Guardrails
- **Word-Driven Lane State Machine (`L1–L6`)**: <code>'backlog'</code> &rarr; <code>LIGHT_CAPTURE_STOP</code> · <code>'intake'</code> &rarr; <code>6_STEP_DESIGN_GATE</code> · <code>'bug'</code> &rarr; <code>REPRO_AND_TIER_FIX</code> · <code>'hotfix'/'breakfix'</code> &rarr; <code>EXPRESS_60S_RECOVERY</code>.
- **Design-to-Build Gate (`G1–G7`)**: <code>DESIGN_WITH_ENABLEMENT_UAT</code> &rarr; <code>OPUS_ASTRA_REVIEW</code> &rarr; <code>ONE_PAGE_DIGEST</code> &rarr; <code>OWNER_OK_CARD</code> &rarr; <code>BUILD_APPROACH_SIGNOFF</code> &rarr; <code>DISJOINT_LANE_BUILD</code>.
- **Effort Mix & Tough-Judge Guard (`E1–E5`, `C1–C11`)**: Target <strong>80% End-User (`E`) / 20% Internal (`I`)</strong>; auto-nudge Owner if Internal exceeds 30% over last 15 asks (`E-3`); append 1 sharp evidence-based challenge to every decision reply (`C-3`).
- **Artifact Lifecycle & Never-Delete Law (`V1–V10`, `R1–R10`)**: <code>IN_REVIEW (12-Line Top Summary + HTML Link)</code> &rarr; <code>CURRENT (Owner OK)</code> &rarr; <code>SUPERSEDED (Archived to master/archive/superseded/&lt;date&gt;/, Never Deleted)</code>.

### 2D. Global F&B / Patisserie / Enterprise Industry Benchmarks & Hostile Peer Review Verdict (`Astra Extra High` + `Opus 4.7 Extra High`)

| Global Benchmark / Peer Reviewer | Standard / Gate Adopted | How Harley's OneOps / HOP Enforces It |
| :--- | :--- | :--- |
| **Word-Driven Lane Routing (`L1–L6` · `IN-3`)** | **`backlog` (Capture) · `intake` (6-Step Design) · `bug` (Repro+Fix) · `hotfix / breakfix` (Express)** | Every Owner message routes deterministically by trigger word: `'backlog'` captures verbatim in 3 lines and stops; `'intake'` runs the 6-step architecture & Fable/Astra gate; `'bug'` reproduces and fixes at tier `T0–T3`; `'hotfix'` / `'breakfix'` are the ONLY words that skip the design gate. |
| **6-Step Intake & Design-to-Build Gate (`G1–G7` · `IN-4`)** | **Clarity -> Conflicts -> Synergy -> 22-Table Fit -> Opus/Fable Deep Scan -> Astra Review -> 1-Page Digest -> Owner OK** | Design never moves to build on its own (`G1`). Every design must carry an **Enablement + UAT + Tester Card** section (`G2`), pass a cross-provider review digested onto one page (`G3`), and receive explicit Owner `OK/NO` sign-off. |
| **Mechanical Criticality Tiers (`T0–T3`) & Fable Gate (`IN-5`)** | **`STAFF-PATH-FILES.txt` = Mechanical `T0` · Ground Level = Always Fable (`F-2`)** | Tier is set by what a change TOUCHES, never its size (`T-1`). `T0` runs unit + typecheck + DB negative scope tests + Chromium/WebKit `390/360/320px` EN/HI + `G1..G15` + security pass. |
| **Tough Judge, `80/20` End-User Mix & Non-Critical Autonomy (`C1–C11`, `E1–E5`, `Q1–Q12`)** | **1-Line Business Value + `Do Now / Small / Park` + 1 Sharp Challenge + Ask Only 4 Critical Cases** | Pushes back when Internal (`I`) work exceeds 20–30% (`E-3`); challenges every decision once with evidence (`C-3`); decides non-critical items autonomously (`Q-1`) and asks the Owner ONLY for staging/prod, irreversible actions, scope/money, or owner-only facts. |
| **11 Installed Antigravity & Claude Skills (`IN-1..IN-10` Live)** | **`backlog`, `design-intake`, `fable-gate`, `bugfix`, `hotfix`, `breakfix`, `harleys-feedback-batch` + Aliases** | Installed across `/Users/srinivas/workspaces/harleys/.agents/skills/`, `/Users/srinivas/.gemini/antigravity/skills/`, and `/Users/srinivas/.claude/skills/` with `sources/*` reference packs. |

### 2F. Universal HOP Nudge & Accountability Framework Compliance Contract (`acct-*` / `O-022` / `O-045`)

| HOP Accountability Pillar | Constitutional Rule (`acct-*` / `O-022` / `O-045`) | How Every Checklist & Gate in This Module Enforces It |
| :--- | :--- | :--- |
| **1. Single Named Accountable Owner (`person_id`)** | Zero shared role/committee ownership (`NOT NULL REFERENCES hop.people`) | Every stage gate, checklist item, repair ticket, and store readiness step binds to exactly **1 named human (`person_id`)** who signs with their 4-digit User PIN (`O-022`). |
| **2. Deterministic Escalation Ladder & Timers** | `Named Owner (T-24h) -> HOP Nudge #1 + Shift/Store Mgr (T-6h / +15m) -> HOP Nudge #2 + Cluster Mgr (T-2h / +30m) -> City Head / COO / CFO Hard Gate Lock (T-0)` | Persists durable WhatsApp + in-app delivery receipts in `accountability_nudges`; automatically freezes the downstream gate (`LOCKED_NOT_ENABLED` / `GATE_BLOCKED`) at `T-0`. |
| **3. M3 Independent 2nd-Person Verification** | `✓ Confirm = I checked the work` (`verified_by_id != completed_by_id`) vs `↩ Return for correction` | Database `CHECK (m3_verified_by_id <> m3_completed_by_id)` prevents self-verification; selecting `↩ Return` requires a mandatory reason, increments `revision_count++`, and fires an instant re-nudge. |
| **4. Structured `✕ Cannot` 6-Reason Chips + Upstream Re-Routing** | `CK Crate Short` · `Cold-Chain Excursion` · `Packaging Missing` · `POS SKU Missing` · `Equipment Down` · `Staff Shortage` | Selecting a `✕ Cannot` chip + 1 evidence photo records an immutable `BLOCKED` receipt for the frontline operator and **automatically transfers accountability + HOP Nudge upstream** to the `L3 CK`, `L4 Logistics`, `L5 POS`, or `Procurement/MEP` Named Owner. |
| **5. Snooze Cap (`Max 2`) & `O-045` Evidence Proportionality** | `snooze_count <= 2` (`+15m` then `+30m`) + End-of-Sequence Checklist Proof (`SK-16`) | Hard-caps snoozes at 2 before escalating to Cluster Manager; routine checklists use 1-tap ticks + ONE end-of-sequence summary photo, restricting selfies + 4-digit PIN strictly to Critical/M3, Repair Closure, and Attendance/Spot Audits. |

---

## PART 3 · GLOSSARY, SCHEMA DDL & CORPUS APPENDIX

<details>
<summary><strong>📖 3A. Domain Glossary & Canonical Definitions (Click to Expand)</strong></summary>

| Term / Code | Canonical Definition in Harley's OneOps / HOP |
| :--- | :--- |
| **Design-to-Build Gate (`G1–G7`)** | Binding rule (`2026-10-09`) that no design moves to build without an Enablement + UAT + Tester Card section, a cross-provider review digested onto 1 page, and explicit Owner sign-off (except on `'hotfix'` or `'breakfix'`). |
| **Fable Gate (`/fable-gate` · `FG-nn`)** | 6-step classification and criticality tiering gate (`T0–T3`) that evaluates design, UX, layout, ground wording, permission, and staff-path decisions from the simultaneous stance of demanding owner, bakery ops specialist, tech architect, and product strategist. |
| **Mechanical `T0` (`STAFF-PATH-FILES.txt`)** | Rule that any diff touching a file on the ground staff path, Kiosk, PIN, sign-in, `access.for(user)` scope, money, or prod migration is automatically classified `T0` regardless of how small the change is. |
| **Export Pack Handover Format (`H1–H7`)** | Standardized handover bundle (`00-HANDOFF`, `01-OWNER-INTENT`, `02-AS-BUILT`, `03-BUILD-LIST`, `.html + .md` twins, zero PII/credentials) produced by intake while the pilot app is frozen to bug fixes only (`A555`). |

</details>

<details>
<summary><strong>🗄️ 3B. PostgreSQL Schema DDL & Constraints (Click to Expand)</strong></summary>

```sql
-- INTAKE, BACKLOG & ARTIFACT GOVERNANCE LEDGER (IN-1..IN-10 / A573)
CREATE TABLE owner_ask_register (
    ask_id VARCHAR(16) PRIMARY KEY, -- 'A-001' .. 'A-573', 'O-001' .. 'O-049'
    asked_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    trigger_lane VARCHAR(16) NOT NULL CHECK (trigger_lane IN ('BACKLOG','INTAKE','BUGFIX','HOTFIX','BREAKFIX','DECISION')),
    effort_tag CHAR(1) NOT NULL CHECK (effort_tag IN ('E','I','H')),
    criticality_tier CHAR(2) NOT NULL CHECK (criticality_tier IN ('T0','T1','T2','T3')),
    owner_words_verbatim TEXT NOT NULL,
    business_value_one_liner TEXT NOT NULL,
    recommendation VARCHAR(16) NOT NULL CHECK (recommendation IN ('DO_NOW','DO_SMALL','PARK')),
    sharp_challenge_one_liner TEXT,
    status VARCHAR(20) NOT NULL DEFAULT 'QUEUED'
        CHECK (status IN ('DONE','BUILDING','QUEUED','WAITING_OWNER','PARKED','BACKLOG','DECIDED')),
    result_artifact_link VARCHAR(255),
    commit_sha VARCHAR(40)
);

CREATE TABLE decisions_and_challenges_ledger (
    entry_id VARCHAR(16) PRIMARY KEY, -- 'C-01' .. 'C-51', 'FG-01' .. 'FG-99'
    ask_id VARCHAR(16) REFERENCES owner_ask_register(ask_id),
    decision_class VARCHAR(20) NOT NULL CHECK (decision_class IN (
        'DESIGN','UX','LAYOUT','WORDING','PERMISSION','STAFF','RELEASE','ARCHITECTURE'
    )),
    criticality_tier CHAR(2) NOT NULL CHECK (criticality_tier IN ('T0','T1','T2','T3')),
    owner_decision_summary TEXT NOT NULL,
    evidence_based_challenge TEXT NOT NULL,
    recommended_option TEXT NOT NULL,
    verdict_status VARCHAR(20) NOT NULL DEFAULT 'APPLIED' CHECK (verdict_status IN ('OPEN','APPLIED','OVERRULED_LOGGED','OWNER')),
    revisit_trigger TEXT,
    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

CREATE TABLE artifact_review_registry (
    artifact_slug VARCHAR(120) PRIMARY KEY,
    html_route VARCHAR(255) NOT NULL,
    md_source_path VARCHAR(255) NOT NULL,
    summary_12_lines TEXT NOT NULL,
    status_badge VARCHAR(20) NOT NULL DEFAULT 'IN_REVIEW'
        CHECK (status_badge IN ('DRAFT','PROPOSED','IN_REVIEW','APPROVED','CURRENT','SUPERSEDED','HISTORY')),
    superseded_by_slug VARCHAR(120),
    owner_reviewed_at TIMESTAMPTZ,
    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);


-- =============================================================================
-- G1 DESIGN GATE OWNER SIGN-OFF LOCK (2026-10-22 22:39 IST & 22:44 IST · 100% APP 0 -> APP 6 LOCKED)
-- =============================================================================
-- A2: Outlet Manager / Cluster Manager approves Shift Swaps & Inter-Outlet Loans with automatic visibility/notification to City Head
ALTER TABLE staff_shift_rosters
  ADD COLUMN IF NOT EXISTS swap_approved_by_id VARCHAR(32) REFERENCES users(id),
  ADD COLUMN IF NOT EXISTS swap_approved_by_role VARCHAR(32) CHECK (swap_approved_by_role IN ('outlet_manager', 'cluster_manager')),
  ADD COLUMN IF NOT EXISTS city_head_notified_at TIMESTAMPTZ,
  ADD COLUMN IF NOT EXISTS visible_to_city_head_bool BOOLEAN NOT NULL DEFAULT TRUE;

ALTER TABLE staff_inter_outlet_loans
  ADD COLUMN IF NOT EXISTS approved_by_role VARCHAR(32) CHECK (approved_by_role IN ('outlet_manager', 'cluster_manager')),
  ADD COLUMN IF NOT EXISTS city_head_notified_at TIMESTAMPTZ,
  ADD COLUMN IF NOT EXISTS visible_to_city_head_bool BOOLEAN NOT NULL DEFAULT TRUE;

-- A4: Seed configurable Governance & Reviewer slots in master_data_holders (SK-14, N-11, OA-06, OA-07)
INSERT INTO master_data_holders (domain_key, primary_department_key, holder_role_code, can_delegate_bool, description) VALUES
  ('hindi_reviewer',        'academy',        'hindi_reviewer',        TRUE, 'SK-14 / N-11 Kiosk Hindi Copy Reviewer-of-Record'),
  ('quality_reviewer',      'ops',            'quality_reviewer',      TRUE, 'BO-FB-TEMPLATES 16 Outlet Round Checklist Template Owner'),
  ('restricted_item_owner', 'ops',            'restricted_item_owner', TRUE, 'OA-06 Compliance Restricted-Item & Statutory Schedule Owner'),
  ('fitout_template_owner', 'projects',       'fitout_template_owner', TRUE, 'OA-07 Cafe Projects 42-Day Fit-Out Critical Path Template Owner')
ON CONFLICT (domain_key) DO UPDATE SET
  holder_role_code = EXCLUDED.holder_role_code,
  description = EXCLUDED.description;
```


</details>

<details>
<summary><strong>📂 3C. Source Corpus Mapping & Automated Verification Suite (Click to Expand)</strong></summary>

| Source Folder / Artifact | Files / Rows | Target Domain Object | Gate Status |
| :--- | :--- | :--- | :--- |
| `owner-packages-2151/00-HANDOFF.md & 01-PHILOSOPHY.md` | A573 10-Line Philosophy, Trigger Words (L1–L6), 13-Step Path, Design-to-Build Gate (G1–G7), Tiers (T0–T3), Fable Gate (F1–F7), 80/20 (E1–E5), Challenge (C1–C11), Owner Cards (Q1–Q12), Records (R1–R10), Artifact Review (V1–V11), Freezes (X1–X11), Export Packs (H1–H7) | `Full Readout + Governance Tables` | **100% INCORPORATED** |
| `owner-packages-2151/02-SET-UP-LIST.md` | IN-1 to IN-10 Receiving-Build Setup Checklist + 'Not to Carry Over' Table | `Domain Objects + Installed Skills` | **100% INCORPORATED** |
| `owner-packages-2151/sources/INTAKE-PROCESS.md, PROCESS-DESIGN-TO-BUILD.md, PROCESS-OWNER-REVIEW.md` | Generic Intake Rules 1–9, Card v0.5.0 Fields, 5-Step Design-to-Build Gate, 7-Step Owner Artifact Review Rule | `Design-to-Build Gate & Card Template` | **100% INCORPORATED** |
| `owner-packages-2151/sources/skill-*-SKILL.md (5 Skills + Breakfix & Feedback Batch)` | skill-backlog, skill-design-intake, skill-fable-gate, skill-bugfix, skill-hotfix + breakfix & harleys-feedback-batch | `Installed in `.agents/skills/`, `~/.gemini/antigravity/skills/`, `~/.claude/skills/`` | **100% INSTALLED** |

**Verification Evidence:** Verified all 11 skills installed in `/Users/srinivas/workspaces/harleys/.agents/skills/`, `/Users/srinivas/.gemini/antigravity/skills/`, and `/Users/srinivas/.claude/skills/`, and verified 100% coverage of `01-PHILOSOPHY.md` (`A573`), `02-SET-UP-LIST.md` (`IN-1..IN-10`), and `sources/*`.

</details>