Registri Konformitas Eksternal — Saat Beroperasi pada Proyek Inang
Registri lima belas mandat (M1–M15) yang menetapkan persyaratan konformitas untuk semua artefak yang dihasilkan di proyek inang, dipetakan-silang dengan mandat internal-ekosistem.
Registri kanonis lima belas mandat produksi. Dokumen ini membawa registri lengkap lima belas mandat (M1–M15), ratifikasi ambang sepele-vs-tak-sepele, kebijakan pemetaan-silang M↔CM, dan protokol pengenalan mandat; enumerasi substantif berada di sini, dioperasionalkan oleh berkas-berkas rule per-mandat.
Ketika ekosistem ini menghasilkan, menyunting, mengerjakan-ulang, menyesuaikan, memperluas, atau menghapus artefak apa pun di proyek inang (target pemanggilan pengguna — repositori git, pohon dokumentasi, korpus penelitian, manifes infrastruktur, papan-coret), setiap artefak yang dihasilkan memenuhi standar lima belas mandat (M1–M15) yang dideklarasikan di bawah. Ini tidak dapat dinegosiasikan dan berlaku untuk setiap permukaan ekosistem (helper, asisten, command, hook, respons, diff, pesan). Penegakan adalah gerbang pra-emisi (lihat site/content/docs/governance/pre-emission-gate-registry.mdx); penegakan fraksi mekanis berada di src/apothem/conformity/*-grep.py, diorkestrasi oleh src/apothem/conformity/gate.py.
Lima belas mandat beroperasi berdampingan dengan mandat CM-N sesuai kebijakan kosakata paralel (lihat site/content/docs/governance/cross-cutting-mandates.mdx); M dan CM adalah dimensi tata kelola yang ortogonal (M adalah sumbu eksternal — artefak proyek inang; CM adalah sumbu internal — artefak internal-ekosistem). Setiap rule yang tercantum di bawah adalah rumah kanonis mandatnya; registri ini adalah indeks.
| ID | Mandat | Ringkasan satu baris | Rule kanonis |
|---|---|---|---|
| M1 | Agnostisisme Proyek-Inang | Temukan stack / formatter / linter / tata-letak / idiom inang; hormati mereka; munculkan keheningan sebagai pertanyaan sesuai M5 dengan anotasi M7 | src/apothem/rules/host-discovery.md |
| M2 | Disiplin Editorial | Ungkapkan setiap amandemen / perluasan / penyempurnaan dengan alasan; tanpa kepatuhan-berlebih yang sunyi, tanpa pelampauan-batas yang sunyi | src/apothem/rules/disclosure-ledger.md |
| M3 | Sepuluh Dimensi Kualitas | Setiap artefak lolos pemeriksaan sepuluh-poin (ketelitian, koherensi, keterkonfigurasian, keterbacaan, keyatiman, struktural, arsitektur, penamaan, perujukan akademis, contoh/tes/dokumen) | src/apothem/rules/ten-dimension-check.md |
| M4 | Penerapan-Diri | Jalankan gerbang pra-emisi lima belas-poin sebelum setiap emisi berlingkup berarti; catat bukti rilis | src/apothem/rules/pre-emission-gate.md |
| M5 | Prinsip Otoritas | Tanyakan, jangan mengarang; data identitas / lingkup / preferensi / keamanan / penamaan / infrastruktur / penyematan-versi tidak pernah dibuat-buat | src/apothem/rules/authority-inquiry.md |
| M6 | Penyertaan Keahlian | Baca maksud, amandemen secara proaktif, perluas pada celah yang berdekatan, sempurnakan dengan alasan terkutip, antisipasi konsekuensi tingkat-kedua | src/apothem/rules/expertise-posture.md |
| M7 | Anotasi Opsi | Setiap pilihan multi-opsi membawa penanda rekomendasi plus alasan yang terhubung-prinsip; pilihan sunyi terlarang di wilayah otoritatif | src/apothem/rules/option-annotation.md |
| M8 | Kepastian & Kekedapan | Tanpa pengelakan di mana resep yang mengikat dimungkinkan; tanpa "tergantung" tanpa cabang yang terenumerasi; setiap kontrak punya kondisi pra / pasca / kegagalan | src/apothem/rules/definitiveness.md |
| M9 | Daya-Ungkit Visual | Materi pokok struktural membawa diagram realitas-saat-ini (Mermaid sebagai bawaan) dengan asal-usul + tanggal verifikasi | src/apothem/rules/visual-leverage.md |
| M10 | Pengikatan Dua-Arah | Elemen struktural substantif mendeklarasikan ikatan timbal-balik (Drives → / Driven by ← / Satisfies → / Established by ↑ / Cross-bound with ↔) | src/apothem/rules/bidirectional-binding.md |
| M11 | Sprint Agile | Pekerjaan multi-langkah tak-sepele berjalan sebagai sprint berdisiplin (Tujuan / Backlog / DoR / DoD / Review / Retrospektif) | src/apothem/rules/agile-sprints.md |
| M12 | Pelaporan Fase & Tata-Letak Kanonis | Pekerjaan multi-fase memancarkan laporan per-subfase + ringkasan tingkat-fase; keluaran pada tata-letak kanonis | src/apothem/rules/canonical-layout.md |
| M13 | Kerajinan Kode | Komentar mengapa-bukan-apa; nama yang mengungkap maksud dengan satuan; penanganan eksepsi bertipe; konstanta bernama; hormati linter / formatter / pemeriksa-tipe inang | src/apothem/rules/code-craft-{python,shell,markdown,conventions}.md (per-bahasa) |
| M14 | Sistemikitas Ekosistem | Komponen baru mendeklarasikan hulu / hilir / sejawat / penegak; terindeks di registri inang; tanpa silo, tanpa yatim yang diperkenalkan | src/apothem/rules/systemic-participation.md |
| M15 | Bentuk Siap-Produksi | Perubahan kode dikirim dengan tes + dokumen + entri CHANGELOG + pesan commit yang patuh + CI hijau dalam set-perubahan yang sama | src/apothem/rules/production-ready-prs.md |
1. Ambang Sepele-vs-Tak-Sepele (terselesaikan)
Ambang yang memisahkan pekerjaan sepele dari yang tak-sepele — pekerjaan tak-sepele memicu aparatus M11 + M12 — adalah hibrida jumlah-baris + lingkup: sebuah perubahan bersifat sepele jika ia adalah suntingan satu-berkas ≤ 5 baris DAN tidak memperkenalkan perubahan permukaan API publik DAN tidak ada pergeseran perilaku. Selain itu bersifat tak-sepele. Diselesaikan sekali sesuai disiplin selesaikan-sekali M5; ambang ini berada di sini pada lingkup pengguna dan hanya ditimpa oleh deklarasi lingkup-proyek eksplisit yang menghormati penemuan-inang M1 (mis. sebuah <project>/.claude/CLAUDE.md untuk Claude Code, atau permukaan per-proyek setara untuk harness lain).
2. Pemetaan-Silang M↔CM
Setiap isi rule bernomor-M mendeklarasikan pemetaan-silang CM-N-nya secara inline (dalam ikatan Cross-bound with ↔-nya) menggunakan kebijakan kosakata paralel: di mana sebuah mandat M memiliki analog CM-N terdekatnya, kedua rule berlaku di mana keduanya berlaku (tanpa substitusi). Pemetaan bersifat intrinsik pada isi rule; registri ini meringkas kebijakan sumbu tanpa menduplikasi tabel pemetaan.
3. Protokol Pengenalan Mandat
Menambahkan mandat bernomor-M baru (mis., M16 di masa depan) adalah perubahan terbundel. Bundel mencapai registri hanya ketika setiap komponen di bawah hadir dalam set-perubahan yang sama. Penambahan sunyi — baris M baru di tabel registri tanpa bundel pendukung — menghasilkan penyimpangan sumbu-mandat dan tidak patuh sesuai partisipasi sistemik M14.
| Komponen yang diperlukan | Tujuan | Tempat berlabuh |
|---|---|---|
| Baris mandat di tabel registri | Menamai mandat, ringkasan satu-barisnya, rule kanonisnya | Tabel registri ini di atas |
| Sel pemetaan-silang CM-N | Mendeklarasikan analog CM-N terdekat (atau menandai (no direct CM-N analog) sebagai sumbu-baru) sesuai kebijakan kosakata paralel §2 | Baris Cross-bound with ↔ rule baru |
| Isi rule kanonis | Spesifikasi substantif mandat (Prakondisi / Perilaku yang diperlukan / Permukaan pengungkapan / Pertanda kegagalan / Ikatan lima-arah) | src/apothem/rules/<mandate-name>.md |
| Baris gerbang pra-emisi | Menamai jenis pemeriksaan bilah (mekanis / bernalar / campuran) dan Failure → action-nya | Tabel registri gerbang pra-emisi (site/content/docs/governance/pre-emission-gate-registry.mdx) |
| Permukaan penegakan | Baik grep mekanis di src/apothem/conformity/<name>-grep.py yang diorkestrasi oleh gate.py, ATAU deklarasi bilah-bernalar eksplisit dengan jangkar pemeriksaan-mandiri operator | src/apothem/conformity/ (mekanis) atau baris gerbang yang ditandai reasoned (pemeriksaan-mandiri operator) |
| Fixture konformitas | Sebuah fixture di bawah tests/conformity-scenarios/fixtures/F-<N>-<name>/ yang menguji mode-kegagalan mandat; daftar-mandat verifikator diperbarui untuk menyertakan bilah baru | tests/conformity-scenarios/ |
| Pembaruan schema bukti-rilis | Blok bars: bukti-rilis memperoleh baris baru; blok bukti-rilis artefak yang ada memperlakukan baris baru sebagai n/a (with reason: pre-mandate-N artifact) hingga diaudit-ulang | site/content/docs/governance/pre-emission-gate-registry.mdx §1 schema |
| Entri buku-besar pengungkapan | Mencatat pengenalan mandat dengan alasan yang berakar pada pendorong konkret (pengulangan pola yang teramati; celah keamanan yang terungkap; kapabilitas yang tidak dicakup lima belas yang ada) | Isi commit set-perubahan atau deskripsi PR sesuai src/apothem/rules/disclosure-ledger.md |
Disiplin penerapan. Sebuah usulan mandat yang tiba tanpa bundel ditolak saat review; pengusul entah melengkapi bundel atau menurunkan usulan menjadi perluasan mandat yang ada. Lima belas mandat yang ada diadopsi bersama sebagai sumbu eksternal spesifikasi; penambahan di masa depan menghormati irama adopsi semua-komponen-atau-tanpa-komponen yang sama alih-alih berlabuh sepotong-sepotong.
Protokol penurunan / pensiun. Ketika suatu M-N yang sudah mapan ditemukan berlebihan dengan CM-N yang ada atau dengan M-N lain (peta cakupan pemetaan-silang di isi rule yang memmaterialisasi menunjukkan kedekatan direct di kedua arah), penurunan adalah kebalikan simetrisnya: baris registri dipensiunkan, baris gerbang dipensiunkan, rule kanonis dipensiunkan (dengan konten dilipat ke dalam rule penyerap sesuai src/apothem/rules/clean-room-generation.md §3 Protokol Penulisan-Ulang), fixture konformitas dipensiunkan, blok bars: schema bukti-rilis menjatuhkan baris, dan set-perubahan dicatat di buku-besar pengungkapan dengan kutipan rule penyerap. Penurunan mempertahankan invarian semua-komponen-atau-tanpa-komponen yang sama.
Registri Pertanyaan Otoritatif — Kategori Wajib
Tujuh kategori pertanyaan wajib dan pengecualian keputusan-otomatis yang mengatur apa yang harus ditanyakan asisten versus apa yang boleh diputuskannya saat beroperasi pada proyek inang.
Kebijakan rekayasa rilis
Lima kebijakan kanonik untuk versioning, penandaan rilis, siklus penghentian, perubahan yang tidak kompatibel, dan prosedur rollback.