Skip to content
Apothem
Konsep

Perencanaan yang dapat dilanjutkan

Bagaimana Apothem mengeksternalisasi status kerja ke sebuah suite .apothem/plans/ lokal proyek (dengan .plans/ sebagai fallback kompatibilitas-mundur yang didukung) sehingga pekerjaan berjalan-lama bertahan melewati batas sesi, akun, dan mesin.

Sebagian besar pekerjaan berbantuan hidup dan mati di dalam satu percakapan. Anda menutup obrolan, berpindah mesin, atau masuk dengan akun lain, dan alur dari apa yang sedang Anda kerjakan pun hilang — sesi berikutnya mulai dingin, tanpa ingatan akan keputusan yang sudah Anda buat.

Apothem membalik hal itu. Untuk pekerjaan berjalan-lama dan bertahap, ia mengeksternalisasi status kerja lengkapnya ke sebuah suite .apothem/plans/ lokal proyek (.plans/ dipertahankan sebagai fallback) — berkas-berkas yang berada di repositori Anda, bukan di dalam riwayat obrolan awan mana pun. Status adalah artefak yang awet; sesi bisa dibuang.

Gagasan inti

Sebuah suite rencana di <project-root>/.apothem/plans/{suite}/ membawa dua hal yang membuat sebuah sesi dapat digantikan:

  • Kontrak pelanjutan. PROGRESS.md mencatat fase dan status tugas saat ini, tindakan berikutnya yang tepat, konvensi yang berlaku, keputusan yang sudah diselesaikan, dan berkas persis yang harus dibaca sesi berikutnya.
  • Protokol mulai-dingin. Sesi baru membaca berkas-berkas itu dalam urutan tetap dan menyusun ulang gambaran penuhnya sebelum melakukan pekerjaan apa pun — tanpa perlu riwayat percakapan.

Karena status itu ada di dalam berkas proyek Anda, sesi baru pada akun atau mesin mana pun yang diarahkan ke proyek yang sama melanjutkan pekerjaan di tempat. Tidak ada yang terkunci di dalam satu transkrip obrolan. Inilah sifat yang membuat pekerjaan terstruktur, berskala besar, dan berhari-hari — korpus besar, migrasi panjang, lintasan tinjauan besar — bertahan melewati batas yang jika tidak demikian akan mengakhirinya.

%% 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: Eksternalisasi status perencanaan yang dapat dilanjutkan Apothem dan pelanjutan pada mulai-dingin
    accDescr: Status kerja dieksternalisasi ke suite .apothem/plans lokal proyek, yang dibaca oleh sesi berikutnya pada akun atau mesin mana pun untuk melanjutkan pekerjaan di tempat.
    W["Pekerjaan berjalan-lama dalam sebuah sesi"] --> EX["Eksternalisasi status<br/>ke suite .apothem/plans/ lokal proyek"]
    EX --> PR["PROGRESS.md<br/>kontrak pelanjutan + tindakan berikutnya"]
    EX --> NT["PLAN-NOTES.md<br/>keputusan yang diselesaikan"]
    EX --> PH["phases/NN-topic/<br/>pekerjaan dan laporan per fase"]
    PR --> CS{Sesi berakhir<br/>atau berpindah}
    NT --> CS
    PH --> CS
    CS -->|sesi baru · akun mana pun · mesin mana pun| BB["Protokol mulai-dingin<br/>baca status dalam urutan tetap"]
    BB --> RE["Lanjutkan pekerjaan di tempat"]

Apa itu, secara tepat

Dinyatakan secara saksama agar jaminannya jelas:

  • Ia adalah status yang dieksternalisasi ke berkas ditambah protokol pelanjutan dari mulai-dingin. Pekerjaan dilanjutkan karena status hidup di dalam berkas proyek Anda, lepas dari sesi, akun, atau mesin mana pun.
  • Ia bukan layanan sinkronisasi antar-akun otomatis. Apothem tidak mendorong status rencana Anda antar-akun dengan sendirinya — berkas berpindah dengan cara yang sama seperti berkas proyek Anda sudah berpindah (kendali versi, sebuah checkout bersama, sebuah direktori tersinkron). Yang dijamin Apothem adalah di mana pun berkas proyek mendarat, sesi baru dapat melanjutkan darinya.

Mengapa ini penting

Semakin panjang dan besar pekerjaannya, semakin satu percakapan menjadi beban. Sebuah perombakan berhari-hari atau sapuan melintasi basis kode yang besar akan bertahan lebih lama daripada sesi mana pun: jendela konteks dipadatkan, sesi kehabisan waktu, mesin berganti. Dengan memperlakukan berkas proyek itu sendiri sebagai sumber kebenaran untuk pekerjaan yang sedang berjalan, Apothem membuat pekerjaan tahan terhadap ketiga batas: sesi, akun, dan mesin.

Di mana status berada

ArtefakLokasiMemuat
Suite rencana<project-root>/.apothem/plans/{suite}/Satu unit mandiri pekerjaan yang sedang berjalan
Kontrak pelanjutan<suite>/PROGRESS.mdStatus fase/tugas, tindakan berikutnya, konvensi, manifes berkas penting
Buku besar keputusan<suite>/PLAN-NOTES.mdKeputusan yang diselesaikan, tidak pernah ditanyakan ulang
Pekerjaan per fase<suite>/phases/NN-topic/Tugas-tugas fase dan laporannya

Pohon rencana diabaikan dari kendali versi oleh cuplikan .gitignore kanonik Apothem, sehingga status rencana tetap lokal secara bawaan. Untuk membawa pekerjaan yang sedang berjalan antar mesin atau akun secara sengaja, pindahkan suite .apothem/plans/ dengan cara yang sama seperti Anda memindahkan berkas proyek lainnya.

Terkait

  • Tingkat keseriusan — bagaimana tata kelola dan disiplin eksternalisasi status menyesuaikan dengan keterlibatan.
  • Saluran perintah — tahapan /plan yang membuat dan memajukan sebuah suite rencana.

Baca Tingkat keseriusan untuk melihat bagaimana disiplin eksternalisasi menyesuaikan dari eksperimen cepat hingga upaya berhari-hari yang melintasi batas.

On this page