Zorg Knowledge

Zorg's Dungeon Maker

Knowledge Base & Traceability Graph

Skill matrix (2026-09 retrospective)

One table shape everywhere: Skill | Scope | Why? (historical evidence) | What (recipe / responsibility).

This page is a map, not a new game rule and not a STATUS_LEDGER promotion. Formal game IDs stay in GAME_SPEC.

Umbrella — Keep Learning and Apply

AEA core principle. Cite GitLab #434 (sponsor reports !513 merged; #434 closed). Official one-liner from the AEA agent (PR #54 / AGENTS):

When the build teaches something, write it into the harness (skill, sensor, guide, matrix row, or ADR) before the next loop — so the next agent inherits it instead of rediscovering the failure.

Loop on this page: historical pain → skill / matrix row / finding sensor. Complements Honesty and Knowledge First. Not Antifragility (second-miss → CI/test gate). A chat note is not apply.

GitLab #434 is the stable formal principle. Principle: Documented on AEA main (sponsor reports !513 merged / #434 closed). GitLab sign-in from this agent is not a merge probe. Knowledge Pages: Unknown until AEA probes. Not Live.

Cross-project adopt links

LaneAdoptHonesty
AEAMatrix: merged !512 (Documented, closes #433). Principle: !513 / #434Documented on AEA main (Pages Unknown). GitLab sign-in is not a probe.
zorg-dungeon#53Documented; zorg knowledge Pages Probed (2026-09-13: skills, aea, findings HTTP 200). AEA Pages Unknown.
Café Fausse KnowledgeCites #434 on #213 / matrix PR (+ #203 / #204)Documented until probed
Café Fausse AppCites #434; Grok skill filed #214 (keep-learning-and-apply); folds into #205Documented until probed
logify#24 closed; PR #25 merged on main; cites #434Documented
3DX Lab#10 Keep Learning gap; draft PR #11Documented until probed (404 from this agent)
Café Fausse MRCCOMMENT-onlyNot a skill creator
ctosN/ADocker smoke is a repo script

ctos is N/A. Café App is folding into #205.

flowchart LR
  pain["Historical pain"] --> skill["Skill"]
  pain --> matrix["Matrix row"]
  pain --> sensor["Finding sensor"]

AGENTS owns the playbook wording (sibling bc-054efe6b / PR #54). This page is the apply map. Compose — do not duplicate that section.

AEA skill-matrix source (merged !512, closes #433): research/random-thoughts/2026-09-12-session-memory-log-aea-grok-skill-matrix.md.

Zorg issues (opened):

  • Adopt shared skill matrix #50
  • Kid visual rules / learn page #51
  • Corpus quarantine honesty #52
  • Keep Learning and Apply #53
  • First-play / journey UX: #36–#48 (audit also filed #30–#35)
  • Sand-workflow URLs — paste in a follow-up; slugs below are the library names. Do not invent ids.

    Kid-rules work (PR #44 / #51) should compose with this page. Do not rewrite that copy here.

    flowchart TB
      ootb["OOTB — code-changes, routines, box-desktop, skill-authoring"]
      shared["Shared Grok — rebase, honesty, companion, persona, quarantine"]
      playbooks["Project playbooks — AGENTS, GAME_SPEC, ledgers"]
      fit["Cross-project ack — Café documented until probed; AEA documented; logify documented; 3DX documented until probed"]
      ootb --> shared
      shared --> playbooks
      shared --> fit

    Loaded on this repo

    SkillScopeWhy? (historical evidence)What (recipe / responsibility)
    Keep Learning and ApplyUmbrella · GitLab #434 formal (stable) · Documented on AEA main; AEA Pages Unknown · zorg knowledge Pages Probed (2026-09-13)Phases 0–7, AFK trains, first-play audits. Adopt: zorg #53, Café App #214, Café Knowledge #213, logify #24 / PR #25, 3DX #10.Historical pain → skill / matrix row / finding sensor. Write it before the next loop. Not Live & Probed for game FRs.
    code-changesOOTB / managedUsed for every phase 0–7 slice, the Difficulté generator, campaign, and Maker UX.Load for any cloud-first edit to this tree (engine, Maker, knowledge, docs, CI).
    routinesOOTB / managedAFK parallel PRs went red with no one watching.Babysit open PRs / CI after the producer steps away.
    box-desktopOOTB / managed2026-09-12 first-play audit produced #30–#48.Live audit of zorg.artof.link. A knowledge screenshot is not that audit.
    skill-authoringOOTB / managedRebase / honesty / companion / kid misses kept coming back as paragraphs.After a miss repeats, save a recipe. This page is the map.
    pr-train-rebaseShared Grok skill · sand-workflow pr-train-rebase#23 / #24 / #25 CONFLICTING after earlier merges.Before stacking parallel cloud PRs: rebase onto latest main; do not rewrite a peer's ledger rows. Adoption: #50.
    honesty-ledger-gateShared Grok skill · sand-workflow honesty-ledger-gateS2–S6 deferrals. Invented C / Gunner duration / FR-4 would be a lie.Before any status word: five-word vocabulary; evidence or Unknown. Never invent those deferred rules. Adoption: #50.
    companion-plain-docsShared Grok skill · sand-workflow companion-plain-docsCF-007: PLAYER_GUIDE still said only Warrior/Elf after phases 4–7.Plain English + mermaid on knowledge.zorg.artof.link. GAME_SPEC wins. Adoption: #50.
    persona-journey-validationShared Grok skill · sand-workflow persona-journey-validation~8yo first-play audit; standing personas; UX issues #36–#48 (also #30–#35).Live Maker audit → named personas → issues → fix. Compose with #51. Adoption: #50.
    corpus-quarantine-honestyShared Grok skill · sand-workflow corpus-quarantine-honesty · created (zorg-evidenced)CF-005 N11 / N18; S5; green corpus must not silently include broken levels. Tracked: #52.Quarantine paths, CI skip, FINDINGS link. Never promote an NFR on quarantined fixtures. Adoption: #50.
    AGENTSProject playbookMulti-agent chat amnesia and tool-specific drift.First file every session. Producer does not merge (S7).
    GAME_SPECProject playbookCompanion prose drifting from rules.Source of truth. IDs frozen. A companion sentence never overrides it.
    STATUS_LEDGERProject playbookStatus words used as marketing.Proof or Unknown / Planned. Update only your rows.
    FINDINGSProject playbookSame miss twice with only a paragraph.CF + sensor when Recurrence ≥ 2.
    docs/journal/Project playbookNext agent cannot see the last chat.End-of-slice handoff on main.
    docs/adr/Project playbookArchitecture re-litigated every session.Read the decision before changing shape.

    Cross-project fit

    Fit verdicts below are assessments unless a linked issue / work item says otherwise. Other-lane skills are Documented / Simulated, not Live & Probed, and not a STATUS_LEDGER promotion. Do not invent sand-workflow ids.

    ProjectAckNote
    ctosN/ANo skill gap. Docker smoke is a repo script, not a shared Grok skill.
    Café Fausse MRCCOMMENT-onlySkills belong on the Café train. MRC COMMENT. No self-merge on one-issue PRs. New Bot squash-merges Café skill PRs when MRC is CLEAN.
    Café Fausse AppDocumented until probedCites GitLab #434. Grok skill #214 (keep-learning-and-apply). Folds into #205 / PR #215. Shared four via #206. Created #207–#212. Not Live.
    Café Fausse KnowledgeDocumented until probedCites #434 on #213 / matrix PR (+ #203 / #204). Not Live.
    AEA agentDocumented on AEA mainFormal principle GitLab #434 (sponsor reports !513 merged / #434 closed). Matrix vault !512 / AEA #433. Pages Unknown. Shared four referenced (no dup). Not Live.
    logifyDocumented on mainKeep Learning #24 closed; PR #25 merged; cites AEA #434. Skills created: pr-train-parallel-merge #22, tagged-release-cut #23 stay Documented / Simulated. Companion / personas N/A. Not Live.
    3DX LabDocumented until probedIssues #7 honesty, #8 infra-apply, #9 lab-vs-factory, #10 Keep Learning. Skills created: 3dx-lab-honesty, 3dx-lab-infra-apply, 3dx-lab-lab-vs-factory. Draft PR #11 awaiting sponsor merge. This agent got 404 — not a probe. Shared PR-train / companion / personas N/A. Not Live.

    ctos (N/A)

    No shared-skill gap. Docker smoke stays a ctos repo script. Do not add a skill row for it.

    Café Fausse App (Documented until probed)

    App: cafe.artof.link. Knowledge is a separate site. Repo: artofdream/aea-interactive-design. Cites GitLab #434. Grok skill filed #214 (keep-learning-and-apply). Folding into #205: knowledge/skills-matrix.md → skills-matrix.html (PR #215, run bc-b919b061). A merged matrix PR is not a Pages probe. Honesty: Documented until probed. New Bot squash-merges skill PRs when MRC is CLEAN.

    Shared four — adopt by link via #206, no dup.

    SkillScopeWhy? (historical evidence)What (recipe / responsibility)
    pr-train-rebaseShared · adopt #206SES honesty #201 after Stack #199 / #202.Rebase onto latest main. Do not rewrite a peer's rows.
    honesty-ledger-gateShared · adopt #206Newsletter SES probe; no invented Café FR-19.Status words need a probe.
    companion-plain-docsShared · adopt #206 · PartialApp SoT is SRS + freeze.json. Knowledge owns companion.Do not treat App copy as a PLAYER_GUIDE twin.
    persona-journey-validationShared · adopt #206 · PartialDiner book, Café FR-9 409, ROG mobile.Personas → journeys → issues. Not a full ~8yo matrix.
    keep-learning-and-applyCreated / Café App · #214 · Documented until probedCites GitLab #434. Folds into #205.Gap → issue → create/adopt skill → apply on next cut. Not Live.
    freeze-first-generationCreated / Café App · #207Freeze-first MVP + CI freeze sensor.Code follows SRS + freeze.json. No invented IDs. Documented / Simulated, not Live.
    fail-closed-missing-dbCreated / Café App · #208Missing store must not look up.Fail closed if Postgres is missing. Documented / Simulated, not Live.
    probe-before-status-wordsCreated / Café App · #209SES skipped; NFR timings.This-session probe or Unknown. Documented / Simulated, not Live.
    optional-mail-after-storeCreated / Café App · #210#135 / #138 SES; store-only honesty.Store first; fail soft if mail misses. Not a new FR. Documented / Simulated, not Live.
    official-image-allowlistCreated / Café App · #211Official four webps vs extras.Official allowlist only. Documented / Simulated, not Live.
    staging-keep-tear-honestyCreated / Café App · #212Keep-until-scoring / #190.Lock keep/tear the day decided. Documented / Simulated, not Live.

    Café Fausse Knowledge (Documented until probed)

    Companion: knowledge.cafe.artof.link. Does not speak for the App row. Cites GitLab #434 on #213 / the Honesty matrix PR (#203 / PR #216). Pages ratchet: #204. Shared four stay adopt-by-reference (same as #206). Honesty: Documented until probed.

    SkillScopeWhy? (historical evidence)What (recipe / responsibility)
    pr-train-rebaseShared · adopt (no dup)Cascade #108 → #111 → #115 → #116, then #201 after #202.Land in order. Do not rewrite a peer's rows.
    honesty-ledger-gateShared · adopt (no dup)Café Knowledge NFR-1 / NFR-2 gated until A36 stopwatches.Status words need a probe. Do not invent Café FR-19.
    companion-plain-docsShared · adopt (no dup)#191–#199 companion + mobile.Companion + diagrams; formal App/SRS wins if English disagrees.
    persona-journey-validationShared · adopt (no dup) · PartialJ1–J8 + NFR matrix existed.Named personas would have caught Gallery / PIP earlier.
    Keep Learning and ApplyAdopt · #213 / matrix PR · Documented until probedCites GitLab #434 on #213 and the Honesty matrix PR (#203 / PR #216).Learn from CF history → skill/matrix update → next PR. Not Live.
    knowledge-pages-ratchetCreated / Café Knowledge · #204Green deploy is not a content probe (same class as zorg CF-004). Matrix row via #203.One finding → one PR → MRC COMMENT-only → New Bot squash when CLEAN → HTTPS Pages probe before claiming live. Documented / Planned, not Live.

    AEA agent (Documented on AEA main; Pages Unknown)

    Work item: AEA #433 (merged !512). Keep Learning is the stable formal principle AEA #434 (sponsor reports !513 merged and #434 closed). Principle: Documented on AEA main. Knowledge Pages: Unknown until AEA probes. GitLab sign-in from this agent is not a merge probe. Café-specific recipes stay on the Café rows (deferred here). Other-lane skills Documented until probed.

    Shared four — referenced, not duplicated as AEA-created skills: pr-train-rebase, honesty-ledger-gate, companion-plain-docs, persona-journey-validation.

    SkillScopeWhy? (historical evidence)What (recipe / responsibility)
    Shared four (referenced, no dup)Reference only · DocumentedSame four already loaded on zorg-dungeon. #433 points at them.Reuse the shared slugs. Do not create a second AEA copy.
    one-finding-one-mrCreated / AEA · DocumentedNamed on the #433 vault.One finding → one MR. Not Live.
    coordinator-merge-hatsCreated / AEA · DocumentedNamed on the #433 vault.Coordinator hat and merge hat stay distinct. Not Live.
    deploy-schema-honestyCreated / AEA · DocumentedNamed on the #433 vault.Do not claim deploy / schema live without a probe. Not Live.
    committed-vault-memoryCreated / AEA · DocumentedNamed on the #433 vault.Vault memory is the committed file, not chat. Not Live.
    process-coherence-mr-bodyCreated / AEA · DocumentedNamed on the #433 vault.MR body stays coherent with the process. Not Live.

    logify (Documented on main; not Live)

    Repo: artofdream/logify. Keep Learning Documented on logify main: #24 closed; PR #25 merged; cites AEA GitLab #434. Skills created after agree: #22 / #23 stay Documented / Simulated. Companion / personas N/A. Not Live.

    SkillScopeWhy? (historical evidence)What (recipe / responsibility)
    pr-train-parallel-mergeCreated · #22 · Documented / SimulatedAFK tracks #17–#19 CONFLICTING; ADR-0010 collisions, ledger / README churn.Merge order, pre-assign free ADR numbers, rebase remaining PRs. Do not mark NFR Implemented from an agent summary. Not Live.
    tagged-release-cutCreated · #23 · Documented / Simulatedv0.1.0 last-mile ldflags + annotated tag. That release predates the skill.Annotated vX.Y.Z, wait for release.yml assets. Leave Partial NFRs Partial. Not Live.
    companion-plain-docsFit: N/AOut of scope on #23.Do not load this skill for logify work.
    persona-journey-validationFit: N/AOut of scope on #23.Do not load this skill for logify work.

    3DX Lab (Documented until probed)

    Shared pr-train-rebase, companion-plain-docs, and persona-journey-validation are N/A for 3DX. Sponsor-reported issues and created skills below. Draft PR #11 awaits sponsor merge. This agent got 404 on artofdream/3dx-lab — URLs are not independently probed here. Not Live & Probed.

    SkillScopeWhy? (historical evidence)What (recipe / responsibility)
    pr-train-rebaseFit: N/A3DX is not running a zorg-style PR train.Do not load this skill for 3DX work.
    companion-plain-docsFit: N/ANo PLAYER_GUIDE twin on the lab.Do not load this skill for 3DX work.
    persona-journey-validationFit: N/ANo first-timer persona matrix on the lab.Do not load this skill for 3DX work.
    3dx-lab-honestyCreated / 3DX · #7 · Documented until probedSponsor-filed after broadcast clarification.Honesty gate for lab claims. Not Live.
    3dx-lab-infra-applyCreated / 3DX · #8 · Documented until probedSponsor-laptop Terraform apply is lab-specific.Apply infra from the sponsor laptop only as that recipe says. Not Live.
    3dx-lab-lab-vs-factoryCreated / 3DX · #9 · Documented until probedLab must not be treated as the factory path.Keep lab and factory scopes distinct. Not Live.
    Keep Learning and ApplyAdopt · #10 · Documented until probedGap filed; cites AEA #434 on the 3DX train.Write the lesson into the harness before the next loop. Draft PR #11. Not Live.

    Proposed / other-repo (not Live)

    Other-lane skills below are Documented / Simulated until probed — not loaded on zorg-dungeon, not Live & Probed. Café App / Knowledge rows now have issue URLs.

    SkillScopeWhy? (historical evidence)What (recipe / responsibility)
    keep-learning-and-applyDocumented until probed · Café App · #214Cites AEA #434; folds into #205.Other-lane. Not Live.
    freeze-first-generationDocumented / Simulated · Café App · #207Created 2026-09-12.Other-lane. Not Live.
    fail-closed-missing-dbDocumented / Simulated · Café App · #208Created 2026-09-12.Other-lane. Not Live.
    probe-before-status-wordsDocumented / Simulated · Café App · #209Created 2026-09-12.Other-lane. Not Live.
    optional-mail-after-storeDocumented / Simulated · Café App · #210Created 2026-09-12.Other-lane. Not Live.
    official-image-allowlistDocumented / Simulated · Café App · #211Created 2026-09-12.Other-lane. Not Live.
    staging-keep-tear-honestyDocumented / Simulated · Café App · #212Created 2026-09-12.Other-lane. Not Live.
    knowledge-pages-ratchetDocumented / Simulated · Café Knowledge · #204Matrix via #203.Other-lane. Not Live.
    3dx-lab-honestyDocumented until probed · 3DX Lab · #7Created on the 3DX train.Other-lane. Not Live.
    3dx-lab-infra-applyDocumented until probed · 3DX Lab · #8Created on the 3DX train.Other-lane. Not Live.
    3dx-lab-lab-vs-factoryDocumented until probed · 3DX Lab · #9Created on the 3DX train.Other-lane. Not Live.
    one-finding-one-mrDocumented / AEA · #433Created on the AEA vault.Other-lane. Documented until probed. Not Live.
    coordinator-merge-hatsDocumented / AEA · #433Created on the AEA vault.Other-lane. Documented until probed. Not Live.
    deploy-schema-honestyDocumented / AEA · #433Created on the AEA vault.Other-lane. Documented until probed. Not Live.
    committed-vault-memoryDocumented / AEA · #433Created on the AEA vault.Other-lane. Documented until probed. Not Live.
    process-coherence-mr-bodyDocumented / AEA · #433Created on the AEA vault.Other-lane. Documented until probed. Not Live.
    pr-train-parallel-mergeDocumented / logify · #22Created after agree clarification.Other-lane. Documented until probed. Not Live.
    tagged-release-cutDocumented / logify · #23Created after agree clarification.Other-lane. Documented until probed. Not Live.

    Planned (zorg-dungeon)

    Not loaded shared skills. Planned until the recipe is written. corpus-quarantine-honesty moved to created above (#52). Spec-phased slice has no GitHub issue yet (issues: write 403 — paste the body below).

    SkillScopeWhy? (historical evidence)What (recipe / responsibility)
    Kid visual rules / learn pagePlanned · #51Live audit P1 / P6 / P10 / P12 — win condition and room letters unexplained.Companion learn page; GAME_SPEC wins; link from landing How to play. Compose with PR #44.
    Spec-phased engine slicePlanned · issue not filed (403)Phases 0–7 were one-phase PRs. A slice that invented C / Gunner duration / FR-4 would break NFR-8.One GAME_SPEC phase per PR. Only that phase's FR/NFR. Update only your ledger rows. Producer does not merge.

    Paste-ready issue (spec-phased engine slice)

    ## Skill | Scope | Why? | What
    - Skill: Spec-phased engine slice
    - Scope: packages/engine + ledger rows for one GAME_SPEC phase
    - Why? Phases 0–7 shipped as one-phase PRs. Inventing C / Gunner duration / FR-4 breaks NFR-8 / S2–S6.
    - What: One phase per PR. Encode only that phase's FR/NFR. Evidence = tests that cite the IDs. Producer does not merge (S7).
    Status: Planned. Document in docs/SKILL_MATRIX.md.

    How to use this page

    1. Load OOTB for the job (edit / babysit / live audit / save a recipe).

    2. Load the shared Grok sand-workflow that matches the repeating miss.

    3. Read project playbooks on main. If it is not there, it did not happen.

    4. Keep Learning and Apply (GitLab #434 formal, stable): when the build teaches something, write it into the harness before the next loop. Umbrella: historical pain → skill / matrix row / finding sensor. Honesty: Documented; zorg knowledge Pages Probed (2026-09-13). AEA Pages Unknown. Not Live & Probed for game FRs.

    5. Cross-project adopt: AEA matrix !512 (merged, Documented) and principle !513 / #434 (Documented on AEA main; Pages Unknown). Café App cites #434 and filed #214 (keep-learning-and-apply); folds into #205. Café Knowledge cites #434 on #213 / matrix PR. logify #24 / PR #25 Documented on main. 3DX #10 / draft PR #11 Documented until probed. Also zorg #53 — Documented; zorg knowledge Pages Probed (2026-09-13). Café MRC is COMMENT-only. ctos is N/A. Not Live & Probed for game FRs.

    This page does not close FR-4, FR-18, or Gunner duration.