Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Loop engineering

Menjalankan agent dalam sebuah loop, ketika setiap iterasi menambah isi jendela konteks yang tidak ikut membesar. Bagian Contexere adalah melacak apa yang sudah dihabiskan loop-nya dan membawa ingatan melintasi iterasi yang kalau tidak begitu akan direset.

Menyiapkan sebuah loop

export CONTEXERE_LOOP_ID=$(uuidgen)
export CONTEXERE_LOOP_GOAL="Migrate the billing service off the legacy queue"
export CONTEXERE_LOOP_BUDGET=100000
export CONTEXERE_LOOP_ITERATION=0
variabelbatasan
CONTEXERE_LOOP_IDalfanumerik dan tanda hubung, 64 karakter
CONTEXERE_LOOP_GOAL500 karakter, tanpa metakarakter shell
CONTEXERE_LOOP_BUDGETanggaran token per iterasi, sampai 10 juta
CONTEXERE_LOOP_ITERATIONiterasi saat ini, bawaannya 0
CONTEXERE_SUBAGENT=1mode subagent
CONTEXERE_AGENT_IDidentitas, supaya jejaknya tetap bisa dipisah

Anggaran

Anggarannya adalah perkiraan pemakaian jendela konteks per iterasi, bukan batas belanja.

bentuk loopanggaranyang Contexere lakukan
perbaikan cepat, 1 sampai 5 iterasi200.000pelacakan pasif
pengerjaan fitur, 5 sampai 20100.000penyulingan aktif, engram
refactor besar, 20 sampai 10080.000penyulingan agresif, peringatan prediktif
maraton, 100 ke atas60.000kompresi maksimum, ingatan loop yang bertahan

Peringatan menyala di 65% dan kritis di 82%, bisa disetel dengan CONTEXERE_PRESSURE_WARN dan CONTEXERE_PRESSURE_CRITICAL.

Jangan setel anggaran di atas 1 juta: peringatannya tidak akan pernah menyala sebelum kehabisan sungguhan. Jangan setel di bawah 30 ribu: agent-nya akan memadatkan terus-menerus dan kehilangan ingatan jangka pendeknya.

String tujuannya juga menggeser tingkat keagresifan penyulingan. Tujuan yang memuat “test” mempertahankan detail test, “debug” menyimpan konteks galat, “refactor” mengompres lebih keras.

Perkakas yang dipanggil orkestrator

Tidak satu pun dari perkakas ini diiklankan secara bawaan. Contexere hanya memberi tahu host tentang perkakas yang memang dipakai tier-nya, dan perkakas loop berada di luar set itu, jadi orkestrator yang memanggilnya membutuhkan CONTEXERE_MCP_TOOLS=all di environment-nya. contexere doctor menyebutkan set mana yang sedang berlaku. Daftar per tier ada di rujukan perkakas MCP.

perkakaskapan
contexere_loop_statussekali sebelum tiap iterasi, gambaran lengkap termurah
contexere_budget_statussebelum apa pun yang mahal
contexere_set_loop_contextketika tujuan atau cakupannya bergeser di tengah loop
contexere_loop_memorybaca dan tulis ingatan yang selamat dari restart sesi
contexere_verifysebagai pemeriksa, untuk menilai pekerjaan terkini si pembuat

Pembuat dan pemeriksa

Dua agent, satu lapisan konteks bersama.

LOOP_ID=$(uuidgen)

# perkakas loop berada di luar set bawaan yang diiklankan
export CONTEXERE_MCP_TOOLS=all

# pembuat
export CONTEXERE_AGENT_ID=maker CONTEXERE_LOOP_ID=$LOOP_ID
claude "Implement: $GOAL"

# pemeriksa
export CONTEXERE_AGENT_ID=checker CONTEXERE_SUBAGENT=1
RESULT=$(claude "Verify the implementation of: $GOAL. Use the contexere_verify tool.")

case "$RESULT" in
  *PASS*) echo "verification passed" ;;
  *)      echo "checker found issues" ;;
esac

Nilai CONTEXERE_AGENT_ID yang berbeda itulah yang menjaga keduanya tidak saling mengotori. Jejaknya ditandai per agent, jadi contexere_verify bisa membaca lintas sesi sementara penulisannya tetap terisolasi.

Empat hal yang membuatnya bekerja: beri pemeriksanya kriteria yang spesifik dan terukur, jaga last_n_calls antara 5 dan 20, naikkan ke manusia setelah tiga kegagalan pemeriksa berturut-turut, dan ingat bahwa setiap interaksi dicatat sehingga jejak auditnya nyata.

Pemantauan

contexere stats                 # waktu nyata
contexere stats --view detail
contexere stats --json          # untuk dibaca orkestrator
contexere doctor                # kesehatan

contexere handoff bukan subperintah CLI. Ia sudah dihapus. Perkakas MCP contexere_handoff tidak berubah, jadi ekspor sesi bisa dijangkau dari klien MCP, bukan dari shell.

Peringatan soal angkanya

Setiap angka yang dilaporkan sebuah loop dicakup oleh agent_id. Kalau orkestrator dan para agent berbagi satu id, penghematan si pembuat dan si pemeriksa jadi satu angka dan tidak ada yang berarti. Setel id-nya per peran sebelum iterasi pertama, bukan setelah Anda menyadarinya.