ViveraEnglish

Template Pendamping

Agen dapat langsung menyusun kerangka artefak terstruktur dengan template siap pakai di templates/. Setiap artefak perencanaan wajib menyertakan setidaknya satu diagram Mermaid yang disematkan (plan tanpa Mermaid dianggap belum lengkap dan memblokir gerbang persetujuan):

  • brainstorm-intent-template.md: Intent Lock Report sebelum plan apa pun ditulis. Template ini mencatat intent pengguna secara verbatim, memetakan task A/B/C/D ke dalam cakupan hasil tafsiran, menyematkan flowchart Mermaid berupa peta cakupan, mendokumentasikan non-goal dan trade-off (membedakan pilihan Human-locked dari Agent-default), serta menegakkan gerbang persetujuan manusia sebelum perencanaan.
  • spec-template.md: Spec desain arsitektural yang ditulis pada langkah 6 brainstorm: masalah dan solusi dari sudut pandang pengguna, daftar user story yang panjang, keputusan implementasi tanpa path file, keputusan pengujian beserta apa yang ditangkap dan dilewatkan oleh setiap seam, istilah glosarium, hal di luar cakupan, dan peta Mermaid. Path file dicantumkan di plan.
  • implementation-plan-template.md: Peta visual Mermaid yang WAJIB (task, dependensi, gate, verifikasi), rincian task, test yang gagal (RED), implementasi (GREEN), dan matriks verifikasi.
  • spike-report-template.md: Alur pengujian hipotesis, eksplorasi hal-hal yang belum diketahui secara epistemik, evaluasi trade-off arsitektural, dan bagian Prototype Location yang menyimpan prototipe di bawah docs/code-plan/spikes/<spike-id>/ sebagai sumber utama.
  • systematic-debugging-log-template.md: Feedback loop Fase 0 yang red-capable, lalu reproduksi dan minimalisasi, hipotesis terurut yang dapat difalsifikasi dengan log debug bertag, perbaikan terkecil dengan regression test pada seam yang tepat, dan pembersihan, ditambah log reproduksi bug.
  • verification-checklist-template.md: Flowchart evidence gate, pemeriksaan sebelum penyelesaian (log test, nol warning, build lolos, kebersihan git).
  • pull-request-template.md: metadata pengiriman, visual terkecil dari perubahan, tabel acceptance criteria ke bukti, verifikasi lokal dengan bukti sebelum dan sesudah, review independen, risiko dan rollback dengan penilaian one-way door atau two-way door, serta utang yang ditunda.
  • pr-review-template.md: target PR remote, catatan state hasil fetch, tabel cakupan, temuan yang ditambatkan ke baris yang berubah pada sumbu Standards dan Spec, kesiapan merge, verdict biner, dan apa yang akan diposting.
  • handoff-template.md: Dokumen handoff sesi. Isi di akhir setiap sesi agar sesi berikutnya bisa melanjutkan tepat dari titik terakhir Anda (state terakhir yang terverifikasi, aksi berikutnya, keputusan yang masih terbuka, blocker).
  • progress-log-template.md: Log state task yang persisten, satu-satunya sumber kebenaran untuk sebuah task lintas banyak sesi (checklist, keputusan, jejak bukti, log sesi).
  • adr-template.md: Architecture Decision Record (ADR): pohon keputusan terstruktur, perbandingan trade-off antaralternatif, dan konsekuensi.
  • subagent-contract-template.md: Kontrak task subagent: pemecahan task (chunking) dan plan fan-out, isolasi cakupan yang ketat, file target yang diizinkan, checkpoint gather & synthesize, dan urutan gate audit diff oleh parent.
  • vault-index-subagent-contract.md: Vault Index Extraction Contract (Lapisan Semantik). Kontrak task subagent untuk membaca catatan dan menghasilkan node concept / atribut ke file chunk terisolasi, dengan asal-usul source_file yang ketat dan validasi chunk-schema.
  • code-review-template.md: Kontrak keluaran reviewer: sumbu Standards dan Spec dijalankan sebagai dua reviewer paralel, urutan prioritas atribusi aturan, filter kualifikasi bug 8 poin, asumsi beban yang dicatat pada setiap review beserta lensa skala (race check-then-write, pertumbuhan tanpa batas, query per item, state per proses) yang diterapkan di bawah filter yang sama, prioritas P0–P3 beserta tingkat keyakinan, aturan kelengkapan dan dedupe, catatan desain yang tidak memblokir berdasarkan baseline dua belas smell, format blok saran, dan verdict biner correct / not correct.
  • deep-research-report-template.md: Laporan riset panjang berbasis sitasi: ringkasan eksekutif, tema ## dengan subbagian ###, sitasi inline [n], notasi LaTeX, dan sintesis penutup.
  • follow-up-injection-template.md: Debt sweep (penyisiran utang) saat sesi ditutup: kandidat utang yang terkumpul, klasifikasi NOW/LATER, set 3-5 follow-up yang terurut, pertanyaan multi-select yang dibundel, catatan eksekusi, dan backlog yang ditunda.
  • session-learning-ledger-template.md: Ledger pembelajaran mandiri yang diisi selama Learning Harvest di Langkah 6. Template ini mencatat kesalahan operasional agen itu sendiri (pemanggilan tool yang keliru, aturan yang salah dibaca, retry membabi buta, tebakan prematur, scope creep), menyaringnya menjadi aturan WHEN → DO → NOT melalui gerbang Minimum-Signal dan 30-Day Horizon, menulis aturan yang dipertahankan secara otomatis ke dalam repo di MEMORY.md, dan mempromosikan aturan yang berulang ke ~/AGENTS.md hanya dengan persetujuan pengguna untuk tiap item. Sesi berikutnya membaca aturan-aturan ini sebelum mulai bekerja.