kitchen: README + MISSIONS/engine-c keep-drop notes

openkknd2-am-coder/TASK.md

@@ -0,0 +1,72 @@
+# Task
+
+- **started:** 2026-07-22T06:30:56Z
+- **host:** amanita
+- **workdir:** `/home/vx/src/openkknd2-am-coder`
+
+## Brief
+
+# MISSION (immutable — do not renegotiate)
+
+# Mission (immutable) — openkknd2
+
+Build and grow **openkknd2**: an original open-source post-apoc RTS scaffold (genre-inspired only; **not** commercial KKnD).
+
+## Fixed goals
+
+1. Work only under the designated workdir (`openkknd2-am-coder` / `$OPENKKND2_ROOT`).
+2. Keep `./scripts/ci-headless.sh` **GREEN** after meaningful changes.
+3. Advance the milestone ladder: map/units → buildings/economy → faction AI → playable skirmish loop → (later) cinematics.
+4. **Legal:** MIT/original only — never proprietary KKnD assets, rips, or reverse-engineered game files.
+5. Always append `AGENT_LOG.md` and keep `STATUS.md` current.
+
+## Non-goals (do not replace the mission with these)
+
+- Rewriting the project as a different game
+- Asking the user for permission to continue
+- Stopping after planning without code/test changes
+
+This mission text is **law** for all models and all meta rounds.
+
+---
+
+# This round
+
+CONTINUE openkknd2 ONLY under /home/vx/src/openkknd2-am-coder (this workdir).
+
+Headless smoke is GREEN (map + units). You implement the next milestones yourself.
+
+This turn must produce REAL file changes (not just plans):
+1. Add building placement (HQ and/or barracks) with resource cost — new headers/sources if needed
+2. Add a simple faction AI tick (gather / build / train)
+3. Wire into `ok_world_tick` or main smoke
+4. Run `./scripts/ci-headless.sh` and keep it GREEN
+5. Append AGENT_LOG.md + update STATUS.md
+
+Rules: MIT/original only; no proprietary KKnD assets. No empty turns. AUTONOMOUS_STOP only if blocked or verified done.
+Read src/ and include/ first.
+
+---
+
+## Protocol
+- Work thoroughly; no empty turns.
+- Emit ## AUTONOMOUS_STOP only when DONE or truly blocked.
+- If missing *actionable* rules would unlock autonomy (not a rewrite of the mission),
+  append exactly one block:
+
+## NEED_INSTRUCTIONS
+why: <one line>
+need:
+- <concrete rule or checklist item the next rounds should remember>
+
+Do not use NEED_INSTRUCTIONS to change the mission goal.
+
+## Instruction refs
+
+(filled by launcher if any)
+
+## Notes
+
+- Always append to `AGENT_LOG.md` after each chunk.
+- Keep `STATUS.md` current.
+- On finish or hard stop, set STATUS and log `AUTONOMOUS_STOP` / DONE.