9.2 KiB
OpenKKnD — Local / Heavy Session Instruct
Tree: PATH[OpenKKnD] → $HOME/git/src/hacktivism/openkknd
Product: Pitchwell (original RTS greenfield) — not playable Godot openkknd2 (TODO309)
Audience: one local-capable agent session (any host tooling; vision OK when needed)
Updated: 2026-09-14 (harness- and model-agnostic kickoff)
This file is the task SoT for OpenKKnD work. It does not depend on a particular chat product (Grok TUI, Jan, Osaurus UI, …) or on a particular model id. The human picks the runtime/model; the agent follows the rules below.
0. Stop-line (always)
- No Nintendo / C&C brand names; no KKnD assets or rips (IP-FENCE)
- No live/prod login, no host mutation, no other repos without Freigabe this session
- Exception — this repo only: after a successful commit on
hernani/openkknd, alwaysgit pushasopenkknd-agent(see §4) - Kitchen + Bonfire/Lemmy publish freigabe already (STATUS); Castopod live still blocked (404)
- Prefer local inference and zero-cloud automation; do not call paid/cloud frontier APIs unless the human explicitly lifts that for this session
- Do not pull, download, or start additional models this stretch — use whatever is already selected/running; do not overload hosts. Optional orientation only:
$HOME/git/llm/llm-work-logs/grok-work-log-enc/BEST.md(do not re-seed models from it)
1. Session boot (do first)
- Confirm cwd / tree is
$HOME/git/src/hacktivism/openkknd(or resolve viapython3 $HOME/git/llm/llm-configs/bin/path-lookup.py OpenKKnD). - Read in order:
README.md→docs/IP-FENCE.md→kitchen/STATUS.md→kitchen/PLAYBOOK.md→ this file. - Before claiming game/smoke done:
./scripts/smoke/run_all.sh→ expect RUN_ALL PASS.
Sticky facts to keep across turns/compacts: tree path · STATUS=FLAMEWAR-PLATFORM-LOOP · current round · smoke PASS/FAIL · openkknd-agent · work-log tip.
Harness notes (optional, only if that tool exists in the session): local-only / Heavy mode if available; model switch only when the human asks. Ignore slash commands that are not present in your UI.
2. Runtime roles (no fixed model ids)
Do not hard-code model names. Pick by role from whatever the human/session already has loaded:
| Role | When | Constraint |
|---|---|---|
| default / coding | most edits, docs, kitchen drafts | already-running local model |
| shell / git | commits, patches, path lookups | local coder-capable if available; else same as default |
| vision | asset / cinematic QA only | switch only when human asks; amanita / rabbithole Ollama RT if used |
| tiny / smoke probe | short checks | any small local already up |
RT / Ollama runtime states (if used at all): only amanita and rabbithole. Not firecuda, not deltoid for this work.
Kitchen temps (if the stack exposes them): kitchen/LLM.md (talk 1.05 / patch 0.3–0.5).
Operator shortlists and catalog ids (bonsai, Jan, …) live outside this repo (super-sparmodus, host skills). This instruct stays valid if those change.
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 | Prefer local-llm-git-worker.py / session commit helper when available; never push from the commit worker |
| Author | Model commits: GIT_AUTHOR_NAME=local-model/<api-id> · GIT_AUTHOR_EMAIL=local-model+<api-id>@openkknd.agent.local (api-id = runtime model id). Not hernani, not bare openkknd-agent. Author ≠ push-auth |
| Dialect | OpenKKnD: docs:, kitchen:, sim:, flamewar: (§0.27) |
| Remote | ssh://git@git.hacktivism.ch:9200/hernani/openkknd.git (private) |
| Push | Always after successful commit on this repo. No mass multi-tree push. Other repos stay Freigabe-gated. |
| Agent user | Forgejo openkknd-agent — collaborator write on hernani/openkknd only; signed commits via Sequoia/GPG FPR above |
| Agent push how | Prefer HTTPS as agent: token in …/openkknd-agent/access-token.txt (scopes write:repository). No agent SSH key yet (unlike combo-bot). Laptop SSH :9200 currently authenticates as hernani — OK for owner push; for agent identity use HTTPS+token. |
| 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. Parent TODO + what is open
Parent TODO: TODO=356 (openkknd-heavy-flamewar-r12) · REF: REF356-openkknd-heavy-flamewar-r12 · tip k=319 unchanged.
Combo with merchant strings: TODO=355 + TODO=356 (spec …,355,356).
OPEN-2026-09-05-pitchwell-kitchen.md = DONE_CLOSE.
Live kitchen STATUS: FLAMEWAR-PLATFORM-LOOP · stop at ≥12 (read round from disk — do not invent).
Stall locks (2026-09-14):
- After a completed triad for round r, yes bump
STATUS.roundto r on disk before claiming progress. - No new milestones beyond R→≥12 / DONE|GIVE_UP.
- Triad template: ACTIVITY append + outbox
kitchen/outbox/flamewar/*-r{r}-*+ AGENT_LOG line + STATUS update. - Verify
kitchen/STATUS.mdon disk before any round claim.
Useful clusters: flamewar R3→≥12, Castopod draft-only while 404, 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-LOOProunds 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.mdevery turn - Castopod: drafts only while site/API 404
B — Game / docs / IP-FENCE / economy
docs/GAMEPLAY.md,FACTIONS.md,IP-FENCE.mdgame/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 when human enables it
- 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
- 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 session)
- Boot (§1); confirm tree + STATUS
round - Read STATUS/PLAYBOOK; note last live post IDs
- Cluster A or B (startable foundation) — one stretch
- Re-run smoke if B/E touched; fence-clean before publish
- Publish only freigegebene channels; Castopod stays draft
- Append openkknd-work-log-enc entry; STATUS + AGENT_LOG
- End: Freigabe commit if asked; then always push this repo as
openkknd-agent(§4)
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; this-repo push done after commit; no extra models loaded by the agent
10. Model kickoff (paste as first user line)
Harness- and model-agnostic — paste into whatever session is already on a local model:
OpenKKnD local session: read HEAVY-SESSION.md then kitchen/STATUS.md + PLAYBOOK.md. Tree $HOME/git/src/hacktivism/openkknd (Pitchwell; not openkknd2). IP-FENCE. No new model pulls; no other-repo/host mutation without Freigabe. After commit on hernani/openkknd always push as openkknd-agent. Work-log openkknd-work-log-enc. Prefer local tools; no cloud frontier APIs unless human lifts that. Smoke ./scripts/smoke/run_all.sh before claiming game done. Parent TODO=356 (REF356). Continue STATUS FLAMEWAR-PLATFORM-LOOP toward round ≥12 or advance startable sim foundation — pick one cluster and execute. Author=local-model/<api-id>; always push as openkknd-agent.