Memories

Review the long-term memory facts Kali has saved for you.

92 memories matching “projects/kip”Sorted by created descending
CreatedMemorySourceImportanceSegment
Sep 13, 12:48 AMResearching how Obsidian vaults work, including app mechanics and file interconnections, to evaluate whether Obsidian can be incorporated into Kip using current infrastructure.mcp:put_page
medium · confidence 0.85
55commitments
Sep 10, 4:02 PMPlanned workflow: pull tracking numbers from Eadin, query UPS API, return per-PO Slack report with estimated delivery dates and shipment statusmcp:put_page
medium · confidence 0.95
62commitments
Sep 10, 4:02 PMKip does not currently have a UPS integrationmcp:put_page
medium · confidence 0.90
58projects
Sep 10, 12:54 AMThe read-only Klaviyo MCP surface (mcp.klaviyo.com?read-only=true) remains available to KIP regardless of whether KLAVIYO_PRIVATE_API_KEY is presentmcp:put_page
medium · confidence 1.00
65projects
Sep 10, 12:54 AMKIP's Klaviyo write tools (kip_klaviyo_create_campaign, kip_klaviyo_publish_figma_template, etc.) are only exposed to the model when KLAVIYO_PRIVATE_API_KEY is present in the DigitalOcean app specmcp:put_page
medium · confidence 1.00
65projects
Sep 10, 12:54 AMKLAVIYO_PRIVATE_API_KEY was restored to the DigitalOcean app spec on Sept 10, 2024 at 00:20 UTCmcp:put_page
high · confidence 0.95
85projects
Sep 10, 12:54 AMKLAVIYO_PRIVATE_API_KEY was accidentally dropped from the live DigitalOcean app spec on Sept 9, 2024 at 15:11 UTC when a .do/app.yaml push overwrote console-configured secretsmcp:put_page
high · confidence 0.95
85projects
Sep 9, 10:20 PMWhen appending to the CRO Ledger, Kip must always use existing dropdown options for columns with dropdowns — never override or free-type a differing value. This applies to Change Type, Confidence, A/B Tested?, and Status fields.mcp:put_page
medium · confidence 0.95
62commitments
Sep 7, 6:28 PMKip's custom-built tool does not work properlymcp:put_page
medium · confidence 0.95
62projects
Sep 5, 3:56 AMKip had a grounding-rule over-reach that prevented it from summing numbers it had already retrieved and listed in its own reply.mcp:put_page
medium · confidence 0.95
62projects
Sep 5, 3:32 AMKIP has an org memory module at apps/api/src/modules/memory; as of September 2026 it has no session checkpointing and no durable account-facts store.import: Kali scratchpad consolidation (MEMORY.md, 2026-09-05)
medium · confidence 1.00
65projects
Sep 5, 3:32 AMIn KIP every memory auto-commits immediately with no review queue, including self-incident memories KIP files about its own mistakes; only customer care governance requires approval.import: Kali scratchpad consolidation (MEMORY.md, 2026-09-05)
medium · confidence 1.00
65projects
Sep 5, 3:31 AMKIP's Google Workspace OAuth runs in GCP project runkip-506321, with the client secret at ~/.hermes/google_client_secret.json and a venv at ~/.hermes/google-venv whose python runs the Workspace scripts.import: Kali scratchpad consolidation (MEMORY.md, 2026-09-05)
medium · confidence 1.00
65projects
Sep 5, 3:31 AMKIP's daily brief sections are Overnight, On your plate, Watch items, and One thing to close.import: Kali scratchpad consolidation (MEMORY.md, 2026-09-05)
medium · confidence 1.00
65projects
Sep 5, 3:31 AMKIP's daily brief goes to Edgar Acosta, Joshua Alger, Brendan Schwartz and Audrey Dunkley at 8:05 AM MST as a Slack DM, sourced from Fathom, Gmail and Slack, written as four reasoned sections with no template, footer or attribution.import: Kali scratchpad consolidation (MEMORY.md, 2026-09-05)
medium · confidence 1.00
65projects
Sep 5, 3:31 AMKIP's Slack bot user ID is U0BG98CJ2UB and Devin's Slack user ID is U0BFYUN0BM1.import: Kali scratchpad consolidation (MEMORY.md, 2026-09-05)
medium · confidence 1.00
65projects
Sep 2, 8:32 AMAt least two confirmed real occurrences of the RLS recall timeout bug, both involving Audrey, Brendan, and Joshua Alger on different daysmcp:put_page
high · confidence 1.00
90projects
Sep 2, 8:32 AMPR #1431 changes timeout behavior to return 'recall unavailable, retry' instead of false claimsmcp:put_page
high · confidence 1.00
90projects
Sep 2, 8:32 AMPR #1431 fixes recall search by moving it into a tenant-scoped SECURITY DEFINER functionmcp:put_page
high · confidence 1.00
90projects
Sep 2, 8:32 AMThe RLS recall timeout bug causes Kip to confabulate 'no access' or 'not synced' errors instead of admitting unavailabilitymcp:put_page
high · confidence 1.00
90projects
Sep 2, 8:32 AMKip has a confirmed bug (PR #1431) where Slack conversation recall times out under RLS because Postgres won't use the full-text index behind row-level securitymcp:put_page
high · confidence 1.00
90projects
Sep 2, 5:55 AMPhrase-based detectors were insufficient for checking Google artifact creation and have been replacedmcp:put_page
medium · confidence 0.90
58projects
Sep 2, 5:55 AMA remaining gap was identified: the outer 240s reasoning deadline can timeout and discard the receipt link before the fallback logic reads itmcp:put_page
medium · confidence 0.95
62projects
Sep 2, 5:55 AMKip's new validation rule: if a tool receipt confirms a workbook/doc was created, the reply must reference that artifact's id or URL or it won't shipmcp:put_page
medium · confidence 0.95
62projects
Sep 2, 5:55 AMPR #1413 replaces phrase-based detectors with receipt-anchored validation for Google artifact creationmcp:put_page
medium · confidence 0.95
62projects
Sep 2, 5:55 AMPR #1413 was merged into the kip repomcp:put_page
medium · confidence 0.95
62projects
Sep 2, 1:59 AMMemory content source: User sends governance documents via zip files in Slack; KIP reads and extracts policies from these files for memory storage.import: KIP vault memory via kip_vault_search row 2d556207-dbbc-484f-942d-66613ffc4437 (commitments)
medium · confidence 1.00
65projects
Sep 2, 1:58 AMA truthfulness test passes a system that is honestly broken: Devin's browser run on PR #1125 hunted adversarially for a notice that claimed a Vault move which did not happen. It found none, and reported the move fixed. It was still broken: a note whose organization proposal had been dismissed returned "not moved" forever, with no way out. The run could not catch it, because "not moved" was a completely truthful description of a permanent dead end. The bug was not dishonesty - it was a dead end wearing honest words. Why it matters: we spent this cycle teaching KIP not to lie about what it did, and that discipline is real. But "did it tell the truth?" and "did it work?" are two different questions, and passing the first is not evidence about the second. When reviewing an agent's work, ask what the user can DO NEXT after each outcome, not just whether each outcome was described accurately. An honest "no" that can never become a "yes" is still a broken feature.import: KIP vault memory via kip_vault_search row 3999868f-c747-415c-b8bf-d6f029b77b57 (commitments)
medium · confidence 1.00
65projects
Sep 2, 1:58 AMMemory save behavior: Once user confirms, KIP saves governance policies to organizational memory automatically and reports back; user can reply 'stop saving these' to change behavior.import: KIP vault memory via kip_vault_search row 8b3dc26c-e448-4ee2-8a55-f50ec61a3a37 (commitments)
medium · confidence 1.00
65projects
Sep 2, 1:58 AMSelf-grounding required for KIP claims: KIP must read its own ledgers before speaking about itself; fabricated precision on future commitments is the target, vague futures remain natural.import: KIP org memory via kip_get_context (commitments)
medium · confidence 1.00
65projects
Sep 2, 1:58 AMContext Transfer Document — KIP Infrastructure Hardening Thread (2026-08-29 to 08-31): # Context Transfer Document — KIP Infrastructure Hardening Thread Covers: 2026-08-29 through 2026-08-31, `Kings-Loot/kip` repo, branch `claude/new-session-fislos` A note on fit before the sections: the requested template (Company Context, CEO psychology, KPIs, RACI) is built for a business-strategy conversation. This thread was almost entirely a technical incident-response and infrastructure-hardening session. Every section below is filled honestly — some (Company Context, KPIs in the traditional sense) have thin material because that's genuinely what was discussed, not because it was compressed out. --- ## 1. Executive Summary **What this thread was mainly about:** KIP (Kings Loot's internal AI assistant/decision-intelligence system, lives in Slack) suffered a serious production outage on 2026-08-29 — background cron jobs and interactive Slack chat share one server process and one 10-connection database pool; a stuck job drained the pool, and the whole assistant went silent for stretches, with a self-sustaining restart loop. Joshua ran the entire day (into early morning 08-31) directing "Devin" (an AI coding agent with GitHub/DigitalOcean/Slack access) through diagnosis, fixes, and a full architectural hardening program, with Claude acting as an independent verifier and plain-language translator between Joshua and Devin's technical reports. **Key decisions made:** - Approved and shipped a full architectural fix: background schedulers moved off the API process onto a separate DigitalOcean worker component (+$12/mo), so a stuck job can no longer take down interactive Slack. - Approved a durable "never lose the ask" capture mechanism so an incoming Slack message can never be silently destroyed again (this is what happened in an earlier, previously-undiscussed Aug 10 incident: two messages vanished for 6 hours). - Approved locking down a raw-message capture table that had accidentally been readable by any part of the app (cross-tenant/cross-user data exposure), via a dedicated least-privilege database credential, fail-closed if missing. - Decided to keep Retention OS (a scheduled spreadsheet-refresh job) **paused indefinitely** at Joshua's explicit request, even after its root cause was found to be already fixed. - Decided **not** to do a full git-history rewrite to scrub an accidentally-committed personal phone number (Joshua's own, private repo, not a live credential) — accepted as low-risk, added a CI guard idea instead. - Established (and repeatedly enforced) a working principle: verify every claim Devin makes against real code/production/CI before acting on it — this caught real stale-checkout mistakes on both sides during the day. **Current state at end of thread:** Core outage is fixed and verified live. Worker split is live and verified (all ~24 schedulers moved, zero on API process). The capture-table security fix is in two parts: the new credential is live and provisioned (#1383, merged); the final step that revokes the old broad access (#1387) was open, CI not yet green, not yet merged. Follow-ups never fully confirmed: the CI guard for phone-number-shaped committed values, and a small "document the kip_ingest test role" environment-doc suggestion. --- ## 2. Company Context Not substantively discussed in this thread — this was an infrastructure firefight, not a strategy conversation. What's inferable only from peripheral evidence (Slack channel names, KIP's own daily production-report excerpts glimpsed while debugging), **not confirmed or elaborated on by Joshua directly**: - Kings Loot appears to be a Shopify-based e-commerce company (references to Shopify sales data, "Kings Loot Performance Marketing Tracker," BEROAS metrics, CM/contribution-margin tracking, a "13 Week Cashflow Forecast"). - KIP is an internal tool, not a resold product — confirmed explicitly: "tenant" in the codebase means per-KIP-user/account isolation within Kings Loot itself, not external paying customers (Joshua corrected this mid-thread). - Slack channels visible in screenshots suggest departmental structure: `kl_finance`, `kl_marketing`, `kl-directors`, `kl_ceo`, `kl-merchandising`, `kl_ap` (accounts payable), `kl-annual-planning`, `kl_brand`. No revenue figures, strategic goals, or constraints were discussed. Do not infer business strategy from this thread. --- ## 3. CEO / User Context (Joshua Stephens) Based entirely on observed behavior across a long thread — this is evidence, not speculation: **How he thinks / decision-making style:** - Wants the plain-English "why" before agreeing to anything — asked for "lamens terms" repeatedly, and pushed back hard when explanations stayed technical or got recursive/circular. - Decisive once he understands something: approvals came fast and cleanly once the tradeoff was clear (e.g., approved the worker split, $12/mo, immediately once he understood the mechanism). - Values proportionality: explicitly rejected a technically-"correct" but disruptive fix (full git-history rewrite) once told the real-world risk was low ("ya, no big deal"). - Gets visibly frustrated by process friction that doesn't map to the actual goal — a Slack-webhook/app-installation saga produced real frustration ("Why is this getting overcomplicated," "I'm sick of messing with this") and he explicitly deprioritized a nice-to-have (Slack delivery for one alert) rather than keep fighting a platform limitat …[truncated]import: KIP org memory via search_memory row 1c00a82d (engineering)
medium · confidence 1.00
65projects
Sep 2, 1:57 AMMemory commit confirmation protocol: User can confirm memory saves using any word; KIP must ask for confirmation before committing governance policies to organizational memory.import: KIP vault memory via kip_vault_search row 2111f513-24c9-4a5d-961e-3dce80d71265 (hiring)
medium · confidence 1.00
65projects
Sep 2, 1:56 AMKIP Memory Read Architecture Review — 2026-08-19: # KIP Memory Read Architecture Review — 2026-08-19 **Question under review:** before continuing a1-shadow-4, is Activation the right layer to optimize, or is the layer underneath it — the durable-memory universe Activation selects from — incomplete? **Short answer: the layer underneath is incomplete. a1-shadow-4 should be re-sequenced, not because the work is wrong, but because its pre-registered metrics would currently measure selection quality over a candidate set that structurally excludes the memory class this incident needed.** --- ## 0. Epistemic status of this review Four tiers of claim in this document, marked throughout: - **[V-doc]** — verified in the second review against `main@e23ab77` with file:line citations, cross-consistent with the findings doc. I could not independently re-run these greps this session (no repo credentials in this container; `git ls-remote` fails unauthenticated). Line-level re-verification, if wanted, should target the pinned commit. - **[V-live]** — verified by me in the prior adversarial-regression session against a live PostgreSQL with real migrations, at `main@2540e5b4` (see `claude_KIP-Adversarial-Regression-Report-2026-08-19.md`). - **[DB-Devin]** — production-database numbers from Devin's investigation (the three generation timestamps, the 76/~1,240 ≈ 6% figure, the re-run FTS ranking). Taken as given; I have no DB access. - **[Inference]** — architectural reasoning from the above. Explicitly labeled. **One unresolved factual discrepancy between your two documents, flagged rather than adjudicated:** the earlier status update states `recall_kip_actions` exists and is instructed as the authoritative source for "what did KIP do." The second review's audit of the 55 tool-loop tools finds **no general action-recall tool — only `list_eadin_write_actions`** [V-doc]. Possible reconciliations: `recall_kip_actions` exists on a different surface (MCP, one-shot) but isn't wired into the Google tool loop; or it was renamed/scoped down; or the instruction text references a tool that was never wired. **This needs a one-grep answer before the sequencing below is finalized**, because if general action recall is genuinely unreachable on the dominant path, the PO-denial failure class ("KIP forgot what it did") is still open on ~94% of turns despite PR 4a. **One open empirical question from the incident itself:** the findings doc's "zero occurrences of *archived* in the denial prompt" does not settle whether `get_stored_weekly_analyses` was offered on that turn, because the loop's own strings use *archive*, not *archived* [V-doc]. Re-grep the denial turn's prompt for `get_stored_weekly_analyses`. If present: the failure story is *tool offered but structurally incapable* (no free-text key). If absent: `input.analyses` wasn't set and there's an additional routing/config defect. The fix below covers both, but the incident record should state which happened. --- ## 1. Current end-to-end memory read architecture ### 1.1 The two answer paths ``` Slack turn arrives │ routing gate (service.ts:21481-21513) ~28-term disjunction: "is ANY reader configured?" (eadinReader || shopifyReader || qboReader || ... || analysesReader || openLoopsReader || mailbox...) │ ┌───────────────────────┴──────────────────────────┐ │ effectively ALWAYS TRUE on production tenant │ │ [V-doc code shape; DB-Devin: ~94% of generations] │ ▼ ▼ GOOGLE TOOL-LOOP PATH (~94%) ONE-SHOT GROUNDING PATH (~6%) ───────────────────────────── ──────────────────────────── Automatic pre-turn context: Automatic pre-turn context: • images • everything at left, PLUS • attached documents • memories block • Loom transcripts • archivedAnalyses block • prior conversations (retrieveArchivedAnalyses → • mailbox lessons searchDocAnalyses FTS, top 3, • partnership preamble runs every turn, no classifier) • openLoops block NO organizational memory, • recentLearnings block NO prior-work archive, • actionRecall block NO open loops, NO learnings, • meetings / aiSessions / NO action history — automatically. eadinReports / etc. blocks │ ▼ 55 tools, reachable ONLY if the model chooses to call them ``` ### 1.2 Where each durable source enters — or fails to | Durable source | One-shot path (~6%) | Tool-loop path (~94%) | Status | |---|---|---|---| | `memory_entries` (Organizational Memory) | automatic block | `search_memory`, `list_recent_memory` [V-doc] | reachable, opt-in on dominant path | | `open_loops` (continuity) | automatic block | `get_open_loops` [V-doc] | reachable, opt-in | | meetings / aiSessions / Eadin reports | automatic blocks | tools exist [V-doc] | reachable, opt-in | | `doc_analyses` (KIP's own archived work) | automatic block, FTS by free text | `get_stored_weekly_analyses` — **title + week range only, no free-text query** [V-doc: schema at `doc-analyses.ts:404-417`] | **reachable but structurally incapable of subject/person recall** | | `recentLearnings` | automatic block | **no tool among the 55** [V-doc] | **unreachable on ~94% of turns** | | general action recall | automatic block | **only `list_eadin_write_actions`** [V-doc; see discrepancy §0] | **at best Eadin-only on ~94% of turns** | | `ai_generations` (every substantive output KIP has ever produced) | not indexed, not retrieved | not indexed, no tool [V-doc §5 of review] | **unreachable on both paths — write-only** | | `experiences` (new Experience Ledger) | — | — | written by Activation shadow [V-live]; **no evidence any answer path consumes it** [Inference] | | Governance | via MCP tools / instructions | via MCP tools | reachable (not audited here) | ### 1.3 Answers to your three direct questions **What does KIP receive automatically before reasoning?** On the path that produces ~94% of answers: images, attached docs, Loom transcripts, prior conversations, mailbox lessons, partnership preamble [V-doc]. That is *conversational* context. **Zero organizational memory of any kind arrives automatically on the dominant path.** The rich pre-turn grounding you designed lives almost entirely on the path that almost never runs. **What exists but only if the model decides to look?** Organizational memory, open loops, meetings, AI sessions, Eadin reports, and (by title/week only) the work archive. **What is durable but completely unreachable from the dominant path?** Recent learnings, general action recall (pending the §0 discrepancy check), and the full text of everything KIP has ever produced (`ai_generations`). --- ## 2. What universe does Activation actually operate over? This is the crux, and the answer comes from live-DB verification, not inference: 1. **Activation runs in shadow**: `ActivationShadowIntegration.handleEvent()` drives raw signal → engine → persisted `experiences` row [V-live]. Its output is not consumed by either answer path [Inference — no consumption site appears in either document or the audit; Devin should confirm with one grep]. 2. **Activation's entitlements are frozen off**: `accessScopes: []` is hardcoded at `activation-shadow-integration.ts:236`, independent of the `resolveAccessScopes()` stub — proven against a real leadership-entitled subject and a restricted memory a working reader *does* surface when given the real grant [V-live]. 3. **Activation's candidate universe is the memory/experience layer.** `doc_analyses` is a separate table reachable only via the one-shot prefetch and the title/week tool; `ai_generations` is indexed by nothing [V-doc]. Neither is in the universe Activation ranks [Inference, strong — they are not in the memory retrieval infrastructure Activation reads through]. **Therefore: Activation today selects from an incomplete upstream universe, with entitlement-gated memory additionally invisible to it, and its selections influence nothing.** Three independent gaps, and a1-shadow-4's memory-axis capacity work addresses none of them — it improves ranking *within* the truncated candidate set. The incident is the concrete proof: no embedding model, no capacity increase, and no selection improvement would have surfaced Brendan's and Audrey's summaries, because on the path taken, those records were not in any candidate set to be selected. **This was a recall hole, not a precision problem, and a1-shadow-4 is precision work.** --- ## 3. Failure modes (ranked, with class assignments) Using the ledger's severity vocabulary — "silently wrong" is the top of the ladder. **F1 — Silently wrong, active data destruction: the `docKey='general'` collision.** `onConflictDoUpdate` on `(tenant_id, doc_key, week_start)` with `docKey` defaulting to `'general'` for any analysis not resolvable to a Drive file; `summary` is replaced in place, no supersession pointer, no lineage [V-doc: `google/service.ts:2133-2139`, `schema.ts:4257-4258`]. Two unresolvable analyses in the same week → the second silently destroys the first. **Severity: High, latent-but-armed** — it has not visibly fired yet (Brendan's resolved to a Loom key, Audrey's to the KPI tracker, Joshua Alger's was never archived), but every week of operation rolls the dice. This is the exact defect class PR 2 eliminated from the Memory Steward, alive in an adjacent table. It violates I2 and I9 and — worse — it is *invisible in retrospect*: a later "did you review X?" gets answered correctly from the record and wrongly in fact. **F2 — Silently wrong, the incident class: confident absence claims without a read.** `retrieveArchivedAnalyses` returns `undefined` for *no terms*, *no match*, and *query failed* alike; downstream spread makes all three indistinguishable [V-doc: `service.ts:~22488-22513`, `:22095`]. And on the dominant path, no archive read happens at all unless the model chooses a tool that cannot express the query. The findings doc's framing ("not a hallucination — it reported absence of evidence it genuinely didn't have") is right about the model and wrong about the system: **KIP asserted a fact about its own durable state on a turn that could not read that state.** This is the read-side twin of ledger invariant #10 (INC-010, the Amex fabrication): a first-person claim ungrounded in a same-turn read. **F3 — Structural: the learning loop is severed on the dominant path.** `recentLearnings` has no tool and no block on the tool loop [V-doc]. Whatever the correction/learning pipeline captures cannot influence ~94% of answers. This quietly falsifies the governance's core learning claim — "corrections should be capable of affecting future behavior immediately" — for the paths where behavior actually happens. Same finding-shape as F2: the memory exists; the dominant path is blind to it. **F4 — Structural: KIP's own work product is write-only.** Substantive outputs persist in `ai_generations` but enter no index; `doc_analyses` is populated only on explicit request [V-doc]. So KIP's episodic memory of its own labor depends on a human remembering to say "store this." Joshua Alger's summary — real, competent, durable — is invisible to every retrieval mechanism KIP has. This is a **perception gap**: "KIP produced a substantive output" is a meaningful organizational event that generates no experience. **F5 — Architectural: two answer paths with two memory architectures.** The one-shot path carries the grounding you designed; the tool loop is the path that runs. Every block on the unsupported list is a fact about *path divergence*, not about memory. This is the "one authority per fact" invariant violated in path form — the same context-assembly responsibility implemented twice, unequally, with drift. Expect (as the review predicts) every future "KIP forgot / denied / didn't connect it" to trace here. **F6 — Meta: the regression test for the incident is structurally unwritable.** `buildEvalToolLoopInput` throws on `archivedAnalyses` and 13 other fields [V-doc: `evals/tool-loop.ts:47-49`]. Verified claim, but the diagnosis needs one sharpening — see §6. --- ## 4. What Activation already solves, and what it cannot **Already solves (or will, once live):** selective attention over admitted organizational memory; event-driven persistence of experiences from raw signals [V-live]; the "don't dump everything" half of your goal. The shadow discipline itself — pre-registered metrics, frozen paths — is exactly right and should not be weakened. **Cannot solve, at any quality level:** - **Recall of records outside its universe.** No ranking function retrieves candidates that were never in the candidate set (F4, and `doc_analyses`' isolation). - **Path blindness.** Activation output consumed by no answer path influences no answer (shadow status; and even when promoted, it must feed the tool loop, not the 6% path). - **Absence-claim honesty.** Better retrieval lowers the *frequency* of false denials; it cannot make them *impossible*. Only a read-receipt guard does that (§7). A tool that must be chosen cannot prevent a confident denial, because — as your reviewer put it — the denial *is* the choice not to look. - **Entitlement-scoped memory**, until `accessScopes` unfreezes [V-live]. --- ## 5. Target memory read architecture Nothing here is "dump more context." Every layer is bounded; the design goal is exactly yours — a small, high-quality working context with tools for depth — plus the property the current system lacks: **claims about durable state require reads of durable state.** ``` LAYER 0 — DURABLE SOURCES, each with a discriminated read contract memory_entries · experiences · doc_analyses (append-only, fixed) action ledger · open_loops · learnings · ai_generations (indexed) Every read returns {status: ok | empty | failed | not_attempted, source, checkedAt, count} — never undefined-means-three-things. LAYER 1 — EXPERIENCE SPINE (closes the perception gap) "KIP produced a substantive output" is itself an event → auto-captured as an experience with structured subjects (people, docs, workstream, channel/thread provenance). ai_generations stays the text store; the spine is the index. Store intrinsic facts (the output, its subjects, its source); derive recall (FTS/embedding over the spine). No duplicate bodies. LAYER 2 — ONE AUTHORIZED RETRIEVAL GATE Single code path: permission-aware (accessScopes live, not []), lifecycle-aware (demoted excluded by default, includeDemoted escape hatch — already correct, reuse it), source-complete. Both answer paths — however many remain — read through it. LAYER 3 — ACTIVATION (a1-shadow series, resumed) Ranks over the COMPLETE Layer-2 universe. Pre-registered embedding decision preserved and now meaningful: it measures selection over the set that actually contains the answers. LAYER 4 — WORKING-CONTEXT FLOOR (small, non-optional) Identity · recent actions (from ledger) · open loops touching this channel/people · recent learnings · active workstream refs. Hard token budget (~1-2k). Not RAG; a continuity floor. Activation's selected set rides on top of it. LAYER 5 — ONE ANSWER PATH, tools retained for depth The tool loop becomes THE path; the one-shot grounding assembly is folded into Layers 2+4 rather than maintained as a rival. CROSS-CUTTING — READ-RECEIPT INVARIANT (§7) Absence assertions about durable state require same-turn successful read receipts of the mapped sources. Type-and-state, enforced at claim time, mirrors claimHasReceipt / SelfReadReceipts. ``` --- ## 6. Verifications requested (all confirmed or sharpened in full thread) **6.1 — Incident fix = add `query` to `get_stored_weekly_analyses`, routed to `searchDocAnalyses`?** Confirmed, with two additions. **6.2 — The `(tenant,'general',weekStart)` collision?** Confirmed as cited; severity High, latent-armed, "silently wrong" class. **6.3 — Regression test structurally unwritable?** Confirmed, with harness-sharpening: durable-source fixture seeding, not block injection. **6.4 — Read-side receipt invariant?** Strongly endorsed; extends SelfReadReceipts/claimHasReceipt family. **6.5 — Substantive outputs auto-become durable memory?** Yes — as Experience, not Memory; prevents KIP's generations bootstrapping into organizational truth. **6.6 — Non-optional pre-reasoning continuity context?** Yes, bounded (~1–2k tokens); strategic call is Joshua's. --- ## 7. Recommended sequencing Ordered by (a) active-loss risk, (b) verifiability-before-feature, (c) universe-before-selection. Steps 1–2 independent and parallelizable. 1. **Stop the bleeding: `doc_analyses` append-only + supersession** 2. **Unblock the eval harness: durable-source fixture seeding** 3. **Incident fix: `query` on `get_stored_weekly_analyses` + structured subjects + discriminated result** 4. **Read-receipt invariant + absence-claim guard** 5. **Experience spine: auto-capture substantive outputs as subject-tagged experiences** 6. **Working-context floor** (strategic call: Joshua) 7. **Resume a1-shadow-4** — pre-registered decision intact, accessScopes unfrozen, candidate-universe-coverage metric added --- ## 8. Verdict on a1-shadow-4 **CHANGE — hold execution and re-sequence; do not discard.** The work targets a real future need (selection quality will matter enormously once the floor and spine exist). But run today, its pre-registered evaluation would rank candidates from a universe missing: KIP's own work products, the archive's subject axis, learnings and action history on the dominant path, entitlement-scoped memory — and its output would be consumed by nothing. The pre-registration is *preserved*, and becomes more valuable, by executing after step 5. Optimizing Activation first = most sophisticated possible ranking of an incomplete candidate set.import: KIP vault memory via kip_vault_search row f18fcc7b-04fe-4ffc-94b1-ceb13a698f4b (creative)
medium · confidence 1.00
65projects
Sep 2, 1:56 AMKIP-Organizational-Memory.md — 12. Proposals & CEO Decisions: **Standing governance/SSOT documents:** `marketing-os.md`, `kpi-bands.md`, `meta-creative-governance.md` (v1.7 as of 2026-08-17), `creative-strategy-framework.md`, `system-build-prompt.md`, `product-launch-gtm-research-prompt.md`, `test-and-initiative-triage-gate.md`, `post-test-readout-decision-matrix.md`, `retention-testing-operating-system.md`, `retention-seasonal-map.md`, `q4-performance-scorecard.md`, `weekly-marketing-scorecard.md`. **Proposals to the CEO, with status as best determined from each document:** | Proposal | Date | Status | |---|---|---| | Audrey Retention Management Meeting Proposal | 2026-08-21 | Pending, 5 open decisions listed before it can go live | | Creative Ledger Sync + Hook Delivery Scope | 2026-08-17 | Mixed, Build A approved same-day; Build B pending a live validation test | | Governance Amendment, Creative Ledger | 2026-08-17 | Approved and applied, bumped `meta-creative-governance.md` to v1.7 | | Luggage Returns & Servicing System (v2) | 2026-08-05 | Status unclear, for review by 4 named people, no decision language | | Passport Meta GTM Strategy (v2) | 2026-06-11 | Status unclear in-doc; appears to override the LP Copy proposal's recommended hero | | Trybe Creator Program Proposal | 2026-08-24 | Pending, one day old | | YouTube Demand Creation Engine Proposal | 2026-07-03 | Approved | | Kings Loot Homepage Redesign Proposal | 2026-06-24 | Status unclear, ends on the ask | | Money Clip Collection Sort Test Proposal | 2026-06-22 | Status unclear, ends on the ask | | Passport LP Copy Proposal | 2026-06-05 | Status unclear; likely superseded by the GTM Strategy doc six days later | | Passport Profit Levers Memo | 2026-06-05 | Contains an inline "Decision:" framing but still asks the CEO to align | | YouTube 90-Day Operating Plan | 2026-07-03 | Approved, the operating plan behind the approved direction | | YouTube Launch and Scale Plan | 2026-07-07 | Strategy pre-approved; this specific scale plan marked for CEO review | **Standing rules for any future proposal to the CEO:** exclude budget figures, granular tactical settings, and week-by-week schedules, those are operator decisions made after directional approval. Never propose killing an existing working program, reframe risk as a mitigation woven into the new approach. Close on one single execution-focused approval ask, not a checklist. ---import: KIP org memory via kip_get_context (creative)
medium · confidence 1.00
65projects
Sep 2, 1:56 AMKIP Context Transfer — 2026-08-21: # Context Transfer Document — KIP Cognitive Architecture Program **Source thread:** Governance review → implementation status review → memory-incident architectural review **Date compiled:** 2026-08-21 **Companion artifact from this thread:** KIP-Memory-Architecture-Review-2026-08-19.md (full deliverable; this document references but does not replace it) --- ## 1. Executive Summary **What this thread was about.** Three connected reviews of KIP, Kings Loot's organizational AI agent, as it is converted from "an LLM with memory features into a persistent cognitive system": (1) review of the *KIP Cognitive Architecture & Learning Governance* document (the foundational governance standard, in Google Drive); (2) review of the implementation status update covering merged PRs 1–3a and in-flight PR 4a; (3) a full architectural review of a production memory incident — KIP confidently denied having reviewed managers' weekly packets/Looms that it had in fact reviewed — including adjudication between two investigation documents and a verdict on whether the planned a1-shadow-4 Activation work targets the right layer. **Key decisions/verdicts from this thread** (status: assistant recommendations; Joshua has not explicitly ratified in-thread unless noted): - **The incident was a recall hole, not a precision problem.** ~94% of KIP's answer-generating turns run through a tool-loop path that carries zero organizational memory automatically; the rich one-shot grounding path handles ~6% of turns. a1-shadow-4 (Activation memory-axis capacity work) would optimize ranking over an incomplete candidate universe. - **a1-shadow-4 verdict: CHANGE — hold execution, re-sequence after universe completion, preserve the pre-registered OpenAI embedding decision intact.** Add one metric: candidate-universe coverage. - **Incident-level fix confirmed:** add a free-text `query` param to the existing `get_stored_weekly_analyses` tool, routed to the existing `searchDocAnalyses` FTS. Evolve the primitive; do not build `search_my_prior_work` beside it. - **The `docKey='general'` collision in `doc_analyses` is the worst finding in the thread** — silent in-place destruction of history (Sev High, latent-armed). Fix first: append-only + supersession mirroring `memory_entries`; do NOT merely widen the unique key. - **Eval harness sharpening:** the harness throwing on `archivedAnalyses` is honest (the production loop genuinely can't carry that block). The fix is durable-source **fixture seeding** into the live-DB test infrastructure, not block injection. - **Read-receipt invariant endorsed** as the class fix: KIP may never assert durable absence ("no record," "we never did this") without a same-turn successful read receipt of the mapped durable source(s). It is an extension of the existing SelfReadReceipts/`claimHasReceipt` family (INC-010 lineage), not new infrastructure. - **Substantive KIP outputs should auto-become Experience, not Organizational Memory** (prevents KIP's own generations bootstrapping into organizational truth). - **Recommended 7-step sequence** (see §6/§11). **Current state.** PRs 1, 1-followup, 2, 3a merged. PR 4a (authoritative fail-closed Action Ledger for Eadin writes) underway with Devin. a1-shadow-4 paused pending Joshua's call on the re-sequencing. Two one-grep factual discrepancies remain unresolved (§7). The continuity-floor decision is explicitly Joshua's strategic call, recommendation = yes, bounded. --- ## 2. Company Context - **Company:** Kings Loot (production tenant `kingsloot.com`). E-commerce/DTC. Business model and revenue stage were **not discussed in this thread** — do not invent them. - **Repos/ecosystem:** `Kings-Loot/kip` (KIP, Claude-powered agent; default branch `main`), `Kings-Loot/eadin.io` (internal ERP — query tool, P&L home; default branch `master`), `Kings-Loot/klick-stream` (UGC creator content scaling; new). - **Integrated systems:** Slack (KIP's primary surface), Eadin (inventory/ERP/finance), Shopify, QuickBooks, Klaviyo, Meta Ads, Richpanel, Google Drive/Gmail/Calendar, Fathom, ClickUp, TripleWhale, Intelligems, Ramp, Vercel, Vista Social. Amazon parity is a live Eadin reconciliation concern. - **Two AI agents:** KIP (organizational agent) and Devin (engineering implementer). Claude (this assistant, across threads) acts as architect/reviewer/ledger maintainer. - **Strategic goal:** KIP as a persistent organizational intelligence system — "an exceptional long-tenured employee" with machine-scale storage, provenance, verification, and learning speed. Six-month north-star UX: tag KIP about work from weeks ago and it already knows objective, history, decisions, actions taken (verified), open loops, and likely next step. - **Operating constraints:** Only Joshua merges PRs; only Joshua approves production AP writes. LLMs/agents are **untrusted request originators**; Eadin's trusted enforcement layer owns authorization, execution, verification, audit, final state. No code changes during investigations until architecture review completes. Build general-purpose composable primitives in kip, never one-off workflows. - **Foundational operating principles (exact wording, load-bearing):** - "Never forget that something happened. Be selective about what you believe." - "Experience is historical truth. Memory is current understanding." - "Captured ≠ admitted ≠ committed." / "Intent ≠ execution ≠ verification ≠ outcome." - "Lifecycle ≠ epistemics." / "Authority is contextual." / "Provenance is mandatory." - "Absence is not a state model." / "Archiving is not deletion." - "Persist intrinsic facts; derive contextual state." - "The ledger—not conversational memory—answers 'what did I do?'" - "Live operational truth comes from authoritative systems, not stale memory." - "Governance controls authority, not recollection." - "A mistake isn't learned until future behavior changes." - From this thread's review: "A tool that must be chosen cannot prevent a confident denial, because the denial *is* the choice not to look." And the promoted principle: **"Identity-critical context is not classifier-gated and not choice-gated."** --- ## 3. CEO / User Context (Joshua Stephens) - **How he thinks:** architecture-first, principle-driven, incident-fueled. Converts every production failure into an invariant, then into system enforcement ("fix the invariant that allowed the failure, never the symptom"). Explicitly separates conceptual architecture from implementation. Suspicious of prompt-only governance. Comfortable pausing roadmap items (a1-shadow-4) to question whether the layer underneath is correct. - **Preferences:** review before build ("Do not implement anything yet. I want an architectural review first."). Wants verified code facts separated from architectural inference — explicitly requested and should be default practice. Wants primitives evolved rather than parallel systems built. Anti-RAG-dump: "The goal is still selective, intelligent memory. KIP should feel like Claude/ChatGPT with exceptional organizational memory, not like a giant RAG prompt." - **Decision-making style:** delegates implementation to Devin, retains strategic/architectural calls explicitly (e.g., the continuity-floor decision was flagged as "Joshua's, not Devin's"). Ratifies via merge. Preserves pre-registered experimental decisions (a1-shadow-4 embeddings) rather than letting incidents invalidate methodology. - **Strengths:** rare clarity on epistemics (capture≠belief), willingness to be told his plan targets the wrong layer, investigation discipline (timeline corrections, byte-for-byte prompt checks). - **Risks / blind spots to watch:** (1) Definition-of-Done and governance remain qualitative — measurement keeps getting deferred (flagged twice, still open). (2) Multi-agent attribution (Devin's actions live in no ledger KIP can query) flagged twice, unaddressed. (3) Recurring operational security lapse: GitHub PATs pasted into chat across multiple sessions; rotation flagged repeatedly, unconfirmed. (4) Roadmap ambition (~two quarters of work) vs. sequencing discipline — the thread repeatedly pulled verification infrastructure earlier than he'd planned. --- ## 4. Key People / Roles **Joshua Stephens** — Owner/CEO. Sole PR merger, sole production AP write approver, holder of strategic architecture calls. Open question owned by him: adopt the continuity floor? Ratify the re-sequenced roadmap? **Devin** — AI engineering implementer on kip/eadin.io. Strengths: strong repo grounding (found existing-but-deferred architecture boundaries; corrected the epistemic-ladder design; proposed idempotency_key model), good challenge instincts ("contradiction is not lifecycle"). Risks: Devin modifies the system that records what Devin does — invariant-level regression tests are the only real protection; the original findings doc missed that `get_stored_weekly_analyses` already existed (central-claim error caught by second review). Currently owns PR 4a. Decisions about Devin: none personnel-level; work product should be verified against pinned commits, not descriptions. **Brendan** — Merchandising (SKU allocation, purchase orders, Fire Sale wk3). His Loom review (`Loom 5f6059a5`, Aug 18 3:47 PM PT, 3,986 chars) was one of the two summaries KIP falsely denied. **Audrey** — Customer Care / retention. Her review (filed under `[2024-2026] Advertising/Sales KPI Tracker`, Aug 18 5:19 PM PT, 2,014 chars) was the other falsely-denied summary. **Joshua Alger** — Marketing manager (distinct from Joshua Stephens). His summary (Aug 19 10:10 AM PT, 2,969 chars) post-dated the denial by 24 minutes and was never archived — the concrete example of the "substantive outputs aren't auto-captured" gap. **Claude (assistant role across threads)** — AI Cognitive Memory Architect (full role charter exists as a separate prompt doc), reliability-ledger maintainer, PR verifier (e.g., kip#1056 built-and-run verification), adversarial regression author. --- ## 5. Systems / Operating Models Discussed ### 5.1 KIP cognitive loop (governance-canonical) Perception → Experience → Activation → Working Context → Reasoning → Action → Outcome → Reflection → Learning → Prediction. Governance doc (Google Doc `1VsibVvg6eJrcdkS5T97paBGR5w6LugVlOTuFTl2QIZ0`) defines 20 sections; reviewed in full. Gaps identified in review: no durable record contract, no authority map, verification asserted but undefined, no failure/exception semantics, unmeasurable DoD, multi-agent actors unaddressed, supersession cascades unhandled, append-only vs PII tension. ### 5.2 Memory system Purpose: Organizational Memory (semantic) distinct from Experience (episodic). State: PR 1 removed the fake auto-memory toggle (learning is core behavior; infrastructure-only `MEMORY_AUTOMATION_KILL_SWITCH` remains — stopping belief formation must NOT stop observation). PR 1-followup enforced captured≠admitted≠committed. PR 2: non-destructive Steward, lifecycle states (active/superseded/merged/archived), `lifecycle_state` + `superseded_by_entry_id` lineage, `demotedAt/demotedReason` ("demoted, never deleted"). PR 3a: `returnToReview` archives instead of deletes; re-approval = "fresh belief identity + inherited applicable evidence/provenance." Retrieval gate excludes demoted by default with `includeDemoted` escape hatch — this pattern is the reuse template. Epistemics (PR 3b, upcoming): acquisition (asserted/inferred/observed) intrinsic; verification as event (`verified_at`); evidence links support/contradict; **authority derived at reasoning time, contradiction derived from evidence graph** — never stored booleans/scores. Guardrail added in this thread: derived-at-reasoning-time must mean *looking up a persisted, versioned, governance-owned authority …[truncated]import: KIP org memory via search_memory row 999c3c47 (advertising)
medium · confidence 1.00
65projects
Sep 2, 1:55 AMContext Transfer: Vault Entitlement & Team Access: # Context Transfer Document: Vault Entitlement & Team Access ## 1. Executive Summary **What this thread was about:** Unblocking the team Vault feature so Joshua can teach his team to use the Personal Vault system in KIP. Currently only one person (Joshua) has a Vault seat. **Key decisions made:** - ✅ Merged #1136 (per-user entitlement + RLS isolation) — **critical safety work** - ✅ Merged #1138 (fixed migration collision between #1136 and #1137) — **unblocked all deployments** - ❌ Closed #1139 (delete-from-Claude tool) — **paused by Joshua, feature on hold indefinitely** **Current state:** - Vault entitlement landed in code; waiting for next deploy to production - Two follow-up PRs in flight: Drive folder import (#1141) and card grid UI (#1142) - Team can use Vaults once the entitlement deploys and Joshua teaches them --- ## 2. Company Context **Product:** KIP (Kinetic Intelligence Platform) — decision-intelligence and memory system for kingsloot.com **Vault system:** Personal memory store per user. Joshua has 79 notes. Currently single-seat entitlement. Data model already supports per-user isolation (via `personalScopeTag(userId)` → `user:<uuid>`). **Strategic goal:** Enable team to use Vaults for collaborative memory. Joshua wants to teach the team tomorrow morning. **Critical constraint:** A team Vault that leaks private notes is worse than no team Vault. Safety > speed. **Important operating principle:** Defensive design. Read-back verification. Never trust mutation return values. Isolation must be database-level, not query-level. --- ## 3. Joshua's Context **How he thinks:** - Systems architect: focuses on deployment ordering, database isolation, guard rails, what could go dark silently - Reads specifications carefully; writes detailed ones - Explicitly pauses features when not confident in safety (like delete-from-Claude) - Willing to demo from his own Vault instead of shipping half-baked features - Values precision over speed **Preferences:** - Be direct and concise - Flag unresolved issues explicitly, don't gloss - Never ship features he's paused just because code is clean - Respect the Vault as personal space; deletion is his control, not Claude's **Communication style:** - Wants plain status: what merged, what cleared, what not started — stated plainly - Thinks in terms of systems, ownership, decision rights, and risk - Will tell you explicitly if something is dangerous --- ## 4. THE TRAP (Critical — Read This) **The RLS Policy Ordering Trap (§2 of vault-team-entitlement-spec.md):** `withTenant` does NOT set `app.user_id`. Only `withTenantAndUser` does. If you add an RLS policy that requires `kip_current_user()` to see a personal row, but call sites still use plain `withTenant`: - `app.user_id` is unset - `kip_current_user()` returns NULL - Personal rows match nothing - **Every Vault in the company goes dark** — including Joshua's 79 notes - The reads return empty rather than error, so it looks like the Vaults were wiped **This is the failure mode for an unattended overnight merge.** **How it was fixed:** Migrate every Vault-touching call site from `withTenant` to `withTenantAndUser` **first**, no behavior change yet. Only then add the RLS policy. This was done in #1136 before RLS landed (all 39 call sites migrated). --- ## 5. The RLS Policy (Database-Level Isolation) ```sql using ( tenant_id = kip_current_tenant() and ( visibility <> 'personal' or scope && array['user:' || kip_current_user()::text] ) ) ``` **Must have:** - `with check` as well as `using` - NULL handling: `scope && array['user:' || NULL]` must be NULL-safe and deny (not allow) - Apply same treatment to `memory_entry_links` **Background readers (auditor, schedulers, distillers):** - Must NOT read personal rows - Correct answer: policy branch that excludes personal rows outright, not a bypass - Any unenumerated background reader breaks isolation (41 notes were archived by auditor this way) --- ## 6. Decisions Made ### Decision 1: Merge #1136 (Per-user entitlement + RLS) - **What:** Add `users.personal_vault_enabled boolean` + `tenants.personal_vault_default_enabled boolean` + RLS policy - **Why:** Necessary to teach team to use Vaults. Single-seat was the blocker. - **Owner:** Joshua (requirement), Devin (code) - **Effective:** Merged; waiting for next production deploy - **Safety:** Database-level isolation, read-back verification, all 39 call sites migrated to `withTenantAndUser` before RLS landed ### Decision 2: Fix migration collision (#1138) - **What:** Rename #1137's migration from `20261007000000` to `20261007000100` - **Why:** Both merged; `main` couldn't migrate. Blocked all deployments. - **Effective:** Done - **Safety:** Safe — neither migration had run in production yet ### Decision 3: Close #1139 (delete-from-Claude tool) - **What:** Don't ship `kip_vault_delete` and `kip_vault_restore` MCP tools - **Why:** Joshua's explicit decision. `deletePersonal` is irreversible. "I'm not ready to give a model that power on its own decision. Removing a note stays dashboard-only for now." - **Owner:** Joshua (explicit hold) - **Timeline:** Indefinite hold ### Decision 4: Don't touch 23 demoted rows from other users - **What:** 23 personal rows from other users exist (demoted by founder-only migration) - **Why:** Joshua hasn't decided whether to restore, leave as org candidates, or leave alone - **Owner:** Joshua (awaiting decision) - **Timeline:** After #1136 lands, ask Joshua --- ## 7. Open Issues 1. **Deployment ordering for #1141 (Drive folder import):** - Code ready (3544/3544 tests pass) - Migration `20261008000000_vault_drive_imports` must deploy before #1141 writes - **Unresolved:** When does the migration deploy? 2. **Whether to restore 23 demoted rows:** Joshua hasn't decided. Don't touch. 3. **Kind defaults to fact (#4 in queue):** Small fix, not urgent. 4. **MCP tool visibility documentation (#5 in queue):** Is this blocking team teaching? --- ## 8. Key Metrics - **Joshua's current notes:** 79 personal Vault entries - **Test note ID:** `eee986e3-9840-4fda-90c1-60eec9bc0296` ("claude is awesome") - **Largest note tested:** 99,780 characters - **Vault call sites migrated:** 39 (all to `withTenantAndUser`) - **Vault tests:** 21 passing (#1142), 3544/3544 passing (#1141) - **Auditor damage:** 41 notes archived (isolation gap evidence) --- ## 9. Communication with Joshua **Be direct:** - Plain language, concise - Never gloss uncomfortable issues - State status plainly: what merged, what cleared, what not started **Think like systems architect:** - Focus on isolation guarantees, deployment ordering, guard rails - Flag silent failure modes (Vaults reading empty, not erroring) - Respect database-level contracts **Avoid:** - Generic advice - Claiming success when CI still building - Assuming deployment ordering (verify migration dependencies) - Ignoring explicit decisions (like the hold on delete tool) --- ## 10. Key Phrases to Preserve > "I'm not ready to give a model that power on its own decision. Removing a note stays dashboard-only for now." > "The whole point is that the guarantee no longer depends on the service... an unenumerated background reader is exactly how the 41 notes went." > "A team Vault that leaks is worse than no team Vault, and I'd rather demo mine for another day than explain to someone that their private notes were readable." > "Don't report this as working on the strength of the tests passing. Read the rows back." --- ## 11. Artifacts - Spec: `docs/vault-team-entitlement-spec.md` (on `claude/new-session-0tha8n`) - Development branch: `claude/new-session-0tha8n` - PRs merged: #1136, #1138 - PRs in flight: #1141 (Drive import), #1142 (card grid UI) - PRs closed: #1139 (delete tool)import: KIP vault memory via kip_vault_search row 730ab703-51af-422c-9bf6-3160ef16aa60 (Joshua Stephens)
medium · confidence 1.00
65projects
Sep 2, 1:55 AMInbox spam cleanup schedule: KIP will sweep both joshua.k.stephens@kingsloot.com and joshua@kingsholding.com three times daily (7:00 AM, 12:00 PM, and 5:00 PM PT, Monday–Friday) and post a recap only when spam is marked.import: KIP vault memory via kip_vault_search row 7c086c0c-b355-42b8-ae3b-80cf12d34092 (Joshua Stephens)
medium · confidence 1.00
65projects
Sep 2, 1:55 AMContext Transfer Document 07 29 2026: # Context Transfer Document ## KIP Operational Skills, Governance Framework & Continuous Improvement Architecture Thread Date: July 29, 2026 # 1. Executive Summary ## Primary Focus This thread centered on maturing KIP from an AI assistant into a governed Enterprise Execution Platform. Rather than discussing individual features, the conversation focused on how operational skills should be designed, governed, tested, verified, maintained, and continuously improved. Several important discoveries were made after observing KIP in production. ## Major Themes ### 1. Continuous Improvement Systems A significant insight emerged from reviewing the Customer Care Governance QA process. Originally the process emphasized: Review conversations. The conversation reframed the objective: Improve the operating system. The resulting operating flywheel became: Observe ↓ Audit ↓ Learn ↓ Improve Governance ↓ Deploy ↓ Retest ↓ Capture Organizational Learning ↓ Repeat Eventually another improvement was added: Teach KIP making the full loop: Observe ↓ Audit ↓ Learn ↓ Improve Governance ↓ Deploy ↓ Retest ↓ Capture Organizational Learning ↓ Teach KIP ↓ Repeat This became one of the most important operating principles discussed. ### 2. Customer Care Ownership Changed Edgar's responsibility was redefined. Instead of: Own the QA Process His responsibility became: Own the continuous improvement of the Customer Care Operating System. Conversations are no longer the product. They are merely evidence. The product is: The operating system itself. ### 3. Governance Improvement KPI A new KPI philosophy was introduced. Instead of measuring activity: - Cases reviewed The organization should measure improvement. Examples: - Governance gaps identified - Policies updated - SOPs updated - AI prompts updated - Skills updated - Automations improved - Governance deployed - Retests passed The focus becomes: Did the operating system improve? instead of Did we complete work? ### 4. KIP Skill Architecture This became the dominant topic. Multiple failures exposed weaknesses in KIP's Skill Registry. Observed failures included: - Skills not surviving new threads. - Skills remembering procedures but forgetting resources. - Skills requiring users to repeat information. - Skills explaining workflows instead of executing them. - Skills claiming success before verification. - Skills depending on thread memory. This resulted in a much broader philosophy: Operational Skills must be executable business capabilities—not prompt snippets. ## Major Decisions ### Operational Skills require governance. They cannot simply contain: - instructions - prompts - steps They must contain: - ownership - triggers - systems - resources - permissions - execution - verification - monitoring - maintenance ### Skill persistence must include resources. One of the biggest discoveries: The CRO Ledger skill remembered: HOW but forgot: WHERE The saved skill lacked: - spreadsheet ID - sheet URL - tab - gid - schema - execution resource This was identified as a fundamental architectural weakness. ### Skills require Fresh Thread Certification. A skill is NOT complete because it worked during training. A skill is complete only after: - save - reload - execute - verify inside a completely new Slack thread. ### Skill success requires verification. KIP must never respond: Done until: - destination system confirms - read-back succeeds - verification passes ## Current State The Bill.com → Eadin AP workflow is technically working. The human-approved write loop has been successfully demonstrated end-to-end: - proposal - approval - write - duplicate prevention - verification However, the surrounding Skill architecture is still evolving. The major remaining work is making Operational Skills: - persistent - portable - verifiable - maintainable - self-improving # 2. Company Context ## Business Kings Loot High-growth DTC ecommerce company. Scaling: ~$20–25M toward $100M+ ## Strategic Goal Build organizations that improve themselves. The company is shifting away from: People solving problems toward Operating Systems solving problems. ## KIP Vision KIP is evolving into: An Enterprise Execution Platform. Not merely: - Chatbot - Memory system - AI assistant Instead: An execution engine capable of: - monitoring - recommending - obtaining approval - executing - verifying - learning ## Operating Principle Every recurring process should eventually become: Governance ↓ Skill ↓ Automation ↓ Organizational Learning # 3. CEO / User Context Joshua consistently demonstrated several important preferences. ## Systems over tasks Joshua rarely optimizes an individual workflow. Instead he asks: "What system should exist?" ## Ownership Joshua consistently reframes work around ownership. Example: Edgar doesn't own QA. He owns: Customer Care Operating System. ## Improvement over reporting Joshua dislikes KPIs that measure activity. He wants KPIs measuring: Improvement. ## Permanent learning Joshua constantly asks: How does this become permanent organizational intelligence? ## Trust Joshua has become increasingly intolerant of AI claiming success without verification. Examples discussed: - CRO Ledger - Payment Skills - Runtime routing The consistent requirement: Never claim. Always verify. ## Communication Style Joshua prefers: - Direct - Executive - System-oriented - Non-generic - Architecture thinking - Root causes - Long-term scalability # 4. Key People / Roles ## Joshua Stephens CEO Responsibilities: - Enterprise architecture - Governance - Systems - KIP vision - Scaling Kings Loot Strengths - Systems thinking - Architecture - Pattern recognition - Long-term planning Primary focus Building organizations that continuously improve. ## Edgar Acosta Customer Care Responsibility changed. Old: Customer Care QA New: Continuous Improvement of the Customer Care Operating System. Future KPI: Governance Improvements Created. ## Audrey Head of Retention / Governance audit contributor. Her audit triggered the realization that: QA should evolve into Organizational Learning. ## Maci Stankewitz Finance / Accounts Payable Owner of: Bill.com payment process. Primary responsibility: Teach KIP the AP workflow. She documented the current payment-entry process, including Bill.com status checks, PO identification from the memo, required payment fields, screenshot naming, and manual upload into Eadin. ## Devin Technical Owner Responsible for: - Runtime - MCP - Skills - Write loops - Deployment Major work completed: - Human-approved Eadin write loop - Bill.com monitoring - Runtime improvements Still responsible for: Operational Skill architecture. # 5. Systems / Operating Models Discussed ## Customer Care Operating System Purpose Continuous improvement. Operating Flywheel Observe ↓ Audit ↓ Learn ↓ Improve Governance ↓ Deploy ↓ Retest ↓ Capture Organizational Learning ↓ Teach KIP ↓ Repeat Owner Edgar. ## KIP Operational Skills Purpose Reusable enterprise capabilities. Every Operational Skill should include: - Owner - Purpose - Trigger - Source systems - Destination systems - Required inputs - Business rules - Approval - Execution - Verification - Monitoring - Failure handling - Metrics - Version history ## Bill.com Payment Skill Purpose Automatically detect qualifying Bill.com PO payments, obtain approval, record them in Eadin, and verify completion. Workflow Daily monitoring ↓ Detect payment ↓ Gather data ↓ Approval proposal ↓ Human approval ↓ Write ↓ Verify ↓ Confirmation ## Skill Registry Current State Exists. Weaknesses identified: - saves procedures - forgets resources - no verification - no runtime certification Future direction: Executable enterprise capabilities. # 6. Decisions Made ## Decision Customer Care becomes Continuous Improvement. Why Optimize operating system. Owner Edgar. ## Decision Use Governance Improvements Created as KPI. Why Measure improvement instead of activity. Owner Edgar. ## Decision Operational Skills require governance. Why Prevent fragile prompt-based automation. Owner Joshua / Devin. ## Decision Operational Skills must include resource bindings. Why Prevent skills forgetting spreadsheets, destinations, APIs, etc. ## Decision Every skill requires verification. Why Prevent false success reporting. ## Decision Fresh Thread Certification becomes required. Why Thread memory is not sufficient. ## Decision Bill.com monitoring becomes daily. Original: Friday. Updated: Daily 7:00 AM PT. Reason: Payments occur throughout the week, not only on Fridays. Devin updated the design accordingly. ## Decision Only qualifying PO payments should be processed. Why Avoid non-PO vendor payments. Documented in Maci's operating process. # 7. Open Issues / Unresolved Questions ## Skill Registry Needs: - resource persistence - read-back verification - runtime loading - version validation ## Attachment automation Currently manual. Future: Automatically attach Bill.com proof into Eadin after payment entry. ## Skill execution Need runtime tests ensuring: - no explanations - no repeated questions - immediate execution ## Operational Skill Framework Needs implementation beyond documentation. ## Organizational Learning Need enterprise-wide framework beyond Customer Care. # 8. KPIs / Metrics / Targets Mentioned Customer Care Replace: Cases Reviewed With: - Governance Improvements Created - Policies Updated - SOPs Updated - AI Prompts Updated - Skills Updated - Governance Changes - Retests Passed Operational Skills Suggested metrics: Reliability - Successful writes - Failed writes - Duplicate prevention - Verification failures Usability - Restatement requests - Incorrect routing - Explanation instead of execution Governance - Identity failures - Permission failures - Manual exceptions Improvement - Skill versions - Regression tests - Organizational learnings Bill.com monitoring Daily 7:00 AM PT 30-day review window. # 9. Documents / Agreements / Drafts Created Created during this thread: ### Edgar Slack Message Reframing Customer Care ownership. ### Customer Care Continuous Improvement Flywheel Observe ↓ Audit ↓ Learn ↓ Improve Governance ↓ Deploy ↓ Retest ↓ Capture Organizational Learning ↓ Teach KIP ↓ Repeat ### Operational Skill Governance Framework Enterprise framework for all future skills. Included: - ownership - triggers - execution - verification - metrics - governance - maintenance ### Bill.com Payment to Eadin AP Governance Comprehensive governance covering: - payment detection - approval - execution - verification - duplicate prevention - identity - attachment handling - monitoring - failure handling - metrics - Definition of Done # 10. Communication Style / Instructions for Future Assistant Future conversations should: - Think like an operating partner. - Focus on systems rather than tasks. - Push toward ownership. - Push toward governance. - Push toward permanent organizational learning. - Challenge designs that depend on human memory. - Treat execution and verification as separate concerns. - Distinguish clearly between: - knowledge - recommendations - execution - Never accept "it worked once" as proof that a system is complete. - Look for missing resource bindings, ownership, governance, and failure handling in every proposed automation. Avoid: - Generic AI advice. - Superficial productivity suggestions. - Measuring activity instead of improvement. - Assuming successful execution without verification. # 11. Next Best Actions ### Highest Priority 1. Implement persistent Operational Skill architecture: - Resource bindings - Runtime loading - Read-back verification - Versioning - Fresh-thread certification 2. Build automated attachment handling for Bill.com payment proofs. 3. Implement enterprise-wide Continuous Improvement flywheels for departments beyond Customer Care. 4. Create a universal Operational Skill template so every future KIP capability follows the same governance. 5. Add regression tests for every Operational Skill: - New-thread routing - Approval flow - Write verification - Duplicate prevention - Failure handling 6. Extend KIP's Skill Registry from a prompt repository into a true enterprise capability registry, where each skill stores not only instructions but also ownership, resources, execution contracts, monitoring rules, verification requirements, and lifecycle history. This was the central architectural direction established throughout the thread.import: KIP vault memory via kip_vault_search row 75012eea-3c87-4a5f-846e-b09ca6754680 (Joshua Stephens)
medium · confidence 1.00
65projects
Sep 2, 1:55 AMEnterprise Knowledge Artifact — KIP: # Enterprise Knowledge Artifact — KIP ## 1. Executive Overview ### What KIP is KIP — the Kinetic Intelligence Platform — emerged from Kings Loot's effort to solve a problem larger than reporting, analytics, or AI assistance: How can an organization learn faster than it grows, preserve what it learns, improve future decisions from prior experience, and reduce its dependence on individual human memory—especially the CEO's? Kings Loot was operating at approximately the $25M revenue stage while aspiring to scale toward $100M+. The organizational constraint increasingly visible beneath individual operational problems was CEO dependency. Too much organizational intelligence—judgment, exceptions, context, relationships between systems, operating principles, and decision history—existed in Joshua's head or in fragmented conversations. KIP was conceived as the long-term answer to that problem. It is not intended to replace Eadin, Kings Loot's operational platform. It is not intended to become another BI dashboard or a chatbot sitting beside the business. The architecture ultimately established a much sharper distinction: Eadin owns operational truth and execution. KIP owns organizational intelligence. Eadin is the operational/business system and source of truth. KIP is the intelligence, memory, evidence, reasoning, decision, participation, and organizational-learning layer above operational systems. ### The central product insight Several product principles became foundational: Users shouldn't bring work to KIP. KIP should bring itself into work. and: Partnership isn't addition. Partnership is multiplication and massive leverage. KIP therefore evolved from something that could have become a conventional AI application into an Executive AI Partner / Enterprise Intelligence Engine that participates wherever work already occurs: - Slack - SMS/text - meetings - email - AI conversations - Eadin - future applications and interfaces The desired behavior is fundamentally different from an assistant. An assistant waits for work. A partner participates, remembers, follows through, connects evidence, improves judgment, and helps close loops. ### Architecture established KIP was deliberately separated from Eadin: - separate repository - separate application - separate database - separate deployment - separate lifecycle - separate release cadence - separate engineering ownership The systems communicate through: - APIs - events - connectors Direct database coupling was explicitly rejected. The approved technical direction included Fastify, TypeScript, PostgreSQL, pgvector, Google OIDC, row-level security, GitHub, and Devin-assisted engineering. Supabase was initially selected for managed PostgreSQL/infrastructure; deployment thinking subsequently evolved toward DigitalOcean App Platform and DigitalOcean Managed PostgreSQL while preserving KIP's architectural independence. ### Architecture became implementation The project then crossed an important boundary. Architecture stopped being the primary deliverable. The Founder Demo became the north star. Instead of proving KIP by building many capabilities independently, the goal became proving one complete intelligence loop: Text KIP → Context Assembly → Evidence → Organizational Memory → Reasoning → Recommendation → Human Decision → Outcome → Learning → Improved Recommendation The crucial test was not whether individual services worked. It was whether KIP could demonstrate that an organization became measurably more intelligent after an experience. ### Organizational Memory KIP's Organizational Memory became one of its most important abstractions. KIP should not merely preserve chat history. It should preserve governed organizational knowledge such as: - facts - lessons - policies - preferences - operating principles - playbooks - constraints - patterns - standards - hypotheses - Organizational DNA Importantly, the philosophy became: KIP itself does not "learn" in the anthropomorphic sense. The organization learns. KIP is the steward of that learning. Therefore preferred language became: "This recommendation incorporates what the organization learned." rather than: "I've learned..." Governance also became essential: information should not become permanent Organizational Memory merely because an AI inferred it. ### Governance before automation A consistent architecture principle developed: Human approval before execution. This later extended beyond KIP into the universal Eadin Write Access architecture. LLMs, KIP, ChatGPT, Claude, Gemini, Devin, Slack assistants, internal agents, and future applications are treated as untrusted request originators when attempting operational writes. Trusted enforcement belongs inside Eadin. The resulting direction was a universal write pipeline covering: authentication → authorization → capability/action registry → typed scope resolution → deterministic source/target reads → validation/diff → immutable proposal → policy/risk approval → durable job → bounded execution → reconciliation → verification → audit/events → final status. This was a significant maturation of the KIP/Eadin boundary. KIP can reason and propose. Eadin controls operational mutation. ### Important correction concerning Skills By August 2026, implementation work exposed an important semantic boundary concerning taught skills. A proposed KIP fix described taught skills as entering Organizational Memory and being "committed" to the repository. That model was identified as incorrect. The supported model was: - taught skills belong in the database Skill Registry - relevant structures include skills / skill_versions - new skills begin as Draft - they do not become memory_entries - they are not "committed" to the code repository simply because KIP learned/taught them This distinction matters because KIP increasingly contains several different forms of durable organizational intelligence. Treating all persistence as Organizational Memory would collapse important governance boundaries. ### State at the end of available history KIP had progressed from philosophy → architecture → engineering foundation → implementation → operational boundary design. The architectural direction was substantially established. The largest remaining challenge was no longer imagining KIP. It was proving that: 1. its data is trustworthy, 2. its intelligence loops actually improve organizational decisions, 3. participation feels useful rather than intrusive, 4. organizational knowledge is classified correctly, 5. recommendations remain grounded in evidence, 6. operational execution remains governed, 7. every important decision and output can be reconciled and explained. The Amazon ingestion/reconciliation work became an especially important example of this final point: sophisticated intelligence is worthless if the underlying operational evidence cannot be traced from source through ingestion and canonicalization to the reported result. # 2. Context ## Company Context Kings Loot is a premium direct-to-consumer ecommerce business. During KIP's formation, the company was approximately a $25M business with ambitions to scale toward $100M+. Kings Loot already had substantial operational complexity: - Shopify - Amazon - multiple warehouses - ShipHero - suppliers - purchase orders - inbound shipments - merchandising - forecasting - inventory - customer care - marketing - financial reporting - promotional planning Eadin was already evolving as Kings Loot's custom operational ERP. ### Primary organizational constraint Across broader Kings Loot operating work, a recurring conclusion emerged: The company was constrained not simply by missing software or processes, but by organizational intelligence being concentrated in the CEO. Joshua remained involved in: - strategic direction - capital allocation - sourcing/vendor negotiation - product creation - organizational design - system architecture But operating knowledge frequently flowed back through him. The long-term CEO operating model explicitly sought to move Joshua away from day-to-day execution and toward: - strategic direction - capital allocation - leadership recruiting/development - organizational design - strategic growth initiatives KIP therefore had both a technology objective and an organizational objective: Convert organizational intelligence from human dependency into durable institutional capability. ## Project Context ### Problem being solved Traditional business software stores transactions. BI software reports what happened. Chatbots answer questions. Documentation systems preserve what humans manually enter. None adequately solve: How does an organization remember why decisions were made, learn from outcomes, apply those lessons later, and proactively participate in future decisions? KIP was designed around that gap. ### Success looked like KIP succeeds when organizational intelligence compounds. A future decision should benefit from: - prior decisions - outcomes - evidence - lessons - policies - organizational principles - relevant operational context without requiring the same humans to remember everything. ## Operating Context Kings Loot's broader operational evolution strongly influenced KIP. Repeated operating-system work established principles such as: - systems reduce dependency on memory - policies should be centralized - authority must be explicit - exceptions should be documented - root-cause analysis matters more than symptom management - confusion during pilots reveals tribal knowledge - AI should support decisions before automating them The Customer Care OS became an important example. Its structure included: - Constitution - Authority Matrix - Escalation Matrix - Issue Classification - Policy Registry - governance documents - Resolution Catalog - Exception Catalog - Routing Trees The lesson was transferable to KIP: Intelligence without governance eventually becomes inconsistency. ## Strategic Context KIP was expected initially to serve Kings Loot. Longer term, commercializing KIP as a standalone enterprise platform remained possible. This required architecture capable of surviving beyond Kings Loot-specific workflows. Consequently: - multi-tenancy mattered - tenant isolation mattered - model independence mattered - vendor independence mattered - connector abstraction mattered - evidence/provenance mattered - organizational knowledge could not be hard-coded around Kings Loot ## Important Definitions and Language ### Eadin Kings Loot's operational/business platform. It owns operational truth, business rules, and controlled execution. ### KIP Kinetic Intelligence Platform. The Enterprise Intelligence Engine above operational systems. ### Organizational Memory Governed durable organizational knowledge. It is not synonymous with chat history, database persistence, or every object KIP stores. ### Organizational DNA The durable principles, preferences, constraints, standards, and organizational characteristics that should influence reasoning. ### Evidence Grounded information supporting a recommendation or conclusion. Evidence should remain distinguishable from reasoning. ### Intelligence Object A conceptual root abstraction for durable intelligence-related entities within KIP. ### Decision Loop A closed-loop system connecting context, reasoning, human decision, outcome, and subsequent learning. ### Participation KIP entering existing work contexts rather than requiring users to open KIP. ### Follow Through KIP helping ensure decisions and commitments reach completion rather than disappearing after discussion. ### Skill Registry Durable registry for executable/taught skills, distinct from Organizational Memory. ### Proposal A governed request for an operational mutation. In the Eadin Write Access model, proposals precede execution. ## Constraints and Guardrails ### Do not destabilize Eadin KIP could not become an architectural parasite on the production operational system. Result: No shared database and no direct DB coupling. ### Evidence before opinion KIP should not become a confident LLM producing unsupported executive advice. ### Human approval before execution Reasoning and operational mutation are separate trust domains. ### Governance before automation Automation without policy, authority, provenance, and audit creates hidden organizational risk. ### Never surveillance KIP should participate in work without becoming an employee-monitoring platform. ### Architecture before features Early development intentionally accepted slower visible progress to protect long-term architecture. ### But architecture must eventually stop being the product As the architecture matured, the project recognized the opposite risk: over-design. Behavioral validation therefore became the next teacher. # 3. Executive Timeline ## Phase I — KIP emerges as an organizational intelligence concept ### What happened Kings Loot recognized that its operating bottleneck was increasingly organizational rather than purely transactional. ### What was believed Better systems could reduce dependency on individuals and preserve institutional knowledge. ### What changed KIP began taking shape not as another ERP module but as an organizational intelligence layer. ## Phase II — KIP and Eadin boundaries are debated and resolved ### Question Should KIP live inside Eadin? ### Reasoning Integration would be easier if tightly coupled, but this would combine fundamentally different responsibilities: - operational systems - intelligence systems ### Decision KIP became a separate platform. ### Resulting architecture Separate: - repo - application - database - deployment - lifecycle - ownership Connected through APIs/events/connectors. ### Lesson Integration does not require architectural ownership. ## Phase III — Product identity changes from AI tool to AI Partner ### Initial risk KIP could easily become a chatbot or dashboard. ### New thinking That would still require humans to remember to consult the software. ### Revised model KIP participates where work occurs. ### Principle established Users shouldn't bring work to KIP. KIP should bring itself into work. This materially changed connector, UX, runtime, and participation architecture. ## Phase IV — Organizational Memory becomes foundational The project concluded that intelligence cannot compound without durable memory. But memory had to be more than vector retrieval. It required: - provenance - governance - classification - organizational meaning The longer-term taxonomy expanded beyond simple lessons/facts toward: - policies - playbooks - standards - constraints - patterns - hypotheses - Organizational DNA ## Phase V — Engineering foundation The project established: - GitHub repository - Kings-Loot organizational ownership - database infrastructure - migration strategy - security model - Fastify/TypeScript foundation - PostgreSQL/pgvector direction - multi-tenant architecture Devin became the principal AI engineering partner. Taras remained responsible for Eadin and was identified as the future integration expert. ## Phase VI — Architecture gives way to the Founder Demo ### Turning point The architecture became mature enough that additional abstraction had declining value. ### New priority Prove one magical closed loop. ### Founder Demo The canonical scenario became a business decision such as: "Should we order another container of wallets?" The experience should begin through text rather than requiring the user to open an application. Flow: Text → context → evidence → memory → recommendation → human decision → outcome → learning → improved next recommendation ### Why this mattered The demo tested KIP's actual thesis rather than merely its infrastructure. ## Phase VII — "Observe" is deferred Earlier lifecycle language risked making autonomous observation appear necessary to the first demo. The model was refined. Founder Demo: Capture → Understand → Reason → Participate → Learn Future autonomous runtime: Observe Slack/email/meetings/Eadin/connectors. This avoided forcing a future capability into the first validated loop. ## Phase VIII — AI learning language is corrected The project refined language from AI-centric to organization-centric. Not: "KIP learned X." Instead: "The organization learned X." This was not cosmetic. It reflected the ownership model: Organizational intelligence belongs to the organization, not the model. ## Phase IX — Connector strategy matures Composio was evaluated. The project avoided allowing a vendor to become KIP's integration architecture. Decision: KIP owns the Connector Architecture. Composio may be an adapter. Composio could provide OAuth and outbound actions. KIP retains ownership of: - ingestion - memory - evidence - provenance - organizational knowledge This preserved vendor independence. ## Phase X — Deployment thinking evolves Supabase was initially selected and became part of the foundation. Later implementation planning approved: - DigitalOcean App Platform - DigitalOcean Managed PostgreSQL - pgvector - Fastify - Next.js The deployment model could resemble Eadin operationally while remaining completely separate architecturally. This is an example where historical infrastructure references must not be collapsed into one timeless state. ## Phase XI — Universal write governance emerges As KIP became capable of recommending and potentially triggering operational actions, a deeper problem surfaced: Who actually gets to mutate Eadin? The architecture matured into a universal Eadin Write Access Platform. Models and apps are untrusted request originators. Eadin owns deterministic enforcement. One universal write pipeline should support: - all SKUs - category - subcategory - product - individual SKU - selector-based sets without separate security paths. This represented a significant maturation from "human approval" as a product concept to human/policy approval enforced architecturally. ## Phase XII — Amazon ingestion exposes the importance of reconciliation Amazon reporting work surfaced a concrete example of why evidence architecture matters. PR #423 rewrote ingestion to: - preserve Deferred rows - prevent synthetic rows from counting as Orders - replace wipe-and-replace with keyed upserts - introduce canonical record selection - introduce reconciliation exceptions - add Bearer authentication - test migration behavior But the reporting system was not yet considered trustworthy. The unresolved discrepancy: - Amazon Unified Aug 11 source: 64 rows - Eadin/API-side export: 85 apparent rows - unexplained difference: 21 The acceptance criterion became stronger than "code passes": Every reported Order must be traceable from Amazon source → raw ingestion → canonical record → final report, and every reconciliation exception must be explainable. This is a concrete embodiment of KIP's evidence-first philosophy. ## Phase XIII — Skills vs Organizational Memory boundary corrected A proposed implementation/fix represented taught skills as Organizational Memory and implied repository commitment. That conceptual model was challenged. Correct model: Skill Registry ≠ Organizational Memory. Taught skills live in database-backed skills / skill_versions, initially as Draft. This revealed an emerging architectural challenge: As KIP accumulates more forms of durable intelligence, classification boundaries matter as much as persistence itself. # 4. Decision Intelligence Ledger ## Decision 1 — Build KIP as a separate platform from Eadin Owner: Joshua. Trigger: Need for an intelligence platform without destabilizing Eadin. Why: Different responsibilities and long-term lifecycles. Rejected direction: Tight embedding/shared database. Assumption: APIs/events/connectors can provide adequate integration. Action: Separate repo, DB, deployment, lifecycle. Status: Validated architectural direction; integration remains ongoing. Future relevance: Preserve separation unless the fundamental responsibility boundary changes. ## Decision 2 — KIP is an Enterprise Intelligence Engine, not a chatbot/dashboard Trigger: Conventional AI UX would fail the organizational-learning objective. Why: A chatbot answers prompts but does not inherently preserve institutional learning or close organizational loops. Success: KIP improves future judgment from prior organizational experience. Status: Foundational. ## Decision 3 — KIP should participate where work occurs Why: Software adoption fails when humans must remember to use another system. Action: Design participation around Slack, text, meetings, email, Eadin and future channels. Risk: Participation can feel intrusive. Status: Architecture approved; behavioral validation remains necessary. ## Decision 4 — Explicitly reject surveillance Why: A partner requires trust. Assumption: Employees will accept useful contextual participation more readily than perceived monitoring. Risk: Even well-intentioned observation can create surveillance perception. Status: Permanent product guardrail. ## Decision 5 — Organizational Memory is permanent and governed Why: Organizational intelligence cannot compound if prior learning disappears. Action: Build memory as durable infrastructure. Risk: Bad or unvalidated inference could become institutionalized. Mitigation: Human governance; lessons require approval. Status: Core architecture. ## Decision 6 — Evidence and provenance precede sophisticated reasoning Why: Executive recommendations without traceability are unsafe and difficult to trust. Status: Foundational and increasingly validated by operational reconciliation problems. ## Decision 7 — Founder Demo becomes the next north star Trigger: Architecture was sufficiently mature. Why: Continuing to design abstractions risked delaying behavioral truth. Action: Optimize around one end-to-end wallet purchasing decision. Status: Implementation/validation phase in the available history. ## Decision 8 — Founder Demo starts through text Alternative: Opening KIP web application. Why rejected: Violates "conversation follows the user." Status: Approved. ## Decision 9 — Reserve Observe for autonomous runtime Why: Avoid forcing autonomous observation into the initial loop. Result: First demo uses Capture → Understand → Reason → Participate → Learn. Status: Approved. ## Decision 10 — Organizational learning, not AI learning Decision: Avoid anthropomorphic "I learned" language. Why: Knowledge belongs to the organization. Future relevance: Should influence UX, memory ownership, audit, and governance—not merely copywriting. ## Decision 11 — Composio is an adapter, not the connector architecture Why: Prevent vendor lock-in and preserve KIP's ownership of organizational intelligence. Status: Approved. Reconsideration: Individual adapters may change; KIP's ownership boundary should remain unless platform strategy fundamentally changes. ## Decision 12 — Human approval before execution Why: Reasoning does not imply authorization. Risk addressed: AI performing operational actions beyond authority. Status: Foundational; later strengthened through Eadin Write Access architecture. ## Decision 13 — Treat AI/app callers as untrusted write originators Trigger: Need for universal safe operational mutation. Decision: Security cannot depend on prompts or model identity. Action: Enforcement moved conceptually into Eadin. Status: Architecture designed. Future relevance: Applies to KIP, ChatGPT, Claude, Gemini, Devin, Slack assistants and future applications. ## Decision 14 — Use one universal Eadin write pipeline Why: Separate code paths for "all SKUs," category, product, etc. create inconsistent governance and security. Assumption: Scope can be represented through typed resolution. Status: Architectural direction. ## Decision 15 — Amazon reporting requires transaction-level reconciliation Trigger: Apparent order discrepancy. Why: Aggregate totals can appear correct while underlying records are wrong. Decision: Do not consider reporting trustworthy until every reported Order is traceable. Status: Still being validated. ## Decision 16 — Preserve Deferred Amazon rows and prevent synthetic rows from counting as Orders Action: Implemented in PR #423. Why: Prior ingestion semantics could distort order reporting. Status: Implemented, but overall reporting trust remains gated on reconciliation. ## Decision 17 — Taught Skills belong in Skill Registry, not Organizational Memory Trigger: Proposed fix used incorrect persistence semantics. Decision: skills / skill_versions; Draft state. Rejected model: memory_entries and repo "commit" semantics. Status: Latest supported architectural interpretation. Lesson: Durable KIP objects require explicit ontological boundaries. # 5. Lessons Learned ## Validated Principles ### Architecture boundaries create future leverage Separating KIP and Eadin introduced integration work but prevented intelligence concerns from contaminating the operational system. ### Organizational intelligence must have provenance The Amazon reconciliation issue demonstrated why downstream confidence cannot exceed upstream traceability. ### Governance is part of intelligence Memory, skills, decisions and actions cannot simply be stored or executed because an AI produced them. ### Closed loops matter more than isolated AI quality The meaningful unit of KIP is not a prompt response. It is: decision → action/outcome → learning → improved future decision. ## Failed or Incomplete Assumptions ### "If architecture is correct, the product is progressing" This became incomplete. Architecture was necessary, but eventually behavior had to become the teacher. Replacement: Build the smallest complete intelligence loop and validate the experience. ### "Persistent knowledge can broadly be treated as memory" Later distinctions showed this was too coarse. Skills, evidence, memory, policies, DNA, decisions and execution proposals have different semantics and governance. Replacement: Persistence does not determine ontology. ### "Successful ingestion means trustworthy reporting" Amazon work challenged this. Replacement: Trust requires reconciliation across the entire lineage. ## Organizational Lessons ### CEO dependency is an intelligence architecture problem Delegation alone cannot solve dependency if context and judgment remain concentrated in the CEO. ### Pilot confusion is useful When experienced operators disagree with a system, the discrepancy may reveal hidden policy or tribal knowledge rather than user failure. ### Decision rights must be explicit AI increases the importance of authority boundaries because execution can scale faster than human supervision. ## AI / Technology Lessons ### Models should be replaceable KIP owns organizational intelligence; LLM providers are reasoning components. ### Vendor adapters should not own architecture Composio illustrates the principle. ### Prompts are not security Authorization belongs in deterministic enforcement systems. ### Explainability requires architecture You cannot bolt provenance onto an opaque pipeline after the fact and expect enterprise-grade trust. # 6. Key People & Ownership ## Joshua Stephens — Founder / CEO ### Historical ownership - KIP vision - product philosophy - architecture - platform strategy - final approvals ### Relevant strengths documented - systems thinking - product intuition - organizational design - long-horizon architecture - first-principles reasoning ### Relevant risk Architecture can become an attractive form of continued work after sufficient foundations exist. The project itself recognized the need to shift toward behavioral validation. ### Organizational implication KIP must ultimately reduce—not create another form of—CEO dependency. ## Devin — AI Engineering Partner ### Ownership - repository - scaffold - implementation - infrastructure - Founder Demo - architectural implementation ### Strengths observed - architectural reasoning - service boundaries - abstractions - engineering discipline - willingness to identify risks ### Risks Devin surfaced - behavioral adoption - closing feedback loops - entity resolution - attention ranking - grounded confidence - surveillance perception ### Latest relevant issue Implementation semantics still require architectural review, illustrated by the Skill Registry vs Organizational Memory correction. ## Taras — Lead Eadin Developer ### Ownership - Eadin - production Eadin knowledge - future API/integration boundary ### Importance Because Eadin remains operational source of truth, KIP/Eadin integration requires Taras's system knowledge. For Amazon reconciliation, production schema information was also required so migration behavior could be tested against reality. ## Bruce — Technical Advisor Recommended Supabase during foundation work. That recommendation materially influenced early infrastructure direction. # 7. Systems & Operating Models ## KIP Purpose: Enterprise Intelligence Engine. Owns: - organizational memory - evidence/provenance - reasoning orchestration - organizational context - decision intelligence - participation - learning loops - Organizational DNA Does not own: core operational truth. ## Eadin Purpose: operational/business platform. Owns: - operational entities - business rules - inventory/operations - controlled mutations - operational source of truth Relationship to KIP: API/event/connector based. ## Organizational Memory ### Purpose Preserve durable organizational knowledge. ### Inputs Potentially: - approved lessons - facts - policies - preferences - standards - constraints - patterns - Organizational DNA ### Guardrail Not every generated artifact belongs in Organizational Memory. ## Skill Registry ### Purpose Store and govern taught/executable skills. ### Known model - skills - skill_versions - Draft creation state ### Boundary A Skill is not merely a memory entry. ## Evidence Layer ### Purpose Provide immutable/traceable support for reasoning. ### Rule Evidence does not perform reasoning. Reasoning consumes evidence. ## Reasoning Layer ### Purpose - context assembly - recommendation generation - explainability ### Evolution Initially ReasoningService carried orchestration responsibility. Longer term the Runtime should orchestrate the intelligence lifecycle. ## KIP Runtime Long-term lifecycle: Capture / Observe → Understand → Reason → Participate → Learn The precise runtime stages evolved as autonomous observation was separated from the Founder Demo. ## Decision Workspace ### Purpose Provide the visible interface for evidence-backed decisions. Expected to expose: - evidence - relevant memory - recommendation - decision - outcome - subsequent learning ## Participation Architecture ### Purpose Bring KIP to work rather than work to KIP. Channels include: - Slack - SMS - email - meetings - AI sessions - Eadin - future channels ## Follow Through System ### Purpose Prevent organizational commitments from dying inside conversations. KIP should recognize commitments, relevant subsequent events, approvals and closure. ## Connector Architecture KIP owns connector semantics. External vendors may implement adapters. Native ingestion, organizational meaning, provenance and knowledge remain under KIP control. ## Eadin Write Access Platform ### Purpose Allow KIP and other AI/application clients to safely request operational changes. ### Trust model Caller = untrusted. Eadin enforcement layer = trusted. ### Pipeline 1. authenticate 2. authorize 3. identify capability/action 4. resolve typed scope 5. read deterministic source/target state 6. validate 7. calculate diff 8. create immutable proposal 9. evaluate policy/risk 10. obtain required approval 11. create durable execution job 12. execute bounded mutation 13. reconcile 14. verify 15. emit audit/events 16. produce final status This architecture prevents AI prompts from becoming de facto authorization systems. ## Amazon Ingestion / Reconciliation ### Latest material architecture PR #423 introduced: - Deferred-row preservation - synthetic/order separation - keyed upserts - canonical record selection - reconciliation exceptions - Bearer auth - migration testing ### Remaining requirement Transaction-level lineage to the final report. # 8. KPIs / Metrics / Targets / Definitions / Guardrails KIP's early history was architecture-heavy and therefore contained relatively few conventional business KPIs. Important engineering/architecture guardrails included: - separate KIP repository - separate database - separate deployment - tenant isolation - RLS enforcement - kip_app non-superuser production role - cross-tenant writes blocked - pgvector support - evidence-first reasoning - API-first integration - human approval before execution DigitalOcean infrastructure planning referenced a Managed PostgreSQL db-s-1vcpu-1gb configuration at approximately $15/month during that historical stage. Health endpoint: /health A historical deployment reference was: kip-r57ru.ondigitalocean.app These infrastructure details should not be assumed current without verification. ### Amazon reconciliation metric The relevant standard was not merely an aggregate KPI. It was a correctness invariant: Every reported Order must be traceable to its source record and canonical representation, and reconciliation exceptions must be explainable. Known unresolved Aug 11 figures: - Amazon Unified source: 64 rows - Eadin/API-side apparent export: 85 rows - unexplained difference: 21 These figures represent an unresolved reconciliation state, not a corrected final truth. # 9. Important Documents & Frameworks Material KIP artifacts created, approved or discussed include: ### Foundational architecture - KIP Constitution - Organizational DNA Framework - Enterprise Knowledge Model - Enterprise Architecture - Capability Architecture - Sensory Architecture - Semantic & Event Architecture - Engineering Architecture These collectively defined KIP's product, intelligence and engineering philosophy. ### Product / behavior - AI Partner Philosophy - Native Interaction Philosophy - Participation Architecture - Thread Participation - Slack Participation - Follow Through Philosophy - KIP Navigation ### Runtime / intelligence - KIP Runtime & Operating Cycle - Intelligence Object architecture - Decision/Learning Loop architecture - Evidence architecture - Organizational Memory architecture - Decision Workspace - Founder Demo Roadmap ### Integration / infrastructure - Connector Architecture ADR - Connector Registry - repository strategy - Supabase strategy - DigitalOcean deployment specification - production readiness guidance - Eadin integration concepts - Eadin Write Access architecture ### Engineering governance Numerous architectural review messages to Devin functioned as implementation governance. An important operating pattern emerged: significant implementation phases should receive architecture review before proceeding. # 10. Open Issues & Unresolved Questions ## Founder Demo behavioral validation It is not established from the available history that the complete Founder Demo successfully proved the organizational-learning loop in sustained real-world usage. Needed evidence: repeated real decisions showing better subsequent recommendations. ## Participation vs surveillance The philosophy is clear. The behavioral boundary is not fully validated. Questions remain: - When should KIP interrupt? - How often? - What constitutes sufficient relevance? - How should attention ranking work? - What context may KIP observe? - What controls do employees need? ## Entity resolution KIP must reliably know when different references concern the same: - person - product - SKU - supplier - project - decision - event - business concept This remains foundational to reliable organizational intelligence. ## Attention ranking Participation requires KIP to decide what deserves attention. Poor ranking could make KIP noisy and destroy adoption. ## Memory taxonomy The boundary between: - fact - lesson - policy - preference - standard - pattern - hypothesis - Organizational DNA - Skill requires continuing governance. The Skill Registry correction demonstrates that this remains an active architectural concern. ## Knowledge Graph / semantic retrieval Founder Demo retrieval could rely on tags/keywords. Long-term retrieval was expected to become more semantic and potentially graph-based. This remained future work in the available architecture history. ## Runtime orchestration ReasoningService initially performed orchestration. Longer-term responsibility should move into KIP Runtime. Implementation status at the end of the available history is not conclusively established. ## Eadin integration contract The conceptual boundary is clear. The full operational API/event contract remains an implementation program rather than a finished historical fact. ## Universal Write Access implementation The architecture is well defined. The available history does not establish that every Eadin mutation has migrated onto the universal pipeline. ## Amazon reconciliation This is a current critical unresolved issue in the latest available project context. The unexplained 21-row difference prevents the Amazon reporting pipeline from being considered trustworthy. Needed: - correct 85-row Eadin/API export - source-to-report transaction tracing - explanation of reconciliation exceptions - production-schema migration validation ## Production schema validation Taras was expected to provide: - schema-only production mysqldump - SequelizeMeta so Devin could validate migration behavior against actual production schema. The available history does not establish completion. ## Skills architecture implementation The conceptual correction is clear: Skill Registry, not Organizational Memory. But live rows could not be confirmed because the available KIP admin database connection reportedly failed authentication. Therefore: architecture interpretation is supported; production-state verification remains unresolved. # 11. Current State "Current" here means the latest state established by the available KIP project history, not a claim about systems outside that history. ## Strategy KIP remains a model-agnostic Enterprise Intelligence Engine intended to make organizational intelligence durable and compounding. ## Architectural model Operational truth: Eadin. Organizational intelligence: KIP. Operational mutation: governed by Eadin. Models/apps: untrusted request originators. ## Product philosophy KIP should behave as a partner rather than an assistant. It should participate where work occurs. It should remain evidence-driven and non-surveillant. ## Organizational Memory Permanent and governed. Not a generic bucket for every durable KIP object. ## Skills Taught skills belong in the database Skill Registry with versioning/Draft governance. ## Engineering priority Trustworthy closed loops matter more than additional architecture. ## Immediate reliability risk Amazon reporting remains untrusted until transaction-level reconciliation is complete. ## Broader platform risk KIP's sophistication can grow faster than its evidence quality. The architecture therefore needs continued enforcement of: evidence → reasoning → approval → execution → verification → learning. # 12. Future Decision Implications ## Situations We Have Seen Before ### "Should we put this intelligence feature inside Eadin?" Retrieve the KIP/Eadin boundary. Ask whether the capability owns operational truth or organizational intelligence. Do not collapse systems merely because integration is convenient. ### "Can KIP just perform this action?" Retrieve the Write Access architecture. Reasoning is not authorization. ### "Can we use this vendor for all integrations?" Retrieve the Composio decision. Adapters are replaceable. Architecture is not. ### "The report total looks right. Can we trust it?" Retrieve the Amazon reconciliation experience. Aggregate correctness does not prove record-level correctness. ### "KIP learned a new thing. Put it in memory." First classify the object. A skill, policy, evidence record, lesson, decision, hypothesis and DNA element are not interchangeable. ### "Let's design another architecture layer before testing." Retrieve the Founder Demo transition. Architecture eventually reaches diminishing returns. Behavior then becomes the teacher. ## Decisions Worth Reusing Reuse: - separate operational and intelligence responsibilities - API/event integration - evidence-first reasoning - governed permanent memory - human/policy approval before mutation - untrusted AI caller model - immutable proposals and audit trails - reconciliation after execution - model/provider independence - adapter independence - complete intelligence loops over isolated AI features ## Decisions That Should Not Be Repeated Blindly Do not blindly: - classify every persistent object as memory - trust aggregate reports without lineage - automate because the AI sounds confident - make prompts the authorization layer - build another dashboard because it is easier - adopt a connector vendor as platform architecture - continue abstract architecture indefinitely without behavioral validation - equate merged code with validated business truth ## Assumptions Future Leaders Should Test Before similar decisions, test: 1. Is the underlying operational data actually trustworthy? 2. Is the proposed knowledge correctly classified? 3. Does the user want KIP participating in this context? 4. Is the recommendation grounded in evidence? 5. Who has authority to approve the resulting action? 6. Can the execution be reconciled afterward? 7. Will the outcome become usable organizational learning? 8. Does this reduce or increase CEO dependency? 9. Is a vendor being mistaken for architecture? 10. Is an abstraction solving an observed problem or a hypothetical future one? ## Reconsideration Triggers Historical KIP decisions should be reconsidered if: - Eadin's fundamental role changes - organizational intelligence and operational truth genuinely converge - participation causes measurable trust/adoption problems - human approval becomes unnecessarily restrictive for demonstrably low-risk classes of actions - new evidence shows the current memory taxonomy cannot support organizational learning - a connector model creates unacceptable latency/reliability limitations - model capabilities fundamentally alter planning/reasoning architecture - organizational scale requires different governance or approval structures Reconsideration does not mean abandoning the principles automatically. It means reopening the assumptions. ## What a Future AI Should Remember The most important thing to remember about KIP is not its technology stack. It is the operating thesis: Organizations repeatedly lose intelligence because context, decisions, exceptions, lessons and judgment remain fragmented across people and systems. KIP exists to convert that ephemeral intelligence into a governed asset. That requires more than an LLM. It requires: evidence + memory + organizational context + reasoning + decision rights + execution governance + outcomes + learning. If one part is missing, the loop does not truly compound. # 13. Enduring Principles ## Principle 1 — Intelligence must compound ### Evidence KIP's architecture consistently evolved toward closed learning loops rather than one-time AI responses. ### Meaning Every important decision should have the potential to improve future decisions. ### Future Application Prefer systems that preserve decisions, outcomes and lessons. ### Boundary Not every trivial interaction deserves permanent organizational knowledge. ## Principle 2 — Systems over heroics ### Evidence Kings Loot repeatedly identified CEO dependency and tribal knowledge as scaling constraints. ### Meaning Important organizational behavior should not depend on one person remembering what to do. ### Application Codify policies, decision rights, evidence and learning. ### Boundary Human judgment remains essential for genuinely novel or high-consequence decisions. ## Principle 3 — Governance before automation ### Evidence Customer Care OS, Organizational Memory governance and Eadin Write Access architecture all converged on this principle. ### Meaning Define authority and policy before scaling execution. ### Application AI actions require deterministic enforcement. ## Principle 4 — Evidence before AI opinion ### Evidence KIP's evidence architecture and Amazon reconciliation work. ### Meaning Confidence without lineage is not enterprise intelligence. ### Application Recommendations should expose what they rely upon. ### Boundary Some strategic decisions inherently contain uncertainty; evidence supports judgment but cannot eliminate it. ## Principle 5 — Reasoning and authorization are different responsibilities ### Evidence Universal Eadin Write Access architecture. ### Meaning The system deciding what might be wise should not automatically gain permission to do it. ### Application Treat AI systems as request originators. ## Principle 6 — Organizational knowledge belongs to the organization ### Evidence Shift from "I learned" to "the organization learned." ### Meaning Models are replaceable stewards/processors of intelligence. The institutional asset survives them. ## Principle 7 — Persistence is not ontology ### Evidence Skill Registry vs Organizational Memory correction. ### Meaning Something being durable does not make it a memory. ### Application Classify first, persist second. ## Principle 8 — Integration does not require coupling ### Evidence KIP/Eadin separation and Composio adapter architecture. ### Meaning Systems can collaborate deeply while retaining independent ownership boundaries. ## Principle 9 — Users should not have to remember to use intelligence ### Evidence Participation architecture and Text-KIP Founder Demo. ### Meaning Intelligence should appear naturally in existing workflows. ### Boundary Participation must respect attention, privacy and trust. ## Principle 10 — Never confuse participation with surveillance ### Evidence Explicit rejection of employee surveillance during product architecture. ### Meaning KIP should help people perform work, not create a hidden performance-monitoring layer. ## Principle 11 — Behavioral truth eventually outranks architectural speculation ### Evidence Transition from architecture phase to Founder Demo. ### Meaning Once a sound foundation exists, real usage should determine what gets built next. ## Principle 12 — Reconciliation is part of correctness ### Evidence Amazon ingestion and PR #423. ### Meaning A pipeline is not correct merely because it executes or produces plausible totals. Correctness requires explainable lineage. ## Principle 13 — Every capability should close a learning loop The highest-level architectural test for KIP is: What does the organization know after this capability runs that it did not know before, and how will that knowledge improve what happens next? If a capability merely generates output without improving organizational intelligence, it may be useful software—but it is not fulfilling KIP's central thesis. # Final Institutional Memory Statement KIP began as an attempt to build better AI for Kings Loot. It evolved into a much more consequential architecture: a governed system for turning organizational experience into durable organizational intelligence. The progression matters. The organization first recognized CEO dependency and fragmented tribal knowledge. That produced a memory problem. The memory problem exposed a reasoning problem. Reasoning exposed an evidence problem. Evidence exposed a provenance problem. Recommendations exposed an execution-authority problem. Execution exposed a reconciliation problem. Learning exposed a classification and governance problem. Each discovery expanded the understanding of what an Enterprise Intelligence Engine actually requires. Therefore KIP should never be evaluated primarily by how impressive its model responses sound. The relevant test is whether the entire organization becomes more capable over time: Can it remember what happened? Can it explain why? Can it distinguish evidence from interpretation? Can it retrieve the right experience at the right moment? Can it make a better recommendation because of that experience? Can humans understand and govern the recommendation? Can approved actions execute safely? Can the system verify what actually happened? Can the outcome become governed institutional knowledge? Can the next decision be better because the previous one occurred? That is the KIP learning loop. That is the durable architecture. And that is the institutional knowledge future KIP development should protect.import: KIP vault memory via kip_vault_search row 1a062c44-73a5-4212-aba6-d447be813064 (Joshua Stephens)
medium · confidence 1.00
65projects
Sep 2, 1:54 AMPrefers general List-thread solutions over PO-specific fixes: The speaker prefers that fixes to KIP's List-thread behavior apply broadly to any action in List threads, not be scoped to PO drafts specifically.import: KIP vault memory via kip_vault_search row 150122fc-7039-40d0-9fb1-2b8fb0f3f49f (KIP)
medium · confidence 1.00
65preferences
Sep 2, 1:54 AMPrefers KIP to reject incomplete Clarity calls at the boundary: The speaker prefers that KIP reject incomplete calls before forwarding them to Clarity, return a clear missing-argument error, and preserve Clarity's original rejection text rather than forwarding empty queries.import: KIP vault memory via kip_vault_search row bf5fe97f-0b55-43a8-bdce-e7f954b9436c (KIP)
medium · confidence 1.00
65preferences
Sep 2, 1:54 AMPrefers avoiding retry loops that consume Data Export quota unnecessarily: The speaker prefers that KIP avoid retry loops that unnecessarily consume Data Export quota.import: KIP vault memory via kip_vault_search row 74509ef4-e741-4841-938d-65d05535036b (KIP)
medium · confidence 1.00
65preferences
Sep 2, 1:54 AMPreference for OAuth grant parity between Chat and KIP: The speaker believes that if Chat holds their OAuth grant, then KIP should also hold it.import: KIP vault memory via kip_vault_search row 06abb50b-2918-4b95-be04-5f024861800f (KIP)
medium · confidence 1.00
65preferences
Sep 2, 1:54 AMKIP Google Sheets access model: KIP impersonates the Slack user via domain-wide delegation rather than holding the user's OAuth grant directly; this prevents KIP from opening files the user cannot open themselves.import: KIP org memory via kip_get_context (KIP)
medium · confidence 1.00
65projects
Sep 2, 1:54 AMKIP create-a-new-sheet capability added: PR #1342 merged: KIP can now create a new Google Spreadsheet through the governed seam; creation is only reported after independently re-opening the file.import: KIP org memory via kip_get_context (KIP)
medium · confidence 1.00
65projects
Sep 2, 1:54 AMKIP create sheet from Slack request added: PR #1351 merged: KIP can create a Google Sheet directly from a Slack ask and no longer advises users to share files with KIP's service account.import: KIP org memory via kip_get_context (KIP)
medium · confidence 1.00
65projects
Sep 2, 1:54 AMPrefers Herms over KIP for assistance: Herms responds way faster than KIP and was able to walk the speaker through something without having access to it, providing links and support.import: KIP vault memory via kip_vault_search row a347caab-df2f-4879-9e00-bcffb1b529ff (Klick Stream)
medium · confidence 1.00
65preferences
Sep 2, 1:54 AMWants KIP to write summaries of threads: The speaker wants KIP to have the ability to write up summaries, particularly for diagnosing problems or summarizing entire threads, especially those with 300+ replies.import: KIP vault memory via kip_vault_search row 3fbdeba4-0dbe-4050-b60e-ff5af6c2f266 (Klick Stream)
medium · confidence 1.00
65preferences
Sep 2, 1:54 AMLead-time change policy: Bryan cannot adjust lead times directly in Eadin; all lead-time changes must be routed through KIP.import: KIP vault memory via kip_vault_search row 0eaf54a8-b7d4-46dd-8516-437e02ab82d7 (Klick Stream)
medium · confidence 1.00
65projects
Sep 2, 1:54 AMScheduled message details: Message to Brendan in #kl_merchandising scheduled for Monday 8:00 AM PST, tagging Brendan, reminding him to check lead times Bryan changed and that KIP will adjust them going forward.import: KIP vault memory via kip_vault_search row 406e9341-2320-4c44-9ae3-80dc197a38b8 (Klick Stream)
medium · confidence 1.00
65projects
Sep 2, 1:54 AMAP automation architecture preference: The speaker designed a two-layer pipeline for AP automation: Layer 1 lands every Bill.com payment into an Eadin landing table daily with pure capture and no business logic; Layer 2 reads that table and writes to AP only on certainty (confirmation number or unambiguous PO from memo), never guessing, using governance-approved format. Failed writes stay unresolved and retry automatically. Kip's role shifts from discovery to confirmation, checking the landing table against AP records and surfacing only hits past 24-48h as real signals. The speaker prefers this pattern because Eadin already uses it for Shopify/Amazon orders, and wants a standing AP report in Eadin's Reports section so anyone can pull pipeline state on demand without asking Kip.import: KIP vault memory via kip_vault_search row b4645617-b168-437b-ab54-6e1858e03760 (Klick Stream)
medium · confidence 1.00
65preferences
Sep 2, 1:53 AMWants to control daily brief content with KIP: The speaker wants to control the content of their daily brief with KIP rather than having it custom coded.import: KIP vault memory via kip_vault_search row e58c38e8-93fe-407c-b40e-22435aa80dd2 (Klick Stream)
medium · confidence 1.00
65preferences
Sep 2, 1:53 AMPost-memory review link: Whenever KIP commits something to Organizational Memory that the user asked for, include the memory dashboard link so the user can review what was saved.import: KIP vault memory via kip_vault_search row c99de99a-3473-4feb-8c7f-7463f57f08fb (Klick Stream)
medium · confidence 1.00
65projects
Sep 2, 1:53 AMKIP lacks video playback capability: KIP cannot watch Loom videos and can only read text sources: Google Docs, Sheets, Slack messages, Eadin data, and web pages.import: KIP org memory via kip_get_context (Klick Stream)
medium · confidence 1.00
65projects
Sep 2, 1:53 AMKIP-Organizational-Memory.md — 7. CRO & Landing Pages: Session-share is not spend-share: a cheap-click campaign can be 6-7% of spend but 40%+ of sessions, making landing-page coverage look far worse than it is. To tell a bad page from bad traffic, compare the same page's add-to-cart rate by traffic source, a 25-100x gap by channel on the identical URL means the page is fine and the traffic isn't. ---import: KIP org memory via kip_get_context (Klick Stream)
medium · confidence 1.00
65projects
Sep 2, 1:53 AMLead-time adjustment ownership: Going forward, Bryan cannot adjust lead times in Eadin; this is a KIP task.import: KIP vault memory via kip_vault_search row 8f97ab30-1f64-4d72-b0a0-a87bf5c74c61 (Kings Holding)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Daily Retention OS: Retention OS V5.1 — Governance: Daily Retention OS Workbook tab: Daily Retention OS Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Daily ledger combining planned email, actual campaigns, event context, Shopify sales, and next actions. # When to use this tab Use for daily operating review and action. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Every material anomaly gets an action or explicit no-action decision. # Outputs and handoffs Daily operating context and action list. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Email Calendar; Campaign Ledger; Marketing Calendar; Daily Shopify Metrics; Action Queue # Do not use this tab for Do not close a day with material anomalies unowned. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Daily Retention OS Workbook tab: Daily Retention OS Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Daily ledger combining planned email, actual campaigns, event context, Shopify sales, and next actions. # When to use this tab Use for daily operating review and action. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Every material anomaly gets an action or explicit no-action decision. # Outputs and handoffs Daily operating context and action list. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Email Calendar; Campaign Ledger; Marketing Calendar; Daily Shopify Metrics; Action Queue # Do not use this tab for Do not close a day with material anomalies unowned. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 7cd237c3-f620-4828-9ce9-c5053de07a3b (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Campaign Ledger: Retention OS V5.1 — Governance: Campaign Ledger Workbook tab: Campaign Ledger Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Canonical campaign performance plus context for learning. # When to use this tab Use to compare campaigns and create findings or experiments. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Meaningful campaigns need audience, event, lifecycle, product, offer, message, question, hypothesis, and KPI. Attributed revenue is a signal. # Outputs and handoffs Evidence for queries, event reviews, findings, experiments, and learning. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Raw Campaigns; Email Calendar; Marketing Calendar; Query Lab # Do not use this tab for Do not overwrite raw facts or call an observation a validated Play. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 377298a3-7535-424b-b806-a21db97ac112 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Decision Queue: Retention OS V5.1 — Governance: Decision Queue Workbook tab: Decision Queue Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Authoritative record of decisions required to move evidence into action. # When to use this tab Use to resolve findings, approve tests, select Plays, prioritize data, or change governance. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure KIP recommends; the accountable owner decides; every decision needs an owner, date, rationale, and linked action. # Outputs and handoffs Clear decisions with ownership and downstream actions. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Findings & Analysis; Action Queue; Experiment Ledger; Learning Ledger # Do not use this tab for Do not leave decisions in chat without recording the outcome. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Decision Queue Workbook tab: Decision Queue Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Authoritative record of decisions required to move evidence into action. # When to use this tab Use to resolve findings, approve tests, select Plays, prioritize data, or change governance. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure KIP recommends; the accountable owner decides; chat is not a completed decision. # Outputs and handoffs Clear decisions with ownership and downstream actions. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Findings & Analysis; Action Queue; Experiment Ledger; Learning Ledger # Do not use this tab for Do not leave decisions without an owner or date. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row dc0978e9-fd22-498d-a20b-264e8edd4411 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Query Lab: Retention OS V5.1 — Governance: Query Lab Workbook tab: Query Lab Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Fast question-and-analysis interface. # When to use this tab Use to ask repeatable questions about winners, underperformers, channels, dates, events, and volume. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Every meaningful query leads to a decision, action, experiment, or explicit no-action conclusion. # Outputs and handoffs Decision-ready evidence and hypotheses. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Findings & Analysis; Decision Queue; Campaign Ledger; Flow Ledger; Confidence Model # Do not use this tab for Do not generate correlations without a business question. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Query Lab Workbook tab: Query Lab Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Fast question-and-analysis interface. # When to use this tab Use to ask repeatable questions about winners, underperformers, channels, dates, events, and volume. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Every meaningful query leads to a decision, action, experiment, or explicit no-action conclusion. # Outputs and handoffs Decision-ready evidence and hypotheses. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Findings & Analysis; Decision Queue; Campaign Ledger; Flow Ledger; Confidence Model # Do not use this tab for Do not generate correlations without a business question. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 622a7810-2163-434a-ad38-029f1afb4e30 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Marketing Calendar: Retention OS V5.1 — Governance: Marketing Calendar Workbook tab: Marketing Calendar Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Canonical commercial event context. # When to use this tab Use to define timing, purpose, offer, product role, channel mix, and retention objective. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Stable Calendar IDs are required; unmapped campaigns must be flagged. # Outputs and handoffs Event context and future planning memory. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Promotion Performance; Campaign Ledger; Email Calendar; Learning Ledger # Do not use this tab for Do not change historical event definitions to improve a result. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Marketing Calendar Workbook tab: Marketing Calendar Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Canonical commercial event context. # When to use this tab Use to define timing, purpose, offer, product role, channel mix, and retention objective. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Stable Calendar IDs are required; unmapped campaigns must be flagged. # Outputs and handoffs Event context and future planning memory. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Promotion Performance; Campaign Ledger; Email Calendar; Learning Ledger # Do not use this tab for Do not change historical event definitions to improve a result. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 14fc650b-f51a-4e3c-a4c2-ca387e249e10 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Retention KPIs: Retention OS V5.1 — Governance: Retention KPIs Workbook tab: Retention KPIs Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Outcome scorecard for returning revenue, returning share, Shopify context, product opportunity, and operating health. # When to use this tab Use to see whether retention and the learning flywheel are improving. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Returning revenue share is an outcome; use other tabs to explain movement. # Outputs and handoffs Weekly KPI discussion and prioritized questions. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Daily Shopify Metrics; New vs Returning by Product; Product Retention Query; Executive Dashboard # Do not use this tab for Do not label movement causal without evidence. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 2e19afd5-20ad-4ebc-ac82-28392ac2407e (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Raw Campaigns: Retention OS V5.1 — Governance: Raw Campaigns Workbook tab: Raw Campaigns Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Source-preserved Klaviyo campaign export. # When to use this tab Use only to audit source values and refresh Campaign Ledger. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure No manual enrichment or interpretation belongs here. # Outputs and handoffs Auditable campaign source data. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Campaign Ledger; Definitions & Setup; Data Requirements # Do not use this tab for Do not edit source values. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Raw Campaigns Workbook tab: Raw Campaigns Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Source-preserved Klaviyo campaign export. # When to use this tab Use only to audit source values and refresh Campaign Ledger. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure No manual enrichment or interpretation belongs here. # Outputs and handoffs Auditable campaign source data. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Campaign Ledger; Definitions & Setup; Data Requirements # Do not use this tab for Do not edit source values to make formulas work. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row e9d6ca86-d000-4ac2-9375-5a8e63dd5170 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Lifecycle Cohort Lab: Retention OS V5.1 — Governance: Lifecycle Cohort Lab Workbook tab: Lifecycle Cohort Lab Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Lifecycle analysis and intervention workspace built on cohort revenue curves. # When to use this tab Use to turn a revenue gap into a lifecycle question, experiment, learning, and Play. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Lifecycle Revenue Cohorts is the canonical data structure; this tab is the intervention layer. # Outputs and handoffs Lifecycle experiments and journey improvements. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Lifecycle Revenue Cohorts; Experiment Ledger; Learning Ledger; Play Registry # Do not use this tab for Do not declare success without re-measuring the curve. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Lifecycle Cohort Lab Workbook tab: Lifecycle Cohort Lab Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Lifecycle analysis and intervention workspace built on cohort revenue curves. # When to use this tab Use to turn a revenue gap into a lifecycle question, experiment, learning, and Play. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Lifecycle Revenue Cohorts is the canonical data structure; this tab is the intervention layer. # Outputs and handoffs Lifecycle experiments and journey improvements. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Lifecycle Revenue Cohorts; Experiment Ledger; Learning Ledger; Play Registry # Do not use this tab for Do not declare success without re-measuring the curve. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 81efcdb7-106a-421a-8fa2-362a4547c875 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Promotion Performance: Retention OS V5.1 — Governance: Promotion Performance Workbook tab: Promotion Performance Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Promotion and event review layer linking commercial events to retention performance. # When to use this tab Use after an event or while planning the next event. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure An event is incomplete until its outcome, learning, next Play, and owner decision are recorded. # Outputs and handoffs Event decisions and better future plans. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Marketing Calendar; Campaign Ledger; Email Calendar; Learning Ledger # Do not use this tab for Do not leave completed events in Needs Review. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row ca5307d0-b789-44b0-ad3e-b87de75ba1d2 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Play Registry: Retention OS V5.1 — Governance: Play Registry Workbook tab: Play Registry Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Library of repeatable retention mechanisms with trigger, audience, message, offer, KPI, guardrails, and evidence. # When to use this tab Use to reuse validated winners. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure A Play is not a campaign name; Validated/Core requires evidence and repeatability. # Outputs and handoffs Reusable briefs and compounding execution quality. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Learning Ledger; Play Validation; Play Fatigue; Email Calendar # Do not use this tab for Do not promote one-off wins to Core. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row f561fd21-12f5-4537-a8ca-2ea838eb5f8d (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Operating Cadence: Retention OS V5.1 — Governance: Operating Cadence Workbook tab: Operating Cadence Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Recurring schedule for daily, weekly, monthly, event-close, and quarterly operation. # When to use this tab Use to make the workbook an operating routine. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Every review ends with decisions, owners, due dates, and measurable next steps. # Outputs and handoffs Predictable learning rhythm and accountability. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Retention KPIs; Decision Queue; Action Queue; Promotion Performance; Learning Ledger # Do not use this tab for Do not hold meetings that only read dashboards. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 35394895-30ae-4d00-b772-95a2f5268847 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Play Fatigue: Retention OS V5.1 — Governance: Play Fatigue Workbook tab: Play Fatigue Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Warning layer for Plays that are overused, declining, or stale. # When to use this tab Use to decide whether to refresh, variant-test, limit, or retire a Play. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure The monitor recommends review; it never retires Plays automatically. # Outputs and handoffs Play refresh, variant, retirement, or continued-use decisions. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Play Registry; Play Validation; Experiment Ledger; Learning Ledger # Do not use this tab for Do not treat a warning as proof the mechanism is permanently invalid. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Play Fatigue Workbook tab: Play Fatigue Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Warning layer for Plays that are overused, declining, or stale. # When to use this tab Use to decide whether to refresh, variant-test, limit, or retire a Play. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure The monitor recommends review; it never retires Plays automatically. # Outputs and handoffs Play refresh, variant, retirement, or continued-use decisions. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Play Registry; Play Validation; Experiment Ledger; Learning Ledger # Do not use this tab for Do not treat a warning as proof the mechanism is permanently invalid. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 588adba0-8b21-4219-aac8-1867d35ab91e (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Play Validation: Retention OS V5.1 — Governance: Play Validation Workbook tab: Play Validation Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Usage-level evidence for each time a Play is used. # When to use this tab Use to validate Play performance across real executions. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure A Play can be invalidated or limited; that is useful knowledge. # Outputs and handoffs Evidence for Play status and planning. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Play Registry; Play Fatigue; Learning Ledger; Campaign Ledger # Do not use this tab for Do not validate a Play from a single unexamined use. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Play Validation Workbook tab: Play Validation Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Usage-level evidence for each time a Play is used. # When to use this tab Use to validate Play performance across real executions. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure A Play can be invalidated or limited; that is useful knowledge. # Outputs and handoffs Evidence for Play status and planning. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Play Registry; Play Fatigue; Learning Ledger; Campaign Ledger # Do not use this tab for Do not validate a Play from a single unexamined use. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 52e07de6-84cf-4fd9-980e-293c73a0f76f (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Learning Ledger: Retention OS V5.1 — Governance: Learning Ledger Workbook tab: Learning Ledger Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Durable memory of what happened, why it likely happened, evidence strength, limitations, and behavior change. # When to use this tab Use after an experiment, finding, or event review produces enough evidence. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure A Finding is not a Learning; a Decision is not a Learning; a Learning changes future behavior. # Outputs and handoffs Reusable knowledge and explicit execution changes. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Experiment Ledger; Promotion Performance; Play Registry; Play Validation # Do not use this tab for Do not record observations with no action. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 8023ef0b-7437-4109-aa0d-fadd59690b47 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Experiment Ledger: Retention OS V5.1 — Governance: Experiment Ledger Workbook tab: Experiment Ledger Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Registry of questions, hypotheses, tests, results, verdicts, decisions, and implementation. # When to use this tab Use to turn a finding or lifecycle question into a test. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Every completed test needs a conclusion, decision, learning, or explicit no-action rationale. # Outputs and handoffs Decision-ready test evidence. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Query Lab; Findings & Analysis; Decision Queue; Learning Ledger; Play Validation # Do not use this tab for Do not start a test without a question. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row b28cee92-c756-40cc-b305-96f65716622c (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Definitions & Setup: Retention OS V5.1 — Governance: Definitions & Setup Workbook tab: Definitions & Setup Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Visible controls, benchmarks, source coverage, and limitations. # When to use this tab Use before relying on a metric or changing a benchmark. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Assumptions must be visible; missing data becomes a Data Requirement or Action. # Outputs and handoffs Auditable analytical boundaries. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Data Requirements; Confidence Model; Raw Campaigns; Raw Flows # Do not use this tab for Do not bury business rules in formulas. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 4fd100ad-9f5b-4911-84bd-0f10851cc6c7 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Executive Dashboard: Retention OS V5.1 — Governance: Executive Dashboard Workbook tab: Executive Dashboard Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Executive control center for whether the Retention OS is producing decisions, actions, learnings, validated Plays, and economic progress. # When to use this tab Use in leadership review to choose where attention or resources are needed. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Open work is healthy when owned and moving; the goal is learning velocity, not a green dashboard. # Outputs and handoffs Leadership priorities, escalations, and resource decisions. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Retention KPIs; Dashboard; Operating Cadence; Decision Queue; Learning Ledger # Do not use this tab for Do not use it to replace the operating review. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Executive Dashboard Workbook tab: Executive Dashboard Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Executive control center for whether the Retention OS is producing decisions, actions, learnings, validated Plays, and economic progress. # When to use this tab Use in leadership review to choose where attention or resources are needed. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Open work is healthy when owned and moving; the goal is learning velocity, not a green dashboard. # Outputs and handoffs Leadership priorities, escalations, and resource decisions. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Retention KPIs; Dashboard; Operating Cadence; Decision Queue; Learning Ledger # Do not use this tab for Do not use it to replace the operating review. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 9e03f775-5900-4420-afb0-bbe7f4a0fc80 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Dashboard: Retention OS V5.1 — Governance: Dashboard Workbook tab: Dashboard Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Fast control center for starting the next operating action. # When to use this tab Use at the start of a work session. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Use cards to locate the underlying tab; do not make material decisions from a card alone. # Outputs and handoffs A prioritized starting point. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Retention KPIs; Executive Dashboard; Query Lab; Decision Queue # Do not use this tab for Not causal proof or a replacement for underlying ledgers. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 883fc40f-778a-4ecb-a86e-1fbe2fe9aa0e (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Governed Lists: Retention OS V5.1 — Governance: Governed Lists Workbook tab: Governed Lists Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Controlled vocabulary for statuses, classifications, priorities, and repeatable values. # When to use this tab Use whenever entering a ledger value. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Use exact list values; propose new values through governance. # Outputs and handoffs Consistent, searchable, automatable records. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Definitions & Setup; Decision Queue; Experiment Ledger; Learning Ledger; Play Registry # Do not use this tab for Do not invent synonyms or ad hoc statuses. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 4c7bdce9-6b49-41a7-b152-648232eada45 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Daily Shopify Metrics: Retention OS V5.1 — Governance: Daily Shopify Metrics Workbook tab: Daily Shopify Metrics Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Daily Shopify business denominator: sales, returns, orders, customers, and AOV. # When to use this tab Use to put retention results in total-business context. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Dates must be typed and unique; this tab gives context, not email causality. # Outputs and handoffs Daily sales context and denominator metrics. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Retention KPIs; Daily Retention OS; Definitions & Setup; Marketing Calendar # Do not use this tab for Do not claim an email caused a sale from this tab alone. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Daily Shopify Metrics Workbook tab: Daily Shopify Metrics Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Daily Shopify business denominator: sales, returns, orders, customers, and AOV. # When to use this tab Use to put retention results in total-business context. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Dates must be typed and unique; this tab gives context, not email causality. # Outputs and handoffs Daily sales context and denominator metrics. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Retention KPIs; Daily Retention OS; Definitions & Setup; Marketing Calendar # Do not use this tab for Do not claim an email caused a sale from this tab alone. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 31d75200-7e6c-4b09-b38e-43c92d494d67 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Confidence Model: Retention OS V5.1 — Governance: Confidence Model Workbook tab: Confidence Model Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Transparent evidence-quality model. # When to use this tab Use to calibrate trust in a finding. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Confidence is not truth and does not automatically promote a Play. # Outputs and handoffs Shared language for evidence strength. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Findings & Analysis; Query Lab; Experiment Ledger; Play Registry # Do not use this tab for Do not use a high score to override missing causal or economic evidence. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Confidence Model Workbook tab: Confidence Model Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Transparent evidence-quality model. # When to use this tab Use to calibrate trust in a finding. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Confidence is not truth and does not automatically promote a Play. # Outputs and handoffs Shared language for evidence strength. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Findings & Analysis; Query Lab; Experiment Ledger; Play Registry # Do not use this tab for Do not use a high score to override missing causal or economic evidence. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row bbbd1b9b-a2ed-4947-9297-9a329b603139 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Start Here: Retention OS V5.1 — Governance: Start Here Workbook tab: Start Here Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Orientation and entry point for the Retention Operating System. # When to use this tab Use first when onboarding or re-anchoring the team on the system. Follow: Retention KPIs → Query Lab/Product Retention Query → Findings & Analysis → Decision Queue → Action Queue → Experiment/Learning → Play Registry → Play Validation. # Authoritative inputs Source systems remain authoritative for raw facts. This tab explains the workbook operating model. # Ownership and cadence KIP maintains data and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # Quality gate Every operating question should end in a decision, action, experiment, learning, or explicit no-action conclusion. # Related tabs Dashboard; Retention KPIs; Definitions & Setup; Operating Cadence; Master Governance Guide # Do not use this tab for Data entry, source-system editing, or performance conclusions. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 2678bbbb-e416-458b-9302-0df7e975bb07 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Email Calendar: Retention OS V5.1 — Governance: Email Calendar Workbook tab: Email Calendar Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Planning and historical backfill ledger for every planned email send. # When to use this tab Use to preserve purpose, audience, event, question, hypothesis, and expected KPI. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Meaningful sends need stable ID, event, audience, question, hypothesis, KPI, and owner. # Outputs and handoffs Planning-to-performance bridge. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Campaign Ledger; Marketing Calendar; Query Lab; Promotion Performance # Do not use this tab for Do not use it as a substitute for performance data. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Email Calendar Workbook tab: Email Calendar Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Planning and historical backfill ledger for every planned email send. # When to use this tab Use to preserve purpose, audience, event, question, hypothesis, and expected KPI. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Meaningful sends need stable ID, event, audience, question, hypothesis, KPI, and owner. # Outputs and handoffs Planning-to-performance bridge. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Campaign Ledger; Marketing Calendar; Query Lab; Promotion Performance # Do not use this tab for Do not use it as a substitute for performance data. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row a9931108-1283-4665-9933-d86dc9af4d73 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Findings & Analysis: Retention OS V5.1 — Governance: Findings & Analysis Workbook tab: Findings & Analysis Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Evidence layer between observations and decisions. # When to use this tab Use to record signal, evidence, confidence, interpretation, and recommended action. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure A Finding is not a Learning; each finding needs a next action or disposition. # Outputs and handoffs Prioritized decision work. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Query Lab; Decision Queue; Action Queue; Learning Ledger; Confidence Model # Do not use this tab for Do not leave Needs Decision records indefinitely. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Findings & Analysis Workbook tab: Findings & Analysis Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Evidence layer between observations and decisions. # When to use this tab Use to record signal, evidence, confidence, interpretation, and recommended action. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure A Finding is not a Learning; each finding needs a next action or disposition. # Outputs and handoffs Prioritized decision work. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Query Lab; Decision Queue; Action Queue; Learning Ledger; Confidence Model # Do not use this tab for Do not leave Needs Decision records indefinitely. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row f262d767-fff2-4a44-8752-1c8777da0613 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Data Requirements: Retention OS V5.1 — Governance: Data Requirements Workbook tab: Data Requirements Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Owned backlog of source gaps that block stronger decisions. # When to use this tab Use whenever a question cannot be answered reliably. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Missing data is an owned decision, not a buried limitation; P0 work needs an owner and action. # Outputs and handoffs Prioritized data improvement work. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Definitions & Setup; Action Queue; Raw Campaigns; Raw Flows; Lifecycle Revenue Cohorts # Do not use this tab for Do not silently downgrade a decision because data is missing. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 5cdbc801-b7c5-4f43-9a05-7217ff247b02 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:52 AMRetention OS Governance — Lifecycle Revenue Cohorts: Retention OS V5.1 — Governance: Lifecycle Revenue Cohorts Workbook tab: Lifecycle Revenue Cohorts Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Canonical cohort structure for revenue realization across Days 0/1/3/7/14/21/31/60/90. # When to use this tab Use to expose lifecycle monetization gaps. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Empty rows are not evidence; gaps matter only when followed by intervention and re-measurement. # Outputs and handoffs Lifecycle hypotheses and updated revenue curves. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Lifecycle Cohort Lab; Data Requirements; Experiment Ledger; Learning Ledger # Do not use this tab for Do not infer customer-level performance from aggregate email attribution. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row ca4304c9-e618-4428-94b6-f9e9358cda80 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:51 AMRetention OS Governance — Raw Flows: Retention OS V5.1 — Governance: Raw Flows Workbook tab: Raw Flows Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Source-preserved Klaviyo flow export. # When to use this tab Use to audit aggregate values and identify missing dated evidence. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure No valid send date means no daily attribution. # Outputs and handoffs Auditable flow source data and visible limitations. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Flow Ledger; Definitions & Setup; Data Requirements # Do not use this tab for Do not invent dates or step-level performance. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Raw Flows Workbook tab: Raw Flows Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Source-preserved Klaviyo flow export. # When to use this tab Use to audit aggregate values and identify missing dated evidence. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure No valid send date means no daily attribution. # Outputs and handoffs Auditable flow source data and visible limitations. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Flow Ledger; Definitions & Setup; Data Requirements # Do not use this tab for Do not invent dates or step-level performance. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row 8ddc7856-68d0-4e15-bacd-22142d5e03a0 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:51 AMRetention OS Governance — Product Retention Query: Retention OS V5.1 — Governance: Product Retention Query Workbook tab: Product Retention Query Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Fast product opportunity analysis from new vs returning sales. # When to use this tab Use to identify products where new demand is not repeating. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure It is a prioritization signal, not causal diagnosis; validate with cohorts, margin, and tests. # Outputs and handoffs Ranked product retention questions. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs New vs Returning by Product; Retention KPIs; Query Lab; Experiment Ledger # Do not use this tab for Do not treat the provisional share target as universal truth. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Product Retention Query Workbook tab: Product Retention Query Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Fast product opportunity analysis from new vs returning sales. # When to use this tab Use to identify products where new demand is not repeating. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure It is a prioritization signal, not causal diagnosis; validate with cohorts, margin, and tests. # Outputs and handoffs Ranked product retention questions. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs New vs Returning by Product; Retention KPIs; Query Lab; Experiment Ledger # Do not use this tab for Do not treat the provisional share target as universal truth. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row ef6c19de-4d1a-4f44-85ae-a34a892a2afb (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:51 AMKIP Retention OS — Daily 2 00 AM Cron Runbook & Test Protocol: KIP Retention OS — Daily 2:00 AM Cron Runbook & Test Protocol Production implementation specification, safeguards, and first-run validation Version: Aug 20, 2026 Production workbook: Retention Operating System Lab Sheet (IN USE) Governing policy: KIP Retention OS — Data Operations & Population Governance Implementation status: Read-only preflight passed; first controlled write pending. # 1. Business outcome This cron keeps the Retention Operating System current without duplicate dates, lost history, premature performance judgments, or broken downstream formulas. It is designed to improve the speed and quality of retention decisions—not to increase message volume. # 2. Schedule and reporting-date semantics - Run every day at 2:00 AM in America/Los_Angeles. - Cron expression: 0 2 * * * - Compute reporting_date as the prior calendar day in America/Los_Angeles. Do not use “current timestamp minus 24 hours.” - Honor daylight-saving transitions by scheduling in the named timezone, not a fixed UTC offset. - If the job is retried, reuse the same reporting_date and stable keys. # 3. Authority boundaries - KIP may read Shopify and Klaviyo, populate source-owned fields, repair formula references caused by top-row insertion, run quality checks, and report exceptions. - KIP must not make final business decisions, change governance, create promotional or financial rules, overwrite human-owned interpretation fields, or classify immature campaigns as winners or underperformers. - Audrey owns retention decisions, actions, learning interpretation, experiments, and Play development within approved guardrails. - Leadership approval remains required for material margin, offer, budget, brand, policy, cross-functional, governance, or exception decisions. # 4. Source systems, stable keys, and freshness - Shopify is the source of truth for sales, orders, customer revenue, and new-versus-returning outcomes. - Klaviyo is the source of truth for email campaign, flow, subscriber, delivery, and attributed-revenue fields. Attributed revenue is a comparison signal, not proof of incrementality or profit. - Daily rows use reporting_date as the stable key. - Campaign records use Campaign ID as the stable key. - Flow records use Flow ID plus Flow Message ID as the stable key. - All source calls must be live at runtime. Never populate a current row from cached, inferred, or manually reconstructed data. # 5. Preflight gates — complete before any write - Confirm Shopify and Klaviyo connections are healthy. - Read current workbook metadata, sheet names, headers, Row 5 keys, frozen-row settings, validation, and dependent formulas. - Confirm the target tabs and column layouts exactly match this runbook. - Confirm reporting_date does not already exist in any one-row-per-day target. - Confirm every discovered Campaign ID is either new or eligible for an in-place source-field refresh. - Confirm Shopify new plus returning revenue equals total revenue within $0.01. - Confirm required source responses are complete and parseable. - If any gate fails, abort before the first write and return a failure report. # 6. Exact Shopify extraction ## Daily totals query FROM sales SHOW total_sales, taxes, shipping_charges, returns, orders, customers, average_order_value TIMESERIES day SINCE {reporting_date} UNTIL {reporting_date} ## New-versus-returning query FROM sales SHOW total_sales, orders, customers GROUP BY new_or_returning_customer TIMESERIES day SINCE {reporting_date} UNTIL {reporting_date} ## Product query FROM sales SHOW total_sales, orders GROUP BY new_or_returning_customer, product_title TIMESERIES day SINCE {reporting_date} UNTIL {reporting_date} ## Derived Shopify values - Returning Customer AOV = returning revenue ÷ returning orders; blank if returning orders are zero. - Returning Customer Rate = returning customers ÷ total customers; blank if total customers are zero. - Unclassified revenue = total revenue − new revenue − returning revenue. A value outside ±$0.01 is a hard failure. # 7. Exact Klaviyo extraction - Use Placed Order metric ID ShVhhC for revenue and conversion reporting. - Use Subscribed to Email Marketing metric ID VS7EbP for new email subscribers. - Use Subscribed to Text Messaging Marketing metric ID U7LKdc for new SMS subscribers. - Use event-date semantics for the daily Klaviyo row. - Email campaign revenue = email-attributed revenue − the sum of nonblank attributed-flow dimensions. - Never include the blank attributed-flow dimension in flow revenue. - Discover all email campaigns whose actual send time falls on reporting_date. One day may have zero, one, or multiple campaigns. - For every campaign, retrieve Campaign ID, Campaign Message ID, campaign name, actual send timestamp, source status, subject, preview text, audience, delivery metrics, and attributed conversion value when available. - Write the status exactly as Klaviyo returns it. A campaign may initially be Sending and later become Sent; the trailing refresh must update it. - Postscript performance analytics are not API-accessible. Do not represent Klaviyo SMS values as complete Postscript performance. # 8. Write order and tab-population contract Use one transactional write plan. If the platform cannot guarantee atomicity, write in the order below, record every stable key, and use idempotent recovery. ## Daily Shopify Metrics — A:U One row per reporting date, including zero-activity days. Insert a new Row 5 only when the date is absent. Preserve true date values, formatting, validation, and all history. ## Daily Klaviyo Metrics — A:K One row per reporting date using event-date semantics. Insert a new Row 5 only when the date is absent. Daily campaign and flow revenue must reconcile to the defined email-attributed total. ## New vs Returning by Product — A:E Insert the entire reporting-date block at Row 5. One row per customer segment and product. Sort within the date block by total sales descending. Preserve all older blocks below it. ## Email Calendar — A:AB Add one row per actual Klaviyo email send. Add no row on a no-email day. Add multiple rows when multiple campaigns send. Sort newest actual send time first. Use Campaign ID to prevent duplicates and source status for Column F. ## Raw Campaigns — A:Q Upsert source-preserved campaign records by Campaign ID. Do not replace source data with inference. ## Campaign Ledger — A:AL Upsert source-owned performance fields by Campaign ID. Preserve human-owned context, interpretation, decisions, learning links, and action fields. ## Daily Retention OS — A:Z Insert one reporting-date row at Row 5. Populate source inputs and maintain formulas in K:R. Campaign count may be zero. ## Retention KPIs Do not manually write daily KPI values. The tab is formula-owned and must roll forward after source tabs are updated. ## Flow Ledger and Raw Flows Do not create dated daily flow rows. Refresh source-owned lifetime or message-level aggregates in place by Flow ID plus Flow Message ID. Preserve human-owned fields. # 9. Formula-range safeguard after every top-row insertion - Google Sheets may shift absolute formula ranges downward when a new Row 5 is inserted. After all inserts, reassert that governed source ranges begin at Row 5. - Verify Daily Retention OS formulas reference Campaign Ledger and Daily Shopify Metrics from Row 5. - Verify Retention KPIs formulas reference Daily Shopify Metrics and Daily Klaviyo Metrics from Row 5. - Verify Dashboard, Executive Dashboard, Promotion Performance, and Query Lab formulas reference Campaign Ledger from Row 5. - Confirm there are no #REF!, #VALUE!, #N/A, or circular-reference errors introduced by the run. # 10. Delayed-attribution two-pass protocol ## Pass 1 — New activity: insert the new reporting-date rows and new campaign records. ## Pass 2 — Rolling correction: every day, refresh source-owned Klaviyo fields for all campaigns inside the governed trailing attribution window. - Use Campaign ID for in-place corrections. Never insert a second campaign row because revenue or status changed. - Age 0–72 hours: Early Signal only. - After 72 hours and until the later of seven completed days or the configured Klaviyo attribution window plus 24 hours: Requires More Time. - Only after that gate may a result be eligible for Decision-Ready classification, subject to sample size, audience, promotion, margin, and context. - During the immature window, prohibit winner, underperformer, scale, repeat, retire, or angle-change recommendations. # 11. Failure handling and recovery - Never report success when one or more governed target tabs failed. - Do not create placeholder rows from partial source data. - On failure, log the stage, source, query, stable key, error, and whether any writes occurred. - Replay idempotently using reporting_date, Campaign ID, and Flow ID plus Flow Message ID. - Protect all human-owned fields during replay. - If the daily run is incomplete by 3:00 AM America/Los_Angeles, raise an operational exception for KIP review. # 12. Required run log - Record run_id, scheduled_at, started_at, completed_at, timezone, reporting_date, dry_run flag, write_enabled flag, source windows, source row counts, inserted keys, updated keys, skipped duplicates, formula repairs, validation results, errors, and duration. - Retain enough detail to reproduce the transformation without storing credentials or secrets. # 13. First-run test protocol Test reporting date: Aug 19, 2026 ## Phase 1 — Read-only preflight - Run every source query and transformation with dry_run=true and write_enabled=false. - Compare the generated write payload against current Row 5 keys and formulas. - Result: PASSED. ## Phase 2 — Controlled production write - At the scheduled 2:00 AM run, execute with write_enabled=true only after all preflight gates pass. - Stop and report immediately if a header, duplicate, reconciliation, source, or formula gate fails. - Result: PENDING. ## Phase 3 — Post-write verification - Re-read every affected range after the write. Do not validate from the request payload alone. - Confirm the reporting date is newest at Row 5, campaign rows are unique, formulas start at Row 5, KPI dates roll forward, and historical rows remain intact. ## Phase 4 — Attribution replay verification - Refresh the campaign during the trailing window and confirm status and attributed values update in place without changing human-owned fields or creating duplicates. # 14. Verified dry-run evidence - Shopify total revenue: $17,366.12. - Shopify new-customer revenue: $14,080.19. - Shopify returning-customer revenue: $3,285.93. - Revenue split variance: $0.00. - Orders: 155; customers: 151; average order value: $130.806. - Returning orders: 47; returning customers: 44; returning-customer AOV: $69.91; returning-customer rate: 29.1%. - Product rows prepared: 64. - Klaviyo email-attributed revenue: $8,227.22. - Klaviyo flow revenue from nonblank attributed-flow dimensions: $6,082.64. - Klaviyo email campaign revenue: $2,144.58. - New email subscribers: 703; new SMS subscribers: 0. - Campaigns discovered: 1. - Campaign ID: 01KZYFWX5JVGJC1HVKD4WTZ0G9. - Campaign name: Wed, Aug 19 - Midnight Gunmetal. - Campaign message ID: 01KZYFWX9W5G04WDHSSTRZ5WRM. - Subject: This Wallet speaks for itself. - Preview text: Midnight Gunmetal - our most highly requested Supercar color. - Current source status at preflight: Sending. The rolling refresh must change it to Sent only when Klaviyo does. - Current delivered count: 181,183; current attributed campaign revenue: $527.74001. These campaign-level values are immature and must be refreshed. # 15. First production-run acceptance criteria - Daily Shopify Metrics Row 5 equals reporting_date and appears exactly once. - Daily Klaviyo Metrics Row 5 equals reporting_date and appears exactly once. - Daily Retention OS Row 5 equals reporting_date and appears exactly once. - The product tab contains exactly 64 prepared rows for reporting_date unless a fresh rerun legitimately changes the source result; any variance must be explained. - The discovered Campaign ID appears exactly once in Email Calendar, Raw Campaigns, and Campaign Ledger. - Email Calendar Column F equals the current Klaviyo source status. - Retention KPIs reporting end date advances to reporting_date. - All governed formula source ranges begin at Row 5. - No formula errors, duplicate keys, lost history, or overwritten human-owned fields are present. - The run log reports success only after post-write reads confirm every criterion. # 16. KIP handoff instruction - Read this runbook and KIP Retention OS — Data Operations & Population Governance in full. - Configure the job for 0 2 * * * in America/Los_Angeles. - Run dry_run=true and write_enabled=false first. Return the preflight report and proposed write counts. - For the first production run, set write_enabled=true only when every preflight gate passes. Stop on any acceptance failure and do not classify new campaigns. - After the write, return the exact inserted, updated, skipped, repaired, and failed keys plus verification results. # 17. Open implementation item - Confirm the account’s configured Klaviyo attribution window. Until verified, refresh at least the prior seven completed days and enforce the later-of decision gate defined in governance. - An isolated persistent workbook copy was not created because it would duplicate sensitive business data. If Kings Loot explicitly authorizes a dedicated sandbox copy, use it for an additional write test; otherwise the controlled production run above is the first write test # 18. Mandatory structural insertion contract - This section is normative. It overrides any ambiguous wording elsewhere in this runbook. - Every daily refresh must insert new physical rows before writing values. Never overwrite Row 5 or any historical row. - Before writing, read the current newest key in Row 5 and scan the target key range for duplicates. - If the target reporting date already exists, do not insert or overwrite it; stop and report a duplicate. - If Row 5 contains a later date than the requested reporting date, stop and report a stale or out-of-order run. - Daily Shopify Metrics, Daily Klaviyo Metrics, and Daily Retention OS receive one physical row inserted at Row 5 per reporting date. - New vs Returning by Product receives one physical row inserted at Row 5 for every product/segment record in the complete date block. Insert the entire block before writing any block values. - Email Calendar receives one physical row per actual send. Multiple sends on one date produce multiple inserted rows; a no-email date produces no Email Calendar row. - Raw Campaigns and Campaign Ledger upsert by stable Campaign ID. They must never create duplicate Campaign IDs. - Flow Ledger and Raw Flows update source-owned fields in place by Flow ID plus Flow Message ID; they do not receive one row per day. - Use structural insertDimension or the equivalent governed row-insertion primitive, not updateCells over the existing Row 5. - After every insertion, preserve and verify frozen rows, formatting, validation, date/time types, and historical order. - After all insertions, repair or reassert dependent formula ranges so governed source ranges begin at Row 5. - A dry run must return the current Row 5 key, target key, row counts, insertion positions, stable keys, formulas affected, and proposed writes. A source-only metric response is not a dry run. - The run is successful only after fresh read-back confirms the new date is at Row 5, inserted blocks have the expected row count, stable keys are unique, formulas are valid, and historical rows remain intact. - If any structural, source, reconciliation, authorization, or read-back gate fails, fail closed and make no partial write. - .import: KIP vault memory via kip_vault_search row a4629c7f-9f3e-4d2e-a024-c0615a5e42f2 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:51 AMRetention OS Governance — New vs Returning by Product: Retention OS V5.1 — Governance: New vs Returning by Product Workbook tab: New vs Returning by Product Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Product-level separation of new-customer and returning-customer sales. # When to use this tab Use to find acquisition-heavy products with weak repeat revenue. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Product-level customer/order counts are not additive across products. # Outputs and handoffs Product retention questions and cross-sell hypotheses. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Product Retention Query; Retention KPIs; Lifecycle Cohort Lab # Do not use this tab for Do not infer customer-level retention rate without a defined denominator. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: New vs Returning by Product Workbook tab: New vs Returning by Product Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Product-level separation of new-customer and returning-customer sales. # When to use this tab Use to find acquisition-heavy products with weak repeat revenue. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Product-level customer/order counts are not additive across products. # Outputs and handoffs Product retention questions and cross-sell hypotheses. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Product Retention Query; Retention KPIs; Lifecycle Cohort Lab # Do not use this tab for Do not infer customer-level retention rate without a defined denominator. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row c6394447-d7bd-4d76-bb44-8c332b417db3 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:51 AMRetention OS Governance — Action Queue: Retention OS V5.1 — Governance: Action Queue Workbook tab: Action Queue Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Execution layer for approved decisions, tests, data work, and governance changes. # When to use this tab Use to assign, schedule, execute, and validate work. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Complete means executed and evidenced, not merely intended. # Outputs and handoffs Visible accountability and completed implementation. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Decision Queue; Experiment Ledger; Play Validation; Data Requirements # Do not use this tab for Do not create orphan actions. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.Retention OS V5.1 — Governance: Action Queue Workbook tab: Action Queue Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Execution layer for approved decisions, tests, data work, and governance changes. # When to use this tab Use to assign, schedule, execute, and validate work. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Complete means executed and evidenced, not merely intended. # Outputs and handoffs Visible accountability and completed implementation. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Decision Queue; Experiment Ledger; Play Validation; Data Requirements # Do not use this tab for Do not create orphan actions. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row f6ec2d41-4cb6-46c2-af25-c20cadd9e40e (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:51 AMRetention OS Governance — Flow Ledger: Retention OS V5.1 — Governance: Flow Ledger Workbook tab: Flow Ledger Workbook: https://docs.google.com/spreadsheets/d/1t5h8ECZgST6_T1bHpEbShOCCm-alblotWX4xvBHCB3U/edit?usp=drivesdk Status: Active operating governance # Purpose Flow-message performance and health record. # When to use this tab Use to manage flows as living revenue systems. # Authoritative inputs Source systems remain authoritative for raw facts. Use the linked source and upstream tabs named in the workbook before interpreting a result. # Required operating procedure Do not infer daily attribution without dated message-level evidence. # Outputs and handoffs Flow optimization queue and lifecycle tests. # Ownership and cadence KIP maintains data, performs quality checks, surfaces exceptions, and prepares recommendations daily. Audrey owns retention interpretation, prioritization, decisions, and the weekly operating review. Joshua/leadership handles strategic, resource, margin, or governance decisions that exceed Audrey's authority. # KIP daily behavior Refresh or preserve source data, run quality checks, flag missing context, connect this tab to the next handoff, and recommend the next action. KIP must not silently change governance, invent missing data, or mark a decision, learning, or Play complete without required owner evidence. # Quality gate A record is complete only when required fields are populated, evidence is traceable, the owner is clear, and the next handoff is explicit. # Related tabs Raw Flows; Experiment Ledger; Lifecycle Revenue Cohorts; Data Requirements # Do not use this tab for Do not call a flow healthy only because aggregate revenue is large. # Authority This document governs how the tab is used. It does not authorize actions outside approved Kings Loot governance.import: KIP vault memory via kip_vault_search row a2187e77-ad3d-41b5-8d2e-5c9867e70a83 (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:51 AMContext Transfer Document — KIP Infrastructure Hardening Thread (2026-08-29 to 08-31): # Context Transfer Document — KIP Infrastructure Hardening Thread Covers: 2026-08-29 through 2026-08-31, `Kings-Loot/kip` repo, branch `claude/new-session-fislos` A note on fit before the sections: the requested template (Company Context, CEO psychology, KPIs, RACI) is built for a business-strategy conversation. This thread was almost entirely a technical incident-response and infrastructure-hardening session. Every section below is filled honestly — some (Company Context, KPIs in the traditional sense) have thin material because that's genuinely what was discussed, not because it was compressed out. --- ## 1. Executive Summary **What this thread was mainly about:** KIP (Kings Loot's internal AI assistant/decision-intelligence system, lives in Slack) suffered a serious production outage on 2026-08-29 — background cron jobs and interactive Slack chat share one server process and one 10-connection database pool; a stuck job drained the pool, and the whole assistant went silent for stretches, with a self-sustaining restart loop. Joshua ran the entire day (into early morning 08-31) directing "Devin" (an AI coding agent with GitHub/DigitalOcean/Slack access) through diagnosis, fixes, and a full architectural hardening program, with Claude acting as an independent verifier and plain-language translator between Joshua and Devin's technical reports. **Key decisions made:** - Approved and shipped a full architectural fix: background schedulers moved off the API process onto a separate DigitalOcean worker component (+$12/mo), so a stuck job can no longer take down interactive Slack. - Approved a durable "never lose the ask" capture mechanism so an incoming Slack message can never be silently destroyed again (this is what happened in an earlier, previously-undiscussed Aug 10 incident: two messages vanished for 6 hours). - Approved locking down a raw-message capture table that had accidentally been readable by any part of the app (cross-tenant/cross-user data exposure), via a dedicated least-privilege database credential, fail-closed if missing. - Decided to keep Retention OS (a scheduled spreadsheet-refresh job) **paused indefinitely** at Joshua's explicit request, even after its root cause was found to be already fixed. - Decided **not** to do a full git-history rewrite to scrub an accidentally-committed personal phone number (Joshua's own, private repo, not a live credential) — accepted as low-risk, added a CI guard idea instead. - Established (and repeatedly enforced) a working principle: verify every claim Devin makes against real code/production/CI before acting on it — this caught real stale-checkout mistakes on both sides during the day. **Current state at end of thread:** Core outage is fixed and verified live. Worker split is live and verified (all ~24 schedulers moved, zero on API process). The capture-table security fix is in two parts: the new credential is live and provisioned (#1383, merged); the final step that revokes the old broad access (#1387) was open, CI not yet green, not yet merged. Follow-ups never fully confirmed: the CI guard for phone-number-shaped committed values, and a small "document the kip_ingest test role" environment-doc suggestion. --- ## 2. Company Context Not substantively discussed in this thread — this was an infrastructure firefight, not a strategy conversation. What's inferable only from peripheral evidence (Slack channel names, KIP's own daily production-report excerpts glimpsed while debugging), **not confirmed or elaborated on by Joshua directly**: - Kings Loot appears to be a Shopify-based e-commerce company (references to Shopify sales data, "Kings Loot Performance Marketing Tracker," BEROAS metrics, CM/contribution-margin tracking, a "13 Week Cashflow Forecast"). - KIP is an internal tool, not a resold product — confirmed explicitly: "tenant" in the codebase means per-KIP-user/account isolation within Kings Loot itself, not external paying customers (Joshua corrected this mid-thread). - Slack channels visible in screenshots suggest departmental structure: `kl_finance`, `kl_marketing`, `kl-directors`, `kl_ceo`, `kl-merchandising`, `kl_ap` (accounts payable), `kl-annual-planning`, `kl_brand`. No revenue figures, strategic goals, or constraints were discussed. Do not infer business strategy from this thread. --- ## 3. CEO / User Context (Joshua Stephens) Based entirely on observed behavior across a long thread — this is evidence, not speculation: **How he thinks / decision-making style:** - Wants the plain-English "why" before agreeing to anything — asked for "lamens terms" repeatedly, and pushed back hard when explanations stayed technical or got recursive/circular. - Decisive once he understands something: approvals came fast and cleanly once the tradeoff was clear (e.g., approved the worker split, $12/mo, immediately once he understood the mechanism). - Values proportionality: explicitly rejected a technically-"correct" but disruptive fix (full git-history rewrite) once told the real-world risk was low ("ya, no big deal"). - Gets visibly frustrated by process friction that doesn't map to the actual goal — a Slack-webhook/app-installation saga produced real frustration ("Why is this getting overcomplicated," "I'm sick of messing with this") and he explicitly deprioritized a nice-to-have (Slack delivery for one alert) rather than keep fighting a platform limitation. - Asks sharp, first-principles questions that cut through jargon: "customer? you mean user?" (caught wrong terminology), "so he can recall?" (correctly inferred the retry mechanism from a plain explanation), "Kip is storing the message to a ledger in the db? and why are we building this?" - Wants follow-through tracked, not re-explained: "Please don't forget to follow up with me on this." - Reads dashboards and screenshots directly and brings them into the conversation as evidence — engaged, not passive. - Occasionally pastes duplicate content or loses track of thread state during a long session (flagged this himself: "Sorry I missed one, resending" / confusion about which of two identical drafted messages to send) — worth proactively re-confirming state rather than assuming continuity in long sessions. **Known strengths:** fast, correct proportionality judgment on risk; catches real terminology/logic errors; comfortable approving infra spend once the reasoning is shown; willing to overrule a "textbook correct" recommendation with good business judgment (git history call). **Known blind spots / risks:** can get pulled into low-value process rabbit holes (Slack app setup) before recognizing them as low-leverage; in a long session, message/thread tracking degrades. **Preferences for how to be talked to:** short, direct, plain language by default; give a recommendation, not a menu of options; flag risk proactively even when not asked; don't let a decision go unresolved — explicitly ask when something is still open. --- ## 4. Key People / Roles ### Joshua Stephens - **Role:** Decision-maker / account owner for KIP at Kings Loot. Directs Devin's engineering work via Slack, makes final calls on infra, security, and priority tradeoffs. - **Current ownership:** All go/no-go decisions on infra changes, spend, security posture, and priority sequencing during this incident. ### Devin (AI coding agent, `devin-ai-integration[bot]` on GitHub, posts as "Devin" in Slack) - **Role:** Does the actual engineering — diagnosis, code, PRs, deploys, DigitalOcean/Supabase infra changes, Slack app configuration. - **Strengths observed:** thorough, self-correcting write-ups with inline verification notes explicitly inviting pushback; catches its own mistakes and issues honest corrections; proposes proportionate options (e.g., explicitly offered "the honest alternative" of not doing the git rewrite); good about sequencing risky infra changes safely (deploy-empty-first, verify-before-revoke patterns throughout). - **Weaknesses / risk pattern observed:** occasionally overclaims from a stale local checkout (happened at least twice, in both directions); Slack platform interactions (webhook channel picker, app installation) caused repeated confusion requiring several rounds to resolve; a fix landing "in the heat of the moment" sometimes needed a second corrective PR shortly after (date-hardcoded test fixed twice, because two independent same-day fixes collided). - **Current ownership:** all in-flight PRs, the worker-split rollout, the ingest-credential lockdown (final revoke step still open at thread end), item E (never-lose-the-ask), and general KIP incident follow-through. ### Claude (assistant, across sessions) - **Role in this thread:** Independent technical reviewer/translator sitting between Joshua and Devin. Verifies Devin's claims against real code/production/CI (git, GitHub API, job logs) before endorsing them to Joshua; translates technical reports into plain language; drafts ready-to-send messages to Devin; flags security/scope issues proactively; tracks open follow-ups. Operating prompt captured verbatim in Section 9. --- ## 5. Systems / Operating Models Discussed ### KIP core architecture (API process + schedulers) - **Purpose:** Slack-based AI assistant + ~24 background jobs (Fathom import, Gmail triage, Retention OS refresh, memory sweeps, reminders, heartbeats, etc.), originally all running inside one Node process on DigitalOcean App Platform, sharing one 10-connection Postgres pool with interactive Slack/web/voice traffic. - **Current state:** Root failure mode fixed. Schedulers now run on a **separate worker component** (own process, own pool). Verified live: each of ~24 jobs runs exactly once per window, zero on the API process, `/api/health` clean. - **Key rules/guardrails established:** - `DB_POOL_MAX = 10` (API), `5` (worker) — of a Postgres `max_connections = 60` (57 usable) and a Supavisor pooler limit of 200 client slots. Real ceiling is the database's tiny compute tier ("Micro," 2 shared vCPU/1GB), not connection slots. - `DB_ACQUIRE_TIMEOUT_MS = 30_000`, `DB_STUCK_TRANSACTION_MS = 150_000`, `DB_OPERATION_TIMEOUT_MS = 30_000`, `DB_ABANDONED_GRACE_MS = 180_000` — bound every wait so nothing hangs forever. - Saturation = `stuck >= max(2, ceil(poolMax * 0.5))` — trips before 100% exhaustion, not only at it (this exact gap caused the original incident). - Boot stampede fixed: scheduler first-ticks spread across a window instead of firing simultaneously. - Advisory locks (session-scoped, unsafe through the transaction pooler) replaced with durable table-backed leases with fencing tokens, where a lock needed to span multiple transactions/outbound calls. - Migration gate on worker boot is deliberately **soft** (waits up to 15 min for schema readiness, then proceeds rather than freezing forever) — matches the "late is recoverable, silent-forever is the real danger" principle established throughout. - **Not yet done, flagged as a caveat, not urgent:** the manual "Run now" button on the cron dashboard still executes on the API process, not the worker. ### Alerting - **Current state:** Cron/job failure alerts and database pool-saturation alerts both post to **#kip-health** (Slack channel ID `C0BJ7U3FFSM`), delivered via KIP's own existing bot token (not a webhook — repeated attempts to get a second alert onto a webhook-based Slack app hit real platform limits and were explicitly abandoned by Joshua). - **Gap that remains, accepted as-is:** if KIP's entire process dies (crash/OOM/failed deploy), nothing *inside* KIP can alert — covered separately by an external DigitalOcean uptime monitor hitting `/api/health`, which emails `team@kingsloot.com` (not Slack — deprioritized). ### Retention OS (spreadsheet refresh job) - **Current state:** Root cause (a header-row anchor drift) turned out to already be fixed in code by the time it was investigated. **Deliberately kept paused anyway**, at Joshua's explicit, repeated instruction — not a bug, a standing decision. Pause is now durable (survives restarts, shown distinctly as "paused" not "healthy," attributed to Joshua). - **Next step if ever revisited:** resume is a one-click toggle; no code work needed. ### Raw Slack message capture ("never lose the ask" / item E) - **Purpose:** fixes the original Aug 10 root failure — a Slack @-mention can be permanently destroyed (not delayed) if it arrives at the exact moment the database is unavailable, because Slack does not redeliver expired events. Fix: durably save the raw message the instant it arrives, before any processing, so it can always be retried later even if everything downstream fails. - **Current state:** Built and merged (#1379), but a related **security gap** was found in review: the capture table has no tenant/user attached yet at write time (by design), so any part of the app's normal database access could technically read every raw incoming Slack message across all users. - **Fix, in two deliberately sequenced steps:** 1. **#1383 (merged, verified live):** new dedicated least-privilege database credential (`kip_ingest`) that can only touch this one table; app fails to boot in production if this credential is ever missing (fail-closed, not silent fallback — approved by Joshua). 2. **#1387 (open at thread end, not yet merged):** revokes the old broad credential's access entirely, closing the hole for real. Also found and fixed in the same PR: a *second* credential (`kip_readonly`, analytics) had the same accidental access via a default-privilege pattern that will silently reapply to any *future* similarly-shaped table unless someone remembers to block it — flagged as a systemic gotcha, only patched for this table. - **Open at thread end:** #1387 needs a routine "merge latest main into branch" step (CI flagged it as stale, not broken) and a green build before merge. ### Git history exposure (Joshua's phone number) - **What happened:** while building the worker's deployment config, Devin briefly committed Joshua's real phone number (mapped to his email) in plaintext, caught it, and redacted it two commits later — old value still recoverable from git history. - **Decision:** **not** doing the full history rewrite (freeze repo, force-push, GitHub support ticket to garbage-collect). Reasoning: it's Joshua's own number, repo is private, not a live credential. Disruption of the fix judged disproportionate to the risk. - **What was suggested instead:** a CI guard to catch phone-number/email-mapping-shaped values being committed in future — **not confirmed as actually implemented/merged by thread end.** ### PR/CI hygiene during this thread - Multiple PRs failed CI on a shared, unrelated cause: a hardcoded "yesterday's date" in a docx-export test (`service.test.ts`) that breaks every day at UTC midnight — fixed once (#1381), then needed a second corrective PR (#1382) after two independent same-day fixes collided and reintroduced the same failure differently. --- ## 6. Decisions Made - Move all ~24 schedulers onto a separate worker component (own process, own DB pool) — root architectural fix. Joshua approved; Devin built. Done, live, verified. Accepted risk: single instance/single point of failure for background work (most jobs have no leader election). - Keep the migration-readiness gate on worker boot **soft** (waits, then proceeds) rather than hard-blocking. Joshua's call. Done. - Build "never lose the ask" (durable Slack-message capture before processing). Joshua approved; Devin built. Merged (#1379). Introduced the ingest-credential exposure, now being closed. - Give the raw capture table its own least-privilege database credential (`kip_ingest`), fail-closed if missing. Joshua approved both the approach and fail-closed behavior. New credential live (#1383, merged); old access revoke (#1387) still open at thread end. - Keep Retention OS paused indefinitely. Joshua's explicit standing preference, independent of the (already-fixed) technical root cause. No end date set. - Do not rewrite git history to scrub Joshua's phone number. Own data, private repo, not a live credential. Closed, no further action planned. - Route pool-saturation and cron-failure alerts to #kip-health via KIP's own bot token, not a new webhook. Joshua's call after repeated Slack platform friction. Done, live. - Fathom's scheduled 15-min import uses incremental depth (stop at first fully-known page); manual "Import meetings" keeps full depth. Joshua approved via PR review. Merged (#1354), not yet verified against every real tenant's timing in production. - Migration gate for scheduled catch-up work counts a late/skipped-day run under the *next* day's window rather than losing it — accepted as-is (#1336 landed as-is), not worth further engineering for a cosmetic-only residual quirk. --- ## 7. Open Issues / Unresolved Questions - **#1387** (revoke old broad access to the Slack capture table) was **not yet merged** at thread end — needs a routine main-merge and green CI, then Devin's own post-merge verification (read back `pg_stat_activity`) before the security gap is fully closed. **Single most important loose end to check first in a new thread.** - The CI guard meant to catch future phone-number/email-mapping-shaped committed values — **never confirmed as actually implemented.** - The `kip_readonly` default-privilege pattern (future pre-tenant tables auto-inheriting broad read access) is a known **systemic gap**, not resolved generally — only patched for the one table found. - Devin's small "document the kip_ingest test role" environment-doc suggestion on #1387 was shown but never applied. - The cron dashboard's manual "Run now" button still executes on the API process rather than the worker — flagged, accepted as low-priority, not scheduled. - No final confirmation was seen in this thread that production has fully deployed #1387 or that the post-merge `pg_stat_activity` verification happened. --- ## 8. KPIs / Metrics / Targets Mentioned All infrastructure metrics — no business KPIs were discussed in this thread. - Postgres: `max_connections = 60` (57 usable after superuser reservation) - Supavisor pooler: 200 client connection slots; in use: API 10 + worker 5 = 15 of 200 - `DB_POOL_MAX`: 10 (API), 5 (worker) - `DB_ACQUIRE_TIMEOUT_MS`: 30,000 · `DB_STUCK_TRANSACTION_MS`: 150,000 · `DB_OPERATION_TIMEOUT_MS`: 30,000 · `DB_ABANDONED_GRACE_MS`: 180,000 - Saturation threshold: `stuck >= max(2, ceil(poolMax × 0.5))` - Worker component: `apps-s-1vcpu-1gb`, 1 instance, **+$12/mo** - Total app spend after worker: **$92/mo** (was $80/mo: api $50 + web $10 + voice $20) - Worker idle resource use post-launch: ~1.6% memory, ~0.5% CPU of its 1GB box - Fathom scheduled-import prior failure rate: 15 of last 17 runs failed on `scheduler tick exceeded 300000ms watchdog` - Original 2026-08-10 incident: ~6 hours of silence, 2 Slack messages permanently lost - 2026-08-29 incident: two formal episodes (~10:55–11:20 UTC and ~12:20–12:40 UTC), though raw evidence showed continuous degraded behavior roughly 08:31–12:32 UTC and a further rough stretch ~16:00–17:26 UTC before full stabilization - 10+ PRs shipped the first day against the original incident; several more (worker split, item E, ingest credential) shipped the second day --- ## 9. Documents / Agreements / Drafts Created **Reusable "pressure-test Devin" operating prompt** — written at Joshua's request, meant to be pasted into a fresh Claude Code session to replicate this working relationship: > **Role:** You're my independent technical reviewer, sitting between me and Devin (an AI coding agent working on our codebase). I'm not a developer — translate everything into plain English, but do the real technical verification behind the scenes. > > **Core rule: never take Devin's claims at face value for anything that matters.** Before endorsing, relaying, or acting on anything Devin reports — a root cause, a fix, a "confirmed" fact, a test result, a security claim — verify it yourself against the actual source: read the real code (`git fetch`/`git show` against `origin/main`, not a possibly-stale local checkout), check real CI logs and check-run status via GitHub rather than trusting a green/red icon at face value, and read production state directly when you have access. If you can't verify something, say so explicitly rather than passing it along as fact. > > **When something doesn't check out, say so plainly** — including if I said something wrong, or if a claim contradicts what you find. Don't split the difference or soften it to avoid friction. > > **Always give a recommendation, not just a summary.** When there's a decision to make, tell me what you'd do and why, in one or two sentences. > > **Draft the actual message to send Devin**, ready to copy-paste, rather than describing what I should say. > > **Flag things I didn't ask about** if they matter — security/privacy exposure, scope creep, a claim that doesn't match the evidence, a decision quietly bundled into something else. > > **Distinguish real problems from noise** — a flaky/stale test, a "needs a rebase" CI check, and an actual bug are different categories; tell me which one I'm looking at. > > **Never treat a drafted message as sent.** I'll tell you explicitly when I've sent something. > > **Track open threads.** If something's pending, keep it visible until it's actually resolved. Other documents referenced but not reproduced here (retrievable from the Slack/Devin session history): the full 2026-08-29 incident write-up (v2), the "KIP outage → resilience program" write-up (2026-08-10 incident), a git-history scrub plan (reviewed, not executed), and an ingest-credential scope document (approved, largely executed). --- ## 10. Communication Style / Instructions for Future Assistant - Be direct. Skip hedging and filler. Give the plain-English answer first, then technical detail only if load-bearing for the decision. - Think like a technical COO for this system: focus on ownership (who is accountable for a fix), decision rights (what needs Joshua's sign-off vs. what Devin can just do), and risk (real-world blast radius, not theoretical). - Challenge assumptions — including Joshua's and Devin's. This thread's most useful moments were exactly this: catching a stale-checkout claim, catching wrong terminology, catching a security gap nobody had asked about, catching duplicate/contradictory messages before they got sent. - Verify before relaying. Do not summarize what an AI coding agent claims as if it were established fact — check the repository, CI, and production directly when access exists. - Avoid generic advice. Every recommendation in this thread was grounded in a specific number, log line, or piece of code — keep that standard. - Proportionality matters as much as correctness: the "textbook" fix is not always the right call (see: git history decision). Say what's technically ideal *and* what's proportionate, and be clear which one you're recommending. - Draft, don't describe — when a message needs to go to Devin (or anyone), write the actual text ready to send. --- ## 11. Next Best Actions 1. Check whether #1387 (revoke old broad access to the Slack capture table) has merged and been verified — the one genuinely open security item. 2. Confirm whether the CI guard for phone-number/email-mapping-shaped committed values was ever actually implemented. 3. Decide whether the `kip_readonly` default-privilege gap needs a general fix, or stays a per-table patch-as-found approach. 4. Confirm the Fathom incremental-import fix (#1354) is actually landing every tenant's scheduled pull inside its 5-minute window in production. 5. Decide whether the cron dashboard's "Run now" button should be moved to run on the worker too, for full consistency. 6. If/when Retention OS should resume, it's a one-click toggle — purely Joshua's call, no engineering work needed.import: KIP org memory via kip_get_context (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:51 AMKIP Sheets connector needs a batchUpdate passthrough, not more dedicated tools: KIP's Sheets surface is exactly 4 dedicated tools: kip_sheets_create (new spreadsheet only), kip_sheets_list_tabs, kip_sheets_read (values/formulas, whole-tab only, no range/offset param), and kip_sheets_write (values.update semantics — writes into existing grid bounds only, cannot grow a sheet). There is no batchUpdate access anywhere: no appendDimension/insertDimension, no values.append, no formatting, no tab creation on an existing spreadsheet. Two independent KIP sessions confirmed this identical surface independently. Fix: add a generic call_tool/list_tools passthrough for the Sheets connector, matching the existing pattern already used for Clarity, Intelligems, Klaviyo, and Richpanel (each gets a *_list_tools + *_call_tool pair exposing more of the native API than KIP has dedicated wrappers for). This is a reuse-before-build fit per KIP Engineering Governance rule 1 — it solves the immediate grid-resize gap and any future Sheets gap (batch formatting, formula writes, ranged reads) in one canonical mechanism instead of adding narrow tools one at a time. Trigger case: two Kings Loot Performance Marketing Tracker sessions (both running the Performance Marketing Operating System prompt) independently hit the same wall trying to repair the Media Buying Diagnostics tab — kip_sheets_write rejected a write past the sheet's 3,437-row bound with no tool available to grow it. Work was correctly left PARTIAL rather than faked. Also relevant: kip_sheets_read has no range/offset parameter, so any tab too large to fit one response gets silently truncated to a head+tail sample — a second, separate gap worth fixing in the same pass since it blocks independent read-only audits of large tabs. Why it matters: Whoever builds KIP's connectors should see this before adding a narrow fix (e.g. a one-off insertDimension tool) that would violate the org's own no-bespoke-tools engineering rule. Capturing it now means the next session that hits a Sheets structural-write or large-tab-read wall doesn't have to rediscover and re-litigate this from scratch.import: KIP org memory via kip_get_context (Kings Loot)
medium · confidence 1.00
65projects
Sep 2, 1:39 AMRequires KIP and Eadin to have matching authorized report exposure for Amazon data: The speaker requires KIP and Eadin to have the same authorized report exposure—not just the same catalog—for Amazon transaction and ad-spend reports, with parity in authorized user access, fields, rows, totals, filters, pagination, sensitivity labels, freshness timestamps and timezone behavior.import: KIP org memory via list_recent_memory (last 7d)
medium · confidence 1.00
65preferences
Sep 1, 5:44 PMKip asked about the post-purchase filter at least 4 times despite it already being fixedmcp:put_page
medium · confidence 0.95
62projects