Checklist Deployment

Langkah-langkah verifikasi pra-penerbangan sebelum men-deploy ekosistem Apothem ke mesin baru, membagikannya dengan orang lain, atau memperlakukannya sebagai siap-produksi.

1. Validitas YAMLCopy Anchor Link

• Semua berkas aturan terurai tanpa galat YAML — blok frontmatter dibuka dengan ---, ditutup dengan ---, dan tidak memuat konten yatim di luar blok
• Semua berkas pekerja terdelegasi terurai tanpa galat YAML
• Semua berkas perintah terurai tanpa galat YAML
• Semua berkas SKILL.md skill terurai tanpa galat YAML

Verifikasi: python scripts/dev/validate_ecosystem.py mengurai frontmatter setiap artefak dan menandai galat YAML + bidang wajib yang hilang. Untuk deteksi ad hoc item daftar yatim: rg -n "^- " src/apothem/rules/*.md.

2. Kelengkapan frontmatterCopy Anchor Link

Untuk setiap jenis artefak, verifikasi bahwa bidang wajib hadir:

Aturan (src/apothem/rules/*.md)Copy Anchor Link

• name — pengidentifikasi kebab-case yang cocok dengan nama berkas
• description — ringkasan satu kalimat
• alwaysApply — true untuk aturan yang selalu aktif, false untuk aturan terfilter-jalur
• pathFilter — hadir pada setiap aturan: "" untuk aturan yang selalu aktif (alwaysApply: true), daftar glob dipisahkan koma untuk aturan terfilter-jalur (alwaysApply: false)

Aturan tidak memiliki kunci version, updated, scope, atau portability.

Perintah (src/apothem/commands/*.md)Copy Anchor Link

• name — nama perintah kebab-case
• version, updated, description, argument-hint, portability, allowed-tools hadir
• disable-model-invocation hadir dan disengaja (false untuk perintah baca-saja atau penasihat; true hanya ketika menjalankan perintah mengubah keadaan di luar working tree atau bergantung pada operator yang memilih momennya)
• Tidak ada kunci effort: command.schema.json menetapkan additionalProperties: false dan tidak menerimanya

Pekerja terdelegasiCopy Anchor Link

Jalur:

src/apothem/agents/*.md

• name, version, updated, description hadir
• tools — daftar peralatan yang diizinkan dipisahkan koma
• disallowedTools — secara eksplisit mendaftar peralatan yang tidak diizinkan
• maxTurns — disetel (dengan komentar alasan jika > 10)
• permissionMode — TIDAK boleh "bypassPermissions"; biarkan kunci ini tidak disetel, karena postur agnostik tidak menetapkan mode izin sebelumnya
• memory dihilangkan kecuali memori persisten memang disengaja; jika diatur, salah satu dari user, project, local (tidak ada bentuk boolean)

Skill (src/apothem/skills/*/SKILL.md)Copy Anchor Link

• name, version, updated, description, archetype, disable-model-invocation, allowed-tools hadir
• userInvocable dideklarasikan (true/false). Ejaan sumbernya adalah userInvocable; sebuah skill membawa tepat satu dari userInvocable atau user-invocable (ejaan Claude Code).

3. KeamananCopy Anchor Link

• Tidak ada pekerja terdelegasi yang menggunakan permissionMode: "bypassPermissions" — ini melewati konfirmasi interaktif untuk operasi Write/Bash
• Daftar tools pekerja minimal — hanya peralatan yang benar-benar dibutuhkan pekerja
• Pekerja dengan akses Bash punya pembenaran dan memiliki batas maxTurns
• Tidak ada jalur, token, atau rahasia yang di-hardcode di artefak mana pun
• Hook di settings.json memiliki timeout yang wajar (≤ 60 detik) dan tidak menjalankan kode sembarang dari input pengguna

4. Integritas referensi-silangCopy Anchor Link

