Anvil logoAnvilDokumentasi Prompter
Harga
Menu dokumentasi

Alur Spec-Driven

Tiga tahap yang memaksa setiap perubahan besar melewati review manusia.

Ini bagian Prompter yang paling membedakan. Alih-alih meminta AI langsung menulis kode, Anda memaksanya melewati tiga tahap yang bisa diperiksa manusia. Spec adalah kebenaran; change adalah usulan.

Tiga tahap

Buat proposal

Agent menulis proposal.md (kenapa & apa), tasks.md (checklist), dan spec delta yang menandai requirement mana yang ADDED, MODIFIED, atau REMOVED. Tidak ada kode yang ditulis di tahap ini.

prompter validate <change-id> --strict

Implementasikan

Setelah Anda menyetujui proposal, agent mengerjakan tasks.md secara berurutan dan mencentangnya hanya ketika benar-benar selesai. Gerbang persetujuan ini disengaja.

prompter show <change-id> --json --deltas-only

Arsipkan

Change yang selesai dipindahkan ke changes/archive/ dan spec utama diperbarui dengan delta tadi. Sejak saat itu, spec mencerminkan apa yang benar-benar terbangun.

prompter archive <change-id> --yes

Kapan perlu proposal?

Perlu proposal

  • Fitur atau kapabilitas baru
  • Breaking change pada API atau skema
  • Perubahan arsitektur atau pola
  • Pekerjaan keamanan atau performa besar

Langsung kerjakan

  • Perbaikan bug yang memulihkan perilaku semula
  • Typo, format, atau komentar
  • Update dependensi non-breaking
  • Perubahan konfigurasi

Spec Delta

Proposal tidak menulis ulang seluruh spec. Ia mencatat perubahannya saja lewat empat operasi:

ADDED
Kapabilitas baru yang berdiri sendiri.
MODIFIED
Mengubah perilaku requirement yang ada. Wajib menyalin requirement lama secara utuh, lalu menyuntingnya — kalau tidak, detail lama akan hilang saat diarsipkan.
REMOVED
Fitur yang dihentikan, disertai alasan dan jalur migrasi.
RENAMED
Hanya nama yang berubah, perilakunya tetap.

Format skenario

Setiap requirement wajib punya minimal satu skenario, dan skenario harus memakai empat tanda pagar. Bullet atau teks tebal akan dilewati parser tanpa peringatan.

#### Scenario: OTP required
- **WHEN** valid credentials are provided
- **THEN** an OTP challenge is required

Terakhir diperbarui: 16 Mei 2026