Fortsetzbare Planung
Wie Apothem den Arbeitszustand in ein projektlokales .apothem/plans/-Set auslagert (mit .plans/ als unterstütztem Abwärtskompatibilitäts-Fallback), damit langlaufende Arbeit Sitzungs-, Konto- und Maschinengrenzen übersteht.
Der größte Teil unterstützter Programmierarbeit lebt und stirbt innerhalb einer einzigen Unterhaltung. Du schließt den Chat, wechselst die Maschine oder meldest dich mit einem anderen Konto an, und der Faden dessen, was du getan hast, ist weg — die nächste Sitzung beginnt kalt, ohne Erinnerung an die Entscheidungen, die du bereits getroffen hast.
Apothem kehrt das um. Für langlaufende, mehrstufige Arbeit lagert es seinen
vollständigen Arbeitszustand in ein projektlokales .apothem/plans/-Set aus (wobei .plans/ als unterstützter Abwärtskompatibilitäts-Fallback erhalten bleibt) —
Dateien, die in deinem Repository liegen, nicht im Verlauf irgendeines
Cloud-Chats. Der Zustand ist das dauerhafte Artefakt; die Sitzung ist
entbehrlich.
Die Kernidee
Ein Plan-Set unter <project-root>/.apothem/plans/{suite}/ trägt zwei Dinge, die eine
Sitzung ersetzbar machen:
- Ein Wiederaufnahmevertrag.
PROGRESS.mdhält die aktuelle Phase und den Aufgabenstatus fest, die präzise nächste Aktion, die geltenden Konventionen, die bereits getroffenen Entscheidungen und die genauen Dateien, die die nächste Sitzung lesen muss. - Ein Kaltstart-Protokoll. Eine frische Sitzung liest diese Dateien in einer festen Reihenfolge und stellt das vollständige Bild wieder her, bevor sie irgendeine Arbeit verrichtet — ohne Unterhaltungsverlauf.
Weil dieser Zustand in den Dateien deines Projekts liegt, nimmt eine frische Sitzung auf jedem Konto oder jeder Maschine, die auf dasselbe Projekt zeigt, die Arbeit an Ort und Stelle wieder auf. Nichts ist in einem einzigen Chat-Transkript eingeschlossen. Das ist die Eigenschaft, die strukturierte, großskalige Arbeit über mehrere Tage — große Korpora, lange Migrationen, große Review-Durchläufe — Grenzen überstehen lässt, die sie sonst beenden würden.
%% verified: 2026-06-21 %%
%% provenance: concepts/resumable-planning.mdx — CLAUDE.md "Operating Loop & Synthesis Posture" + the .apothem/plans/ resumption-contract / blind-bootstrap discipline %%
flowchart TD
accTitle: Zustandsauslagerung der fortsetzbaren Planung von Apothem und Wiederaufnahme beim Kaltstart
accDescr: Der Arbeitszustand wird in ein projektlokales .apothem/plans-Set ausgelagert, das jede spätere Sitzung auf jedem Konto oder jeder Maschine liest, um die Arbeit an Ort und Stelle wieder aufzunehmen.
W["Langlaufende Arbeit in einer Sitzung"] --> EX["Zustand auslagern<br/>in ein projektlokales .apothem/plans/-Set"]
EX --> PR["PROGRESS.md<br/>Wiederaufnahmevertrag + nächste Aktion"]
EX --> NT["PLAN-NOTES.md<br/>getroffene Entscheidungen"]
EX --> PH["phases/NN-topic/<br/>Arbeit und Berichte pro Phase"]
PR --> CS{Sitzung endet<br/>oder wechselt}
NT --> CS
PH --> CS
CS -->|neue Sitzung · jedes Konto · jede Maschine| BB["Kaltstart-Protokoll<br/>Zustand in fester Reihenfolge lesen"]
BB --> RE["Arbeit an Ort und Stelle wieder aufnehmen"]Was es genau ist
Genau formuliert, damit die Garantie klar ist:
- Es ist in Dateien ausgelagerter Zustand plus ein Kaltstart-Wiederaufnahme- Protokoll. Die Arbeit wird wieder aufgenommen, weil der Zustand in den Dateien deines Projekts liegt, unabhängig von jeder Sitzung, jedem Konto und jeder Maschine.
- Es ist kein automatischer konto-übergreifender Synchronisationsdienst. Apothem schiebt deinen Planzustand nicht von sich aus zwischen Konten — die Dateien reisen so, wie die Dateien deines Projekts ohnehin reisen (Versionskontrolle, ein geteilter Checkout, ein synchronisiertes Verzeichnis). Was Apothem garantiert, ist, dass eine frische Sitzung dort, wo die Projektdateien landen, aus ihnen fortsetzen kann.
Warum das wichtig ist
Je länger und größer die Arbeit, desto mehr wird eine einzige Unterhaltung zur Belastung. Eine mehrtägige Überarbeitung oder ein Durchlauf durch eine große Codebasis überdauert jede einzelne Sitzung: Kontextfenster werden verdichtet, Sitzungen laufen ab, Maschinen wechseln. Indem Apothem die Projektdateien selbst als Quelle der Wahrheit für laufende Arbeit behandelt, macht es die Arbeit widerstandsfähig gegenüber allen drei Grenzen: Sitzung, Konto und Maschine.
Wo der Zustand liegt
| Artefakt | Ort | Enthält |
|---|---|---|
| Plan-Set | <project-root>/.apothem/plans/{suite}/ | Eine in sich geschlossene Einheit laufender Arbeit |
| Wiederaufnahmevertrag | <suite>/PROGRESS.md | Phasen-/Aufgabenstatus, nächste Aktion, Konventionen, Manifest kritischer Dateien |
| Entscheidungsregister | <suite>/PLAN-NOTES.md | Getroffene Entscheidungen, nie erneut gefragt |
| Arbeit pro Phase | <suite>/phases/NN-topic/ | Die Aufgaben der Phase und ihr Bericht |
Der Plan-Baum wird durch Apothems kanonisches .gitignore-Snippet von der
Versionskontrolle ausgeschlossen, sodass der Planzustand standardmäßig lokal
bleibt. Um laufende Arbeit bewusst zwischen Maschinen oder Konten zu tragen,
verschiebe das .apothem/plans/-Set genauso, wie du jede andere Projektdatei
verschiebst.
Verwandt
- Ernsthaftigkeitsstufen — wie Governance und die Disziplin der Zustandsauslagerung am Engagement skalieren.
- Die Befehlspipeline — die
/plan-Stufen, die ein Plan-Set erstellen und voranbringen.
Recommended Next Step
Lies Ernsthaftigkeitsstufen, um zu sehen, wie die Auslagerungsdisziplin von einem schnellen Experiment bis zu einer mehrtägigen, grenzüberschreitenden Anstrengung skaliert.
Host-agnostische Haltung
Wie Apothem über das gemeinsame Profil und Harness-Adapter eine host-agnostische Haltung erreicht.
Architektur der delegierten Worker
Wie Apothem eine einzige Fähigkeitskohorte delegierter Worker über siebzehn Harnesses mit divergierenden Hook-Oberflächen und Regelformaten projiziert.