Tulis sekali · agen mana pun, proyek mana pun, mesin mana pun menjalankannya · tidak pernah dipangkas


Agen Anda menggambar peta seluruh sistem Anda. Setiap sesi berikutnya memuatnya.

Playbook adalah prosedur yang ditulis sekali — deploy, eksekusi terjemahan, laporan mingguan — dan dijalankan oleh agen mana pun milik Anda, di proyek mana pun, di mesin mana pun, dengan cara yang sama setiap saat. Catatan meneruskan serah terima dari satu sesi ke sesi berikutnya. Dan atlas adalah apa yang dimungkinkan oleh playbook: peta seluruh sistem Anda, digambar agen Anda dari kode dan sistem yang berjalan, yang dibuka oleh setiap sesi mendatang.

Paket gratis · tanpa kartu kredit · playbook dan catatan di setiap paket

Tulis prosedur sekali saja. Setiap agen menjalankannya.

Playbook adalah markdown biasa: judul untuk setiap tahap, blok terpagar untuk perintah, dan apa yang perlu dibaca kembali setelahnya untuk memastikan berhasil. Ia disimpan untuk seluruh akun Anda, bukan untuk satu proyek — proyek Anda tetap terpisah, prosedur Anda dibagikan. Agen mana pun mengambilnya dan menjalankannya di harness-nya sendiri; memori hanya menyimpannya. Katakan "simpan ini sebagai playbook" dan jadilah sebuah playbook. Katakan "gunakan playbook deploy" dan ia berjalan.

Tidak pernah dipangkas

Catatan terkurasi menyimpan kebenaran saat ini dan dirapikan seiring perubahannya. Playbook menyimpan bagaimana, dan tidak ada yang memangkas prosedur. Resep yang butuh seminggu untuk ditemukan tetap persis seperti saat ditemukan.

Cara yang sama, di mana saja

Lima agen pada satu proyek, atau satu agen pada lima mesin — deploy-nya adalah deploy yang sama. Apa yang Anda pelajari sekali tentang suatu eksekusi diketahui oleh setiap eksekusi berikutnya.

📋

Ditulis seperti saat Anda menyerahkannya kepada rekan kerja

Langkah-langkahnya, perintah persisnya, apa yang perlu diperiksa setelahnya, apa yang salah terakhir kali dan kapan. Agen Anda menambahkan apa yang dipelajarinya saat menjalankannya, dalam sesi yang sama.

Catatan — serah terimanya

Di mana sesi berhenti, apa yang berjalan, apa yang berikutnya — ditulis oleh agen Anda, disimpan per proyek, lima terakhir selalu siap. Sesi berikutnya dibuka dengannya. Nyalakan PC, katakan "continue", dan ia melanjutkan.

Atlas: peta seluruh sistem Anda, yang tetap akurat

Atlas adalah playbook yang mengajarkan agen Anda cara memetakan proyek — dan peta yang digambar sendiri adalah playbook, sehingga setiap sesi dapat membukanya. Satu peta akar per proyek: kotak-kotak, kabel-kabel dan apa yang mengalir di atasnya, penyimpanan, dan indeks lembar. Empat hingga delapan lembar, satu per bidang sistem, dengan prosedur di dalam lembar tempatnya masing-masing. Ditulis oleh agen dari kode dan sistem yang berjalan, tidak pernah dari memori.

Tiga aturan sebuah peta

  • Topologi digambar sekali, di akar. Sebuah lembar tidak pernah menuliskan ulang kabel-kabel; ia hanya membawa detailnya sendiri dan prosedurnya. Duplikasi adalah tempat penyimpangan dimulai, jadi tidak ada duplikasi sejak awal.
  • Nilai tidak berada di mana pun dalam peta. Tidak ada port, batas, harga, atau jumlah — sebuah halaman menyatakan di mana angka itu berada, bukan berapa nilainya. Peta yang membawa nilai akan salah dalam seminggu.
  • Siapa pun yang mengubah sebuah kabel memperbarui peta dalam sesi yang sama. Akar membawa satu baris — terverifikasi <date> terhadap <what> — dan pembaca mempercayai peta sebatas itu saja.

