Files

T

ankn 78c10d7f61 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

1.8 KiB

Raw Permalink Blame History

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

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.

1.8 KiB Raw Permalink Blame History