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 | Aturan kanonik |
|---|---|---|---|
| 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-bar (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-bar sebelum setiap emisi berlingkup berarti; catat hasil gerbang | src/apothem/rules/pre-emission-gate.md |
| M5 | Prinsip Otoritas | Tanyakan, jangan mengarang; data identitas / lingkup / preferensi / keamanan / penamaan / infrastruktur / penyematan-versi tidak pernah dikarang | 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 dilarang di wilayah otoritatif | src/apothem/rules/option-annotation.md |
| M8 | Kepastian & Kekedapan | Tanpa pengelakan jika preskripsi yang mengikat dimungkinkan; tanpa "bergantung" tanpa cabang yang terenumerasi; setiap kontrak memiliki 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 / Tinjauan / Retrospektif) | src/apothem/rules/agile-sprints.md |
| M12 | Pelaporan Fase & Tata-Letak Kanonik | Pekerjaan multi-fase memancarkan laporan per-subfase + rekapitulasi tingkat-fase; keluaran pada tata-letak kanonik | 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 lint / format / pemeriksaan tipe inang | src/apothem/rules/code-craft-{python,shell,markdown,conventions}.md (per-bahasa) |
| M14 | Sistemisitas 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 ↔ pada 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 bar (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 bar-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 bar baru | tests/conformity-scenarios/ |
| Pembaruan skema hasil gerbang | Blok bars: hasil gerbang memperoleh baris baru; blok hasil gerbang 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 mematerialisasi 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: skema hasil gerbang 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.