Add HANDOFF.md with session state and continuation instructions

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-25 00:12:22 +02:00
parent e08c484838
commit 78c10d7f61
1 changed files with 47 additions and 0 deletions
@@ -0,0 +1,47 @@
+# Handoff — KNIEPUNKT Assistant
+
+## What was built
+A Python CLI assistant (`main.py`) for Dr. André Knie's weekly KNIEPUNKT editorial workflow.
+
+Six steps: **research → source assessment → storyline → draft → quality → publication**
+
+Multi-LLM support (Claude, ChatGPT, Gemini, Mistral) for storyline and draft steps.
+All other steps use Claude only (web search + analytical tasks).
+
+Read `SPEC.md` and `AGENTS.md` — they are the source of truth.
+
+## Current git state
+- **Branch:** `agent/build-kniepunkt-assistant-20260424-75734895`
+- **Base:** `master`
+- **Commit:** `e08c484` — initial build, all files committed and pushed
+- **PR:** not yet opened — open at https://git.d-hive.de/ankn/Kniepunkt targeting `master`
+
+## Remote access
+SSH is broken (`gitssh.d-hive.de:80` is an HTTP reverse proxy; port 22 times out).
+Use HTTPS only. Token is embedded in the remote URL — check with `git remote -v`.
+If token expires: generate a new one at https://git.d-hive.de → Settings → Applications.
+
+## How to run
+```bash
+export PATH="$HOME/.local/bin:$PATH"
+# fill in .env with API keys first
+uv run --env-file .env python main.py
+```
+
+## API keys (.env)
+```
+ANTHROPIC_API_KEY=    # required (also used for web search)
+OPENAI_API_KEY=       # optional — enables ChatGPT in storyline/draft steps
+GOOGLE_API_KEY=       # optional — enables Gemini
+MISTRAL_API_KEY=      # optional — enables Mistral
+```
+Providers with missing or failing keys are silently skipped.
+
+## Episode source material
+34 existing KNIEPUNKT episodes in `KNIEPUNKTe/`.
+First run builds `episodes_cache.json` (cached redundancy index) — this is gitignored and stays local.
+
+## Sessions
+Each weekly run saves state to `sessions/YYYY-MM-DD.json` (gitignored).
+The final publication package is saved to `sessions/YYYY-MM-DD_publikation.md`.
+Interrupted sessions can be resumed on next run.