# OpenKKnD — Heavy / Super-Sparmodus Session Instruct

**Tree:** `PATH[OpenKKnD]` → `$HOME/git/src/OpenKKnD` (macOS: `src/openkknd` same inode)
**Product:** Pitchwell (original RTS greenfield) — **not** playable Godot `openkknd2` (TODO309)
**Audience:** one local-capable session (vision OK) under Heavy / Sparmodus
**Updated:** 2026-09-14 (agent user + work-log + RT/model gates)

---

## 0. Stop-line (always)

- No Nintendo / C&C brand names; no KKnD assets or rips (**IP-FENCE**)
- No `git push`, no live/prod login, no host mutation without **Freigabe this session**
- Kitchen + Bonfire/Lemmy publish freigabe already (STATUS); Castopod live still blocked (404)
- Prefer local / `API_CALLS=NONE` workflows; Heavy = **zero Cloud-Grok**
- **Do not pull/load/run additional local models** this stretch — orient on `PATH[grok-work-log]/BEST.md` only; do not overload hosts

---

## 1. Session boot (do first)

```text
/w super-sparmodus heavy          # or: status / set --profile …
/model <catalog-id>               # slash is /model (/m) — there is NO /models slash
# CLI inventory: grok models
./scripts/smoke/run_all.sh        # expect RUN_ALL PASS before claiming game/smoke done
```

Read in order: `README.md` → `docs/IP-FENCE.md` → `kitchen/STATUS.md` → `kitchen/PLAYBOOK.md` → this file.

Sticky: `COMPACT_KEEP` → `PATH[OpenKKnD]` · `STATUS=FLAMEWAR-PLATFORM-LOOP` · `round` · smoke PASS/FAIL · `openkknd-agent` · work-log tip.

---

## 2. Models + RT hosts (gated)

Heavy shortlist (Super-Sparmodus; snapshot — **switch only when STATUS/session permits**):

| Profile     | Catalog id                 | Host / note           |
|-------------|----------------------------|-----------------------|
| speed       | `jan-gemma4-v2`            | Jan — default text    |
| quality     | `jan-gemma4-opus48`        | Jan                   |
| shell_git   | `08-am-qwen3-coder-latest` | amanita Ollama        |
| foundation  | `24-am-gemma3-4b`          | amanita (tiny+vision) |
| quality_alt | `jan-maral-mythos-9b`      | Jan                   |

**Vision (explicit switch only):**

| Catalog id         | Model        | Host                     |
|--------------------|--------------|--------------------------|
| `10-am-gemma3-12b` | `gemma3:12b` | amanita `:11434`         |
| `07-rh-gemma3-12b` | `gemma3:12b` | rabbithole `:11436`      |
| `24-am-gemma3-4b`  | `gemma3:4b`  | amanita (also foundation)|

**RT / Ollama runtime states:** only on **amanita** and **rabbithole**.  
**Not** firecuda, **not** deltoid (no RT there for this work).

Recommended Heavy vision: `/model 10-am-gemma3-12b` (or `07-rh-gemma3-12b`).  
Shell/patch: `/model 08-am-qwen3-coder-latest`.  
Kitchen temps: `kitchen/LLM.md` (talk **1.05** / patch **0.3–0.5**).

Orient (do not re-seed models from it): `$HOME/git/llm/llm-work-logs/grok-work-log-enc/BEST.md`.

```bash
python3 $HOME/git/llm/llm-configs/bin/super-sparmodus.py set --profile speed|quality
python3 $HOME/git/llm/llm-configs/bin/super-sparmodus.py set --model 10-am-gemma3-12b
```

---

## 3. Work-log (mandatory, own tree)

**SoT:** `$HOME/git/llm/llm-work-logs/openkknd-work-log-enc` (git-crypt `**`; cleartext README/INDEX only).

Schema order (from credit-enc RULES §2): title → Menschenaufwand → Aufgabe → Ergebnis → Guthaben → Statistik → Methodik → Offen.  
Statistik: Git/Dateien, Bytes, Kommandos, Webabrufe, Gesehen, Geschrieben, Git-Geschichte.

Unlock/sign with agent FPR `F3EA2FB493FC3F5E627B4AD6EEBD77CC3686B26A` (also Hernâni).  
Never put secrets in cleartext work-log files.

---

## 4. Git / push / Forgejo agent

| Item | Rule |
|------|------|
| Commit | Must §7 `local-llm-git-worker.py`; `/g` = Freigabe commit-all only; **never push from worker** |
| Dialect | OpenKKnD: `docs:`, `kitchen:`, `sim:`, `flamewar:` (§0.27) |
| Remote | `ssh://git@git.hacktivism.ch:9200/hernani/openkknd.git` (private) |
| Push style | Like `hernani/hernani-korpus`: Freigabe push of **this** repo only; no mass `g-session` / multi-tree push |
| Agent user | Forgejo **`openkknd-agent`** — collaborator **write** on `hernani/openkknd` only; signed commits via Sequoia/GPG FPR above |
| Agent secrets | `$HOME/git/admin-logs/local/koopa-admin-secrets-enc/koopa/home-hernani/koopa-forgejo/agents/` (`users.env` + `openkknd-agent/`) — **never print PW/token** |

Game goal under Freigabe stretches: keep foundation toward a **startable** Pitchwell / KKnD*-style clone (original assets only).

---

## 5. What is open (no dedicated parent TODO)

`OPEN-2026-09-05-pitchwell-kitchen.md` = **DONE_CLOSE**.  
Live kitchen **STATUS:** `FLAMEWAR-PLATFORM-LOOP` · **round 2** · stop at **≥12**.

Useful clusters: flamewar R3→≥12, Castopod blocked notes, outbox drafts, docs/assets hygiene, smoke after game edits, startable sim foundation.

---

## 6. TODO clusters (pick one per stretch)

### A — Kitchen / flamewar / platform loop (default)

- Advance `FLAMEWAR-PLATFORM-LOOP` rounds **3 … ≥12**
- Voices: F1 `@copyleft-crucible`, F2 `@permissive-prickle` (+ kitchen P* per PLAYBOOK)
- Append `kitchen/ACTIVITY.md`; draft → `kitchen/outbox/flamewar/`; publish only freigegebene channels
- Update `kitchen/STATUS.md` + `kitchen/AGENT_LOG.md` every turn
- Castopod: drafts only while site/API 404

### B — Game / docs / IP-FENCE / economy

- `docs/GAMEPLAY.md`, `FACTIONS.md`, `IP-FENCE.md`
- `game/sim/` + `scripts/smoke/economy_smoke.py`
- After edits: `./scripts/smoke/run_all.sh` → **RUN_ALL PASS**

### C — Assets / cinematics

- Original / CC only; briefings ≥1280×720; vision model for QA
- No third-party game asset dumps

### D — Outbox publish (Freigabe-gated)

- Bonfire / Lemmy: freigabe kitchen fire — use live URLs from STATUS
- Forgejo drafts in outbox unless Freigabe commit (`/g`)
- Never invent Lemmy/Bonfire URLs

### E — Tooling / smoke / git hygiene

- Keep `scripts/smoke/*` green
- Path resolve: `python3 $HOME/git/llm/llm-configs/bin/path-lookup.py OpenKKnD`
- Work-log entry after meaningful stretches

---

## 7. Suggested work order (one Heavy session)

1. Boot Heavy + `/model` (only if STATUS/session allows; no new model pulls)
2. Read STATUS/PLAYBOOK; note `round` and last live post IDs
3. **Cluster A** or **B** (startable foundation) — one stretch
4. Re-run smoke if B/E touched; fence-clean before publish
5. Publish only freigegebene channels; Castopod stays draft
6. Append **openkknd-work-log-enc** entry; STATUS + AGENT_LOG
7. End: optional `/g` if Freigabe commit; push only with explicit Freigabe (this repo)

---

## 8. Key paths

| Path | Role |
|------|------|
| `kitchen/STATUS.md` | Loop state, round, freigabe, live URLs |
| `kitchen/PLAYBOOK.md` | Channels + play order |
| `kitchen/ACTIVITY.md` | Append-only kitchen voices |
| `kitchen/AGENT_LOG.md` | Turn log |
| `docs/IP-FENCE.md` | Allowed / forbidden |
| `scripts/smoke/run_all.sh` | Headless + fence + economy |
| `$HOME/git/llm/llm-work-logs/openkknd-work-log-enc` | Own work-log (git-crypt) |
| `…/koopa-forgejo/agents/openkknd-agent/` | Agent GPG + token (enc secrets) |

---

## 9. Done when

- Next flamewar round(s) drafted + logged (toward ≥12), **or** Cluster B/C/E with **RUN_ALL PASS** / clearer startable foundation
- STATUS/AGENT_LOG + work-log match reality (no invented live URLs)
- Stop-line held; no push without Freigabe; no extra local models loaded

---

## 10. Model kickoff (paste as first user line)

```text
Heavy OpenKKnD: /w super-sparmodus heavy · /model 10-am-gemma3-12b (or 08-am-qwen3-coder-latest for shell) · RT only amanita|rabbithole · no new local models · work-log openkknd-work-log-enc · agent openkknd-agent on hernani/openkknd · IP-FENCE · Freigabe for push/host · smoke before done · continue STATUS round toward ≥12 or startable sim foundation
```