• Setiap aturan yang terdaftar di tabel src/apothem/rules/ ada di disk pada jalur yang dinyatakan
• Setiap perintah yang terdaftar di tabel src/apothem/commands/ ada di disk
• Setiap pekerja terdelegasi yang terdaftar di tabel registri src/apothem/agents/ ada di disk
• Setiap skill yang terdaftar di tabel src/apothem/skills/ ada di disk
• Setiap hook di tabel src/apothem/hooks/ memiliki entri yang sesuai di settings.json
• Semua berkas src/apothem/rules/*.md ada dan referensi-silang Bindings miliknya dapat di-resolve

5. Cakupan mandatCopy Anchor Link

• Setiap mandat CM-N memiliki lokasi penegakan (entah berkas aturan atau definisi inline eksplisit)
• Tidak ada berkas aturan yang bertentangan dengan yang lain (khususnya seputar penskalaan keseriusan)
• Delineasi tiga-faset CM-21 dihormati — tidak ada aturan yang mengklaim kepemilikan faset CM-21 aturan lain

6. Uji asap fungsionalCopy Anchor Link

Jalankan permukaan validasi Python terlebih dahulu — cepat, offline, dan menangkap regresi struktural:

• pytest tests — uji unit untuk runtime hook, semua hijau
• python scripts/dev/validate_hooks.py — struktur hook + pemeriksaan kebersihan khusus-Python lulus
• python scripts/dev/validate_ecosystem.py — pohon penuh + frontmatter + pemeriksaan hook terdelegasi lulus
• python scripts/dev/chaos_pass.py — setiap perintah hook yang dikonfigurasi mengembalikan amplop JSON yang valid di bawah input yang terdegradasi

Lalu skenario langsung:

• /plan-spec <sample-file> — menyelesaikan ingest/klarifikasi tanpa galat tingkat-perintah
• /plan-generate --dry-run — menghasilkan pratinjau struktur tanpa menulis berkas
• /plan-status pada suite rencana yang lengkap — mengembalikan jumlah fase yang akurat
• Pengiriman pekerja terdelegasi: pekerja codebase-explorer yang dipanggil dengan cakupan kecil selesai dalam maxTurns dan mengembalikan keluaran terstruktur

7. Kekinian dokumentasiCopy Anchor Link

• CHANGELOG.md (di akar ekosistem) mencerminkan setiap perubahan artefak sejak rilis terakhir; bagian rilis berikutnya diisi sebelum tag mendarat, atau setiap perubahan sudah dipotong ke bagian yang telah dirilis
• site/content/docs/developer-guide.mdx secara akurat mendeskripsikan struktur artefak saat ini
• site/content/docs/reference/artifact-schema.mdx cocok dengan bidang frontmatter yang benar-benar hadir di artefak
• site/content/docs/reference/settings-reference.mdx cocok dengan konfigurasi hook aktual di settings.json
• README.md konsisten dengan pohon di disk

8. Portabilitas (jika dibagikan dengan orang lain)Copy Anchor Link

• Semua jalur dalam perintah hook agnostik-lingkungan atau menggunakan ekspansi ~
• Perintah hook menggunakan bentuk exec dan menghindari string perintah spesifik-shell
• Tidak ada jalur C:\Users\username atau /home/username yang di-hardcode di artefak mana pun
• settings.json menggunakan satu tabel cakupan peristiwa hook dan jalur modul pengiriman kanonis

9. Penyelarasan versiCopy Anchor Link

• version CLAUDE.md adalah yang tertinggi dari artefak mana pun di pohon (atau sama dengan versi artefak yang paling baru di-bump, menurut konvensi)
• version setiap artefak cocok dengan semver yang dinyatakan (MAJOR.MINOR.PATCH)
• CHANGELOG.md memuat persis entri rilis untuk versi target sebelum tagging
• Bidang updated setiap artefak berada pada-atau-setelah tanggal pengeditan terakhirnya yang mengubah perilaku
• Tidak ada artefak yang membawa version lebih rendah dari versi saat terakhir disentuh (tanpa regresi)
• src/apothem/skills/plan-suite/SKILL.md dan src/apothem/skills/plan-suite/master-template.md disematkan ke garis versi template yang sama

PersetujuanCopy Anchor Link

Deployment disetujui oleh: ___________________ Tanggal: ___________________ Versi ekosistem yang di-deploy: ___________________