Apa yang disimpan peta akar, secara berurutan

  • Apa itu proyek tersebut, dalam dua kalimat, dan baris yang telah diverifikasi.
  • Diagram tersebut terdiri dari kotak-kotak dan panah-panah; satu panah untuk setiap kabel beserta apa yang mengalir di dalamnya. Arah lebih penting daripada hal lainnya pada halaman tersebut.
  • Kabel-kabel tersebut, diuraikan sebagai berikut: siapa yang memulai prosesnya, apa yang dikirim, dan apa yang tidak pernah dikirim. Inilah bagian yang mengungkap kebohongan.
  • Toko-toko: setiap tempat di mana state berada, apa yang disimpannya, dan apa yang tidak pernah disimpannya.
  • Indeks: setiap pelat dicantumkan berdasarkan namanya, setiap prosedur dicantumkan berdasarkan pelat dan bagiannya.

Apa yang dimuat dalam sebuah pelat

  • Untuk setiap bagian dari bidangnya: apa itu, apa yang disimpannya, dengan apa dan ke arah mana ia berkomunikasi, apa yang tidak pernah dilakukannya, dan apa yang terjadi ketika ia berjalan.
  • Di mana nilai-nilai berada — pointer, bukan nilai itu sendiri.
  • Prosedurnya: perintah-perintah yang tepat, apa yang perlu dibaca untuk mengetahui apakah prosesnya berhasil, serta apa yang sebenarnya salah selama pelaksanaannya, beserta tanggalnya.

Peta akar, dalam bentuk

my-app-map — verified 2026-09-04 against commit a1b2c3d and the live containers

  browser ──(requests, session cookie)──▶ api ──(SQL)──▶ postgres
                                          │
                                          └──(jobs)──▶ worker ──(files)──▶ object store

Wires: the browser never talks to the worker; the worker never reads a cookie.
Stores: postgres (users, orders — never card numbers) · object store (uploads).
Plates: my-app-map-api · my-app-map-worker · my-app-map-data · my-app-map-ops
Procedures: deploy → my-app-map-ops, deploy · restore → my-app-map-data, restore

Tiga kalimat untuk agen Anda

Metode atlas merupakan semacam panduan seperti yang lainnya. Anda hanya perlu memberikannya ke memori Anda sekali saja; setelah itu, setiap proyek dapat dipetakan dengan satu kalimat, dan langkah terakhir peta tersebut memastikan setiap sesi berikutnya mengetahui adanya peta itu.

1 · sekali

Berikan metode ini kepada memori Anda

Salin teks atlas tersebut dan beritahu agen Anda: simpan ini sebagai playbook atlas. Sekarang teks tersebut ada di akun Anda, untuk setiap proyek.

2 · per proyek

Minta peta tersebut dibuat

Dalam proyek tersebut, katakan pada agen Anda: gunakan playbook atlas untuk menulis peta proyek ini. Ia akan membaca kode dan sistem yang sedang berjalan, memverifikasi setiap kabel, lalu menulis peta akar beserta pelat-pelatnya.

3 · diselesaikan oleh metode tersebut

Proyek tersebut mengetahui bahwa ia memiliki peta

Langkah terakhir metode ini menyimpan aturan untuk proyek tersebut: di mana peta itu berada, bacalah sebelum mengubah sebuah kabel, dan perbarui dalam sesi yang sama. Setiap sesi selanjutnya akan dimulai dengan mengetahui bahwa peta itu ada.

Playbook, catatan, dan atlas tersedia dalam setiap paket, termasuk paket gratis. Mulai secara gratis

Dengarkan saat barang dikirim

Rilis terbaru, pengukuran kinerja yang akurat, serta analisis mendalam sesekali. Tanpa spam, batalkan berlangganan dengan satu klik saja

Semua yang Kami Buat

Eksternal: YouTube · GitHub