Positioning

Audiens: evaluator yang memutuskan apakah akan mengadopsi apothem untuk pekerjaan produksi yang digerakkan oleh asisten. Panjang: ~12 menit untuk dibaca dari awal sampai akhir. Dapat dipindai bagian demi bagian. Tujuan: membingkai apa sebenarnya apothem ITU, apa yang BUKAN, dan mengapa jawaban atas "apa yang didistribusikan proyek ini?" secara struktural berbeda dari jawaban yang diberikan kebanyakan proyek perkakas tata kelola.

§1. TesisCopy Anchor Link

apothem adalah tata kelola ratifikasi artefak, dikemas sebagai biner.

Pembingkaian konvensional untuk perkakas asisten adalah penyetelan prompt: sebuah prompt sistem, pemilihan model, strategi jendela konteks, sebuah pustaka kecil slash-command, dan setumpuk folklor prompt engineering. Di bawah pembingkaian itu, titik ungkit operator adalah prosa yang mereka serahkan kepada model. Ketika model berperilaku keliru, pemulihannya adalah menyunting prosa tersebut. Artefak yang didistribusikan proyek adalah kumpulan prompt.

apothem menolak pembingkaian itu.

Titik ungkit sebuah asisten yang beroperasi pada proyek nyata bukanlah prosa yang diserahkan operator kepada model — melainkan artefak yang akan dipancarkan model. Artefak itu akan mendarat di ruang kerja, di-commit, ditinjau, di-merge, di-deploy, dikutip oleh artefak hilir, dan diwarisi oleh kontributor masa depan. Kualitasnya adalah properti yang tidak dapat dibalikkan di hilir, yang tidak dapat diperbaiki prompt secara retroaktif. Menyunting prompt setelah commit yang cacat bentuk mendarat adalah beban bagi operator, bukan pemulihan artefak.

Disiplin yang dikodekan proyek ini adalah inversi: setiap emisi melewati gerbang yang terstruktur, disepakati, dan diperiksa secara mekanis sebelum emisi itu meninggalkan tangan asisten. Gerbang tersebut menegakkan lima belas mandat yang mencakup penemuan host, pengungkapan, sepuluh dimensi kualitas, penerapan pada diri sendiri, higiene otoritas, inkorporasi keahlian, anotasi opsi, kedefinitifan, daya ungkit visual, pengikatan dua arah, perangkat sprint agile, tata letak kanonik, kerajinan kode, partisipasi sistemik, dan kesiapan produksi. Setiap mandat adalah sebuah aturan dengan cakupan path-filter dan isi yang mengoperasionalkan satu kelas kegagalan tertentu. Setiap kegagalan gerbang adalah temuan struktural yang dimunculkan asisten — tidak pernah berupa degradasi yang diam-diam.

Korpus aturan ITULAH produknya. Biner apothem adalah pengemasannya — permukaan distribusi yang membawa korpus ke root user-config setiap operator dan mendaftarkannya sebagai postur operasi asisten. Pengemasan dapat diganti; korpus adalah aset jangka panjang.

Proyek yang mengadopsi apothem tidak mengadopsi sebuah prompt. Proyek itu mengadopsi sebuah rezim tata kelola. Setiap artefak yang dipancarkan asisten di repositori host — kode, pengujian, konfigurasi, skema, dokumentasi, runbook, pesan commit, nama branch — memenuhi lantai lima belas bar yang sama. Titik ungkit operator bergeser dari "apa yang harus saya katakan kepada asisten?" menjadi "mandat mana yang membatasi emisi ini, dan bukti apa yang dituntut gerbang?". Pergeseran ini bersifat struktural, bukan soal gaya.

Dokumen ini membingkai mengapa korpus adalah aset penopang beban, menelusuri lima belas mandat beserta jangkar berkas aturannya, dan memunculkan dua disiplin lintas-bidang (penanganan masukan saluran kanonik dan arsitektur kreatif identitas kognitif) yang mengikat korpus menjadi satu kesatuan yang koheren.

§2. Arsitektur tiga pilarCopy Anchor Link

Korpus bertumpu pada tiga pilar. Setiap pilar adalah permukaan yang dapat dipisahkan dengan spesifikasi kanoniknya sendiri; setiap pilar memperkuat dua pilar lainnya.

Pilar A — Registri mandat (M1–M15 + CM-1..CM-28)Copy Anchor Link

Registri mandat adalah permukaan tata kelola sumbu luar. M1–M15 mengatur setiap artefak yang dihasilkan asisten dalam sebuah proyek host: penemuan host, pengungkapan, sepuluh dimensi kualitas, penerapan pada diri sendiri, otoritas, keahlian, anotasi opsi, kedefinitifan, daya ungkit visual, pengikatan dua arah, sprint agile, tata letak kanonik, kerajinan kode, partisipasi sistemik, dan kesiapan produksi. Registri ini dikanonikkan sebagai registri lima belas mandat dan dioperasionalkan oleh berkas aturan yang dienumerasi di §3 di bawah.

CM-1..CM-28 adalah padanan sumbu dalam — mandat operasional yang mengatur disiplin interaksi asisten (evaluasi kritis, nol asumsi, cari sebelum mengimplementasikan, evaluasi solusi terbaik, kejujuran brutal, kecepatan keputusan, fokus bottleneck-dahulu, produk koheren, dan dua puluh entri lain yang mencakup lokalitas rencana, penatalayanan konteks, orkestrasi pekerjaan terdelegasi, pembuatan berkas besar, dan siklus hidup memori). Sumbu dalam dikanonikkan di aturan operational-mandates dan site/content/docs/governance/cross-cutting-mandates.mdx.

Setiap emisi melewati kedua sumbu. Gerbang di src/apothem/rules/pre-emission-gate.md menjalankan lima belas bar mekanis dan bernalar pada setiap emisi dan mencatat blok verifikasi dalam jejak kerja artefak.

Pilar B — Disiplin saluran kanonikCopy Anchor Link

Disiplin saluran kanonik mengikat cara asisten meminta masukan operator. Prompt bentuk bebas dipensiunkan di seluruh ekosistem; setiap pilihan dirutekan melalui saluran inkuiri terstruktur dengan skema anotasi opsi yang terstruktur (rasional + rekomendasi + penunjuk default untuk setiap opsi), taksonomi rekomendasi tertutup, lantai konfirmasi operasi destruktif per berkas, dan sapuan heuristik yang menangkap penyimpangan ke prompt percakapan di setiap permukaan yang diatur. Spesifikasi lengkap berada di src/apothem/rules/interactive-questions.md dengan kedalaman dibawa oleh pendamping path-filter src/apothem/rules/interactive-questions-canonical-shapes.md dan src/apothem/rules/interactive-questions-sweep-matchers.md.

Daya ungkit disiplin ini adalah auditabilitas keputusan. Setiap pilihan yang berasal dari kehendak operator membawa bukti yang dipertimbangkan asisten, rekomendasi yang dikeluarkan asisten, dan alasan yang berlandaskan pendorong konkret. Enam bulan setelah pilihan dibuat, seorang auditor yang membaca buku besar pengungkapan dapat merekonstruksi batas keputusan tanpa merujuk pada ingatan operator.

Pilar C — Taksonomi identitas kognitifCopy Anchor Link

Taksonomi identitas kognitif mengikat cara asisten berpikir. Lima filter kognitif berurutan (Obvious Purge, Domain Exile, Inversion Press, Combinatorial Explosion, Aesthetic Demand) membentuk irama kreatif. Filter pertama dan terakhir berlaku pada setiap keluaran substantif; tiga filter di tengah berlaku pada keputusan yang tidak sepele. Enam teknik ideasi (Historical Saboteur, Constraint Paradox, Living Systems Lens, Second-Order Narrative, Villain Frame, 100-Year Zoom) terpicu oleh sinyal deteksi ketika pendekatan standar telah menghasilkan hasil yang tidak memuaskan. Tujuh sumbu keluasan (Arsitektur, Konkurensi, Performa, Keamanan, Pengujian, Perkakas, Observabilitas) membentuk permukaan kedalaman yang menjadi acuan atestasi setiap keputusan yang tidak sepele. Spesifikasi lengkap berada di src/apothem/rules/cognitive-identity.md dengan kedalaman dibawa oleh pendamping path-filter src/apothem/rules/cognitive-identity-techniques.md.

Daya ungkit taksonomi ini adalah kebaruan struktural. Filter Obvious Purge membuang jawaban ide pertama yang diraih semua orang; Inversion Press menuntut setidaknya satu asumsi yang dibalik bertahan hingga keluaran akhir; Aesthetic Demand menolak bentuk yang fungsional tetapi mudah terlupakan. Hasilnya adalah asisten yang menghasilkan keluaran yang membuat operator berhenti dan membacanya ulang — bukan karena prosanya dihias, melainkan karena pilihan strukturalnya tidak kentara dengan cara yang, setelah terlihat, terasa tak terelakkan.

Bagaimana pilar-pilar saling memperkuatCopy Anchor Link

Ketiga pilar itu saling menopang beban. Registri mandat (Pilar A) mendefinisikan apa yang harus dipenuhi artefak. Disiplin saluran kanonik (Pilar B) mendefinisikan bagaimana masukan operator memasuki permukaan keputusan yang menghasilkan artefak. Taksonomi identitas kognitif (Pilar C) mendefinisikan irama kreatif yang memberi bentuk pada artefak. Menghilangkan salah satu pilar meruntuhkan dua pilar lainnya: registri tanpa saluran kanonik menghasilkan artefak yang ditetapkan default secara diam-diam, tampak konforman tetapi menyembunyikan keputusan struktural; saluran kanonik tanpa kedalaman kognitif menghasilkan keluaran yang dirutekan dengan benar tetapi berbentuk generik; irama kognitif tanpa registri menghasilkan artefak yang elegan secara estetik tetapi gagal berintegrasi dengan proyek host.

§3. Penelusuran registri mandatCopy Anchor Link

Registri lima belas mandat adalah permukaan tata kelola sumbu luar yang kanonik. Setiap subbagian di bawah menyebutkan mandat, cakupan operasionalnya, dan berkas aturan yang membawa spesifikasi kanonik. Setiap berkas aturan difilter jalur ke kelas artefak yang diaturnya dan dimuat sesuai permintaan ke dalam konteks operasi asisten ketika kelas-kelas tersebut disentuh.

M1 — Agnostisisme Proyek Host & Penemuan KonvensiCopy Anchor Link

Cakupan. Apa pun yang dihasilkan asisten dalam sebuah proyek host dibentuk oleh keadaan proyek host itu sendiri — stack, bahasa, framework, toolchain, formatter, linter, kerangka pengujian, generator dokumentasi, strategi branch, konvensi pesan commit, tata letak, penamaan, kebijakan pematokan dependensi. Setiap hal itu ditemukan dari sumber kebenaran otoritatif milik host (manifest, berkas lock, berkas sejenis dari jenis yang sebanding, dokumen konvensi tingkat repositori) dan dihormati. Ketika host tidak menyatakan apa pun mengenai konvensi yang harus diadopsi asisten, ketiadaan pernyataan itu dimunculkan sebagai inkuiri otoritatif berdasarkan M5 — tidak pernah diselesaikan dengan diam-diam memilih default internal.

Spesifikasi kanonik. src/apothem/rules/host-discovery.md (dengan katalog manifest per bahasa di src/apothem/rules/host-discovery-manifests.md).

Mengapa ini penting. Emisi asisten tidak dapat dibedakan dari yang akan ditulis oleh kontributor lama proyek host. Penyimpangan konvensi adalah kegagalan struktural, bukan preferensi gaya.

M2 — Disiplin Editorial & Amandemen yang DiungkapkanCopy Anchor Link

Cakupan. Setiap perubahan dengan cakupan yang berarti membawa buku besar pengungkapan yang eksplisit — apa yang diminta, apa yang diamandemen, apa yang diperluas, apa yang disempurnakan, apa yang ditunda. Kepatuhan berlebihan yang diam-diam ("melakukan persis seperti yang diminta, meskipun salah") dan jangkauan berlebihan yang diam-diam ("memperluas cakupan perubahan tanpa memberi tahu") keduanya adalah kegagalan. Setiap amandemen membawa alasan pada standar ilmiah / teknis (referensi yang dikutip, RFC, dokumentasi vendor, preseden berkas sejenis, pola bernama dari literatur).

Spesifikasi kanonik. src/apothem/rules/disclosure-ledger.md (dengan katalog kelas penanda di src/apothem/rules/disclosure-ledger-markers.md).

Mengapa ini penting. Diff yang diam-diam memperbaiki bug di dekatnya saat mengimplementasikan perubahan yang diminta adalah amandemen yang tidak diungkapkan. Seorang peninjau enam bulan kemudian tidak dapat membedakan perbaikan yang disengaja dari penyimpangan. Buku besar adalah permukaan audit dan pemulihan.

M3 — Sepuluh Dimensi KualitasCopy Anchor Link

Cakupan. Setiap artefak dievaluasi terhadap sepuluh dimensi kualitas sebelum emisi: ketelitian ilmiah, konsistensi / koherensi / integrasi / validitas, kemampuan dikonfigurasi / ketiadaan redundansi / konsolidasi, keterbacaan / intuisi / kebersihan, keyatiman / keusangan, strukturalitas / sistemisitas / keseragaman / kelengkapan menyeluruh, arsitektur, keseragaman penamaan, rujukan ilmiah / teknis, dan contoh / pengujian / docstring / dokumentasi. Satu artefak yang gagal pada beberapa dimensi bersifat multiplikatif, bukan aditif — artefak yang usang DAN yatim DAN penamaannya tidak konsisten DAN tidak terdokumentasi adalah kandidat untuk ditarik, bukan diperbaiki.

Spesifikasi kanonik. src/apothem/rules/ten-dimension-check.md (dengan isi per dimensi di src/apothem/rules/ten-dimension-check-dimensions.md).

Mengapa ini penting. Kualitas dapat diuraikan. Menamai kesepuluh dimensi membuat masing-masing dapat diaudit dan dimunculkan secara terpisah; temuan ambigu "ini tampak lemah" menjadi spesifik "dimensi 5 keusangan: referensi di baris 42 menunjuk ke berkas yang sudah dipindahkan".

M4 — Penerapan pada Diri Sendiri — Gerbang Pra-EmisiCopy Anchor Link

Cakupan. Setiap artefak melewati gerbang pra-emisi lima-belas-bar sebelum emisi. Bar mekanis (M5, M7, M8, M10, M13) membawa matcher yang dapat dieksekusi di src/apothem/conformity/*-grep.py yang diorkestrasi oleh src/apothem/conformity/gate.py. Bar M3, M9, M12, M14 dan M15 sebagian mekanis: matcher yang dapat dieksekusi mencakup satu bagian dari setiap bar dan asisten yang beroperasi mengevaluasi sisanya. Bar bernalar (M1, M2, M4, M6, M11) tidak memiliki matcher dan dievaluasi oleh asisten yang beroperasi serta dicatat dalam blok verifikasi. Bar M4 sendiri memeriksa bahwa blok verifikasi ada dalam jejak kerja artefak. Kegagalan satu bar memblokir emisi; iterasi berlanjut hingga setiap bar lulus.

Spesifikasi kanonik. src/apothem/rules/pre-emission-gate.md (dengan tabel bar lengkap di src/apothem/rules/pre-emission-gate-bars.md).

Mengapa ini penting. Kualitas adalah perhatian pra-emisi, bukan perhatian hilir "pengguna dapat merevisi". Gerbang adalah terjemahan struktural dari keyakinan itu ke dalam penegakan mekanis.

M5 — Prinsip Otoritas (Bertanya, Jangan Mengarang)Copy Anchor Link

Cakupan. Nama, email, handle, hostname, organisasi, tenant, endpoint, kredensial, arah cakupan, pilihan penamaan yang belum ditetapkan host, kebijakan retensi, pematokan versi pada permukaan yang dapat diubah host, keputusan infrastruktur yang belum dideklarasikan pengguna — tidak satu pun dikarang. Masing-masing entah ditemukan dari sumber kebenaran otoritatif di dalam host (separuh penemuan M1) atau ditanyakan kepada pengguna (separuh inkuiri M5) — tidak pernah ditutupi dengan tebakan yang tampak masuk akal.

Spesifikasi kanonik. src/apothem/rules/authority-inquiry.md (dengan katalog tujuh kategori di src/apothem/rules/authority-inquiry-categories.md).

Mengapa ini penting. Identitas, keamanan, arah cakupan, dan penamaan permukaan publik membawa bobot hukum dan audit. Alamat kontak yang ditebak, handle CODEOWNERS yang dikarang, atau endpoint penandatanganan rilis yang direka-reka menimbulkan pembersihan di hilir yang biayanya berorde-orde besaran lebih tinggi daripada biaya inkuiri.

M6 — Inkorporasi KeahlianCopy Anchor Link

Cakupan. Setiap artefak dengan cakupan yang berarti membaca maksud pengguna sebelum teks harfiah, mengamandemen secara proaktif ketika permintaan harfiah akan meninggalkan cacat yang diketahui, memperluas pada celah di dekatnya, menyempurnakan dengan alasan yang dikutip, mengantisipasi konsekuensi orde kedua, mengalibrasi kedalaman sesuai tugas, dan mengimpor pelajaran dari domain yang berdekatan — mengungkapkan setiap amandemen melalui buku besar M2.

Spesifikasi kanonik. src/apothem/rules/expertise-posture.md (dengan tujuh sub-elemen + tangga kalibrasi di src/apothem/rules/expertise-posture-elements.md).

Mengapa ini penting. Keahlian tanpa pengungkapan adalah penimpaan yang diam-diam. Keahlian dengan pengungkapan adalah daya ungkit — operator melihat amandemen, mengevaluasi alasannya, lalu meratifikasi atau membatalkannya. Asisten bertindak sebagai kontributor senior yang penilaiannya dapat diaudit, bukan sebagai pengganti buram bagi maksud operator.

M7 — Disiplin Anotasi OpsiCopy Anchor Link

Cakupan. Setiap pilihan multi-opsi yang dimunculkan asisten — dalam respons prosa, ADR, bagian README, deskripsi PR, dokumen desain, langkah runbook, komentar kode, isi pesan commit, RFC — membawa penanda direkomendasikan yang kanonik pada opsi yang direkomendasikan beserta alasan yang terkait prinsip. Pemilihan diam-diam dan daftar opsi tanpa anotasi dilarang di wilayah otoritatif.

Spesifikasi kanonik. src/apothem/rules/option-annotation.md (dengan bentuk prosa dan dokumen di src/apothem/rules/option-annotation-form.md).

Mengapa ini penting. Setiap kumpulan opsi yang ditulis adalah permukaan audit. Pembaca melihat bukan hanya pilihannya, tetapi juga ruang alternatif, rekomendasi, dan pendorong konkret di baliknya. Disiplin yang sama mengikat invokasi inkuiri terstruktur milik asisten dan prosa yang ditulis ke dalam artefak permanen.

M8 — Kedefinitifan, Kekedapan, dan Keluarga Kebajikan Sistem yang KetatCopy Anchor Link

Cakupan. Setiap pernyataan bersifat definitif (tanpa hedging di mana preskripsi yang mengikat dimungkinkan) dan kedap (tanpa celah dalam domain yang dideklarasikan, tanpa celah aturan di mana pemenuhan harfiah melanggar maksud, tanpa asumsi yang tidak dinyatakan, tanpa hasil imbang presedensi, tanpa fallback yang diam-diam). Daftar kosakata hedging dideteksi secara mekanis di gerbang; setiap kemunculannya dalam prosa preskriptif diselesaikan melalui salah satu dari tiga jalur — dipromosikan menjadi tidak bersyarat dengan kondisi yang disebutkan, diturunkan menjadi bersyarat eksplisit dengan cabang yang dienumerasi, atau dihapus dan pilihannya dirutekan ke permukaan inkuiri.

Spesifikasi kanonik. src/apothem/rules/definitiveness.md (dengan katalog tujuh kebajikan di src/apothem/rules/definitiveness-virtues.md).

Mengapa ini penting. Prosa preskriptif yang penuh hedging menjadi beban bagi setiap pembaca. Pembaca tidak dapat membedakan apakah hedge itu mengakui kondisional yang nyata atau menandakan ketidakpastian penulis. Disiplin ini memaksa penulis menyebutkan kondisinya atau menghapus preskripsinya — pembaca memperoleh pernyataan yang mengikat dengan cara mana pun.

M9 — Daya Ungkit VisualCopy Anchor Link

Cakupan. Ketika pokok bahasannya bersifat struktural — arsitektur, alur kendali, alur data, graf dependensi, mesin keadaan, urutan, pohon keputusan, hierarki, tumpukan presedensi, siklus hidup, matriks izin — artefak membawa diagram di samping prosa. Mermaid adalah default yang direkomendasikan untuk korpus yang berpusat pada Markdown; notasi yang sudah ada di host dihormati sesuai penemuan M1. Setiap diagram membawa provenance, tanggal verifikasi, dan ikatan kembali ke artefak yang diabstraksikannya.

Spesifikasi kanonik. src/apothem/rules/visual-leverage.md.

Mengapa ini penting. Deskripsi arsitektur dua ribu kata tanpa diagram adalah pemanfaatan medium yang kurang secara sistematis dan kegagalan struktural artefak, bukan preferensi gaya. Hubungan spasial tidak terbaca dalam prosa linear; diagram adalah keluaran kelas satu yang setara, bukan dekorasi.

M10 — Pengikatan Dua Arah & Penjalinan Eksekusi FaseCopy Anchor Link

Cakupan. Setiap elemen struktural yang substantif membawa ikatan timbal balik ke sejawatnya dalam notasi lima arah yang kanonik: Drives → / Driven by ← / Satisfies → / Established by ↑ / Cross-bound with ↔. Setiap ikatan yang dideklarasikan dalam satu arah memiliki penunjuk balik timbal balik di ujung lainnya; setengah sisi adalah kegagalan struktural, bukan preferensi estetika. Sebuah reciprocity-grep mekanis di src/apothem/conformity/binding_reciprocity_grep.py menegakkan invarian itu di gerbang.

Spesifikasi kanonik. src/apothem/rules/bidirectional-binding.md.

Mengapa ini penting. Ikatan timbal balik mengubah korpus menjadi graf yang dapat dinavigasi. Baris Cross-bound with ↔ milik aturan mana pun menunjuk ke setiap sejawat yang mengutipnya, dan setiap sejawat yang dikutip menunjuk balik. Refaktor korpus menjadi mekanis — ganti nama sebuah aturan, reciprocity-grep menandai setiap kutipan usang dalam change-set yang sama.

M11 — Sprint Agile & Kendali Proses EmpirisCopy Anchor Link

Cakupan. Pekerjaan multi-langkah yang tidak sepele dijalankan sebagai sprint Agile yang disiplin dengan tujuh elemen kanonik: Sprint Goal (berbentuk luaran, dapat diuji), Sprint Backlog (berbentuk INVEST, diprioritaskan), Definition of Ready (gerbang masuk sprint), Definition of Done (gerbang keluar sprint), Sprint Review (disetujui / ditolak / dibawa ke sprint berikutnya per item), Sprint Retrospective (lanjutkan / hentikan / mulai), Velocity Tracking (sinyal, tidak pernah target). Tiga pilar kendali proses empiris — transparansi, inspeksi, adaptasi — beroperasi sepanjang proses.

Spesifikasi kanonik. src/apothem/rules/agile-sprints.md (dengan isi elemen di src/apothem/rules/agile-sprints-elements.md).

Mengapa ini penting. Diff besar yang mencakup banyak hari tanpa struktur sprint buram bagi peninjauan. Perangkat ini memunculkan setiap inkremen, setiap kriteria penerimaan, setiap penolakan pada saat hal itu terjadi — tidak ditunda ke retrospektif lama setelah keputusan struktural tidak dapat dibalikkan.

M12 — Tingkatan Pelaporan & Tata Letak Kanonik Keluaran yang DihasilkanCopy Anchor Link

Cakupan. Pekerjaan multi-langkah yang tidak sepele menghasilkan pelaporan dua tingkat: laporan per sub-fase pada tingkat kerja dan rangkuman tingkat fase pada tingkat peninjauan yang mengagregasi, bukan menyambung — templat seragam di seluruh sub-fase, metrik teragregasi, pola yang dimunculkan, pemeriksaan mandiri tingkat fase, deklarasi ke luar. Keluaran yang dihasilkan berada di lokasi kanonik yang dapat diprediksi dan ditemukan dari host, dengan provenance dan rujuk silang timbal balik. Keluaran yatim (artefak tanpa konsumen / tanpa entri indeks / tanpa atribusi produsen) adalah kegagalan struktural.

Spesifikasi kanonik. src/apothem/rules/canonical-layout.md (dengan isi tingkatan pelaporan di src/apothem/rules/canonical-layout-reporting-tiers.md).

Mengapa ini penting. Daftar datar report1.md / report2.md di lokasi ad-hoc tidak terbaca enam minggu kemudian. Disiplin dua tingkat ditambah tata letak kanonik host berarti setiap keluaran dapat ditemukan, setiap konsumen disebutkan namanya, setiap produsen dapat diatribusikan.

M13 — Konvensi Kerajinan KodeCopy Anchor Link

Cakupan. Setiap artefak kode memenuhi sebelas sub-elemen: komentar yang menjelaskan mengapa, bukan apa; penamaan yang mengungkapkan maksud; penanganan eksepsi yang spesifik; desain fungsi dan modul dengan kecenderungan tanggung jawab tunggal; level logging yang disengaja; pengujian yang mendeskripsikan perilaku; formatter / linter / type-checker lulus tanpa temuan; kode yang sadar keamanan (tanpa rahasia yang di-hardcode, tanpa injeksi shell, tanpa deserialisasi yang tidak aman); disiplin konkurensi; penghapusan literal numerik yang tidak dijelaskan dengan konstanta bernama; dan cakupan permukaan dokumentasi. Aturan sejenis per bahasa membawa materialisasi yang spesifik untuk bahasa.

Spesifikasi kanonik. src/apothem/rules/code-craft-conventions.md (stub delegasi universal) beserta aturan sejenis per bahasa src/apothem/rules/code-craft-python.md, src/apothem/rules/code-craft-shell.md, dan src/apothem/rules/code-craft-markdown.md.

Mengapa ini penting. Penyimpangan kerajinan kode terakumulasi. Satu penangan eksepsi telanjang menjadi preseden yang dikutip kontributor berikutnya; satu rahasia yang di-hardcode menjadi konvensi yang diterima tim; satu literal yang tidak dijelaskan menjadi selusin. Kesebelas sub-elemen itu menamai kelas kegagalan dan gerbang menegakkannya pada setiap emisi.

M14 — Sistemisitas Ekosistem dalam Proyek HostCopy Anchor Link

Cakupan. Setiap komponen yang baru diperkenalkan mendeklarasikan empat relasi sistemik — upstream (apa yang memicunya), downstream (apa yang mengonsumsinya), peers (saudara dari jenis yang sama), enforcers (gerbang kualitas host yang mengaturnya) — dan menyelaraskan diri dengan konvensi sejawat dalam change-set yang sama. Silo (artefak mandiri yang menyimpang dari konvensi sejawatnya, duplikat dari fungsionalitas yang sudah ada) dan yatim (komponen tanpa konsumen / tanpa entri indeks / tanpa atribusi produsen) adalah kegagalan struktural.

Spesifikasi kanonik. src/apothem/rules/systemic-participation.md (dengan kedalaman operasional di src/apothem/rules/systemic-participation-relations.md).

Mengapa ini penting. Pengujian, dokumen, alur kerja, modul, atau entri konfigurasi baru yang tidak mendeklarasikan tempatnya dalam graf rujukan host tidak terlihat oleh pemeliharaan. Deklarasi empat relasi ditambah pembaruan registri dalam change-set yang sama berarti setiap komponen dapat ditemukan dan dapat diurai kembali sejak commit pertamanya.

M15 — Disiplin Siap Produksi pada Artefak Proyek HostCopy Anchor Link

Cakupan. Setiap perubahan dikirimkan dalam bentuk siap produksi: pengujian + dokumentasi + entri CHANGELOG + pesan commit yang konforman + CI hijau dalam change-set yang sama. Postur rantai pasok dipertahankan (tanpa dependensi yang tidak dipatok, tanpa literal rahasia, tanpa eskalasi izin, tanpa action yang tidak dipatok, tanpa rilis yang tidak ditandatangani di mana penandatanganan diwajibkan). Invarian rekayasa rilis dipertahankan (versioning dihormati, konsistensi tag ke versi, penandatanganan tag di mana diwajibkan). Permukaan proyek modern terisi (skrip instal / pembaruan / uninstal multi-OS yang berpasangan, aset logo, header README modern yang terpusat, bagian instal / pembaruan / uninstal). Metadata kepengarangan setiap commit menyebutkan hanya kontributor manusia — asisten tidak pernah mengatribusikan dirinya atau model bahasa yang mendasarinya ke commit, trailer, branch, tag, atau field pull request mana pun.

Spesifikasi kanonik. src/apothem/rules/production-ready-prs.md (dengan permukaan visibilitas dan spesifikasi permukaan modern di src/apothem/rules/production-ready-prs-surfaces.md).

Mengapa ini penting. "Saya akan menambahkan pengujian di tindak lanjut" tidak pernah terwujud. Disiplin change-set yang sama menutup mode kegagalan yang menghasilkan biaya kumulatif terbesar pada proyek yang berjalan lama: pekerjaan kualitas yang ditunda dan menumpuk menjadi utang teknis sistemik.

§4. Disiplin saluran kanonikCopy Anchor Link

Disiplin saluran kanonik adalah padanan sisi masukan bagi penegakan sisi emisi pada registri mandat. Setiap pilihan yang dimunculkan asisten kepada operator dirutekan melalui saluran inkuiri terstruktur. Prompt percakapan bentuk bebas sebagai masukan utama dilarang; disiplin ini ditegakkan di gerbang oleh tujuh matcher heuristik (H1–H7) yang menyapu setiap permukaan yang diatur dan menandai penyimpangan sebagai temuan gerbang.

Spesifikasi kanonik berada di src/apothem/rules/interactive-questions.md. Aturan pendamping membawa kedalaman: src/apothem/rules/interactive-questions-canonical-shapes.md membawa contoh lengkap, isi skema, taksonomi rekomendasi, fallback harness, kumpulan opsi kanonik untuk operasi destruktif, dan contoh lengkap default-pointer; src/apothem/rules/interactive-questions-sweep-matchers.md membawa katalog matcher H1–H7 dengan invokasi ripgrep yang dapat direproduksi.

Bentuk pertanyaan terstrukturCopy Anchor Link

Setiap invokasi membawa empat field: sebuah question satu kalimat yang diakhiri tanda tanya, sebuah header pendek (maksimal dua belas karakter), sebuah array options berisi dua sampai empat elemen, dan sebuah boolean multiSelect. Setiap opsi membawa sebuah label berisi satu sampai lima kata dan isi description dengan tiga segmen berurutan tetap:

1. rationale — satu kalimat yang menyatakan arti opsi ini dan konsekuensinya yang langsung dan dapat diamati terhadap keadaan ekosistem.
2. recommendation — satu nilai dari taksonomi tertutup: recommended, acceptable, discouraged, atau destructive-no-default. Nilai non-netral membawa klausa alasan yang mengutip setidaknya satu pendorong konkret dari taksonomi tertutup berisi enam kelas: keputusan terkunci, risiko bernama, kendala bernama, postur pertanyaan terbuka, kutipan aturan, dan keadaan ekosistem yang teramati. Frasa dari daftar larangan alasan yang kabur tidak konforman ketika berdiri sebagai satu-satunya pembenaran bagi rekomendasi non-netral.
3. default-pointer — menyebutkan default yang aman beserta alasannya, ATAU secara eksplisit mendeklarasikan no-default: user decision required. Operasi destruktif selalu menggunakan bentuk tanpa default.

Invokasi single-select (multiSelect: false) membawa paling banyak satu opsi dengan postfix label penanda direkomendasikan; invokasi multi-select BOLEH membawa beberapa, dan invokasi tanpa opsi yang direkomendasikan tidak membawa satu pun. Setiap postfix terikat dua arah ke nilai recommendation pada isi. Ketidakcocokan antara postfix label dan nilai pada isi dideteksi oleh matcher H6 sebagai temuan gerbang.

Konfirmasi operasi destruktif per berkasCopy Anchor Link

Setiap operasi destruktif — hapus, ganti nama, pindahkan, timpa tanpa retensi, batalkan modifikasi yang belum di-commit — dirutekan melalui saluran inkuiri terstruktur secara per berkas. Satu invokasi per berkas, setiap kali. multiSelect: true tidak konforman pada invokasi operasi destruktif; kumpulan opsi kanonik pada subbagian operasi destruktif adalah lantainya. Kelelahan konfirmasi adalah biaya yang diterima; penghancuran diam-diam bukan.

Sapuan heuristik — H1 sampai H7Copy Anchor Link

Tujuh matcher mekanis menyapu permukaan inti yang diatur (command, aturan, skill, definisi pekerja terdelegasi, hook, berkas konfigurasi harness, dan CLAUDE.md) untuk dua kelas kegagalan:

• Heuristik bentuk percakapan (H1–H3). H1 menangkap prompt berbentuk imperatif ditambah tanda tanya. H2 menangkap "Please confirm / approve / choose". H3 menangkap "Which of the following / these". Jumlah temuan setiap matcher dibandingkan dengan jumlah zona pengecualian yang terdokumentasi (kutipan diri yang bersifat definisional dan konteks percakapan yang dipertahankan); penyimpangan adalah temuan gerbang.
• Heuristik kepatuhan anotasi (H4–H7). H4 menangkap opsi yang kehilangan salah satu dari tiga segmen isi. H5 menangkap rekomendasi non-netral yang kehilangan kutipan pendorong konkret. H6 menangkap ketidakcocokan antara postfix label dan nilai isi. H7 menangkap invokasi operasi destruktif yang kehilangan lantai no-default secara verbatim.

Sapuan ini dapat direproduksi — setiap matcher membawa invokasi ripgrep yang dapat dijalankan operator mana pun terhadap korpus. Disiplin ini mekanis, bukan interpretatif.

Mengapa bentuk ini, bukan yang lainCopy Anchor Link

Prompt percakapan sebagai masukan utama memiliki tiga mode kegagalan struktural yang ditutup oleh disiplin saluran kanonik:

1. Penghapusan ruang keputusan. Prompt bentuk bebas menyajikan satu tindakan yang diusulkan dan meminta operator meratifikasinya. Alternatif yang dipertimbangkan asisten, bobot relatifnya, dan alasan di balik jalur yang dipilih tidak terlihat. Operator meratifikasi atau menolak tanpa melihat ruang keputusannya.
2. Asimetri bias. Tanpa penanda rekomendasi yang eksplisit beserta alasan berpendorong konkret, preferensi asisten disampaikan melalui nada prosa, pembingkaian, dan urutan — saluran yang tidak dapat dievaluasi operator sebagai bukti. Penanda direkomendasikan beserta pendorong yang dikutip membuat bias itu eksplisit dan dapat diaudit.
3. Peluruhan audit. Enam bulan setelah pilihan dibuat, seorang auditor yang membaca log percakapan melihat pertanyaan dan jawabannya tetapi tidak dapat merekonstruksi batas keputusan. Isi tiga segmen pada invokasi terstruktur adalah bukti tahan lama yang dibaca auditor dalam bentuk yang sama dengan yang dilihat operator pada saat keputusan diambil.

Disiplin ini mengubah setiap pilihan yang berasal dari kehendak operator menjadi artefak keputusan — catatan tentang apa yang ditawarkan, apa yang direkomendasikan, apa yang dipilih, dan mengapa.

§5. Taksonomi identitas kognitifCopy Anchor Link

Taksonomi identitas kognitif adalah spesifikasi arsitektur kreatif milik korpus. Taksonomi ini mengikat cara asisten berpikir sebelum memancarkan, bukan apa yang dipancarkan asisten. Keluaran yang memenuhi setiap mandat tetapi terasa generik — solusi ide pertama yang dieksekusi dengan bersih — tidak konforman pada Filter 1 (Obvious Purge) dan Filter 5 (Aesthetic Demand). Daya ungkit taksonomi ini adalah menghasilkan keluaran yang tidak hanya benar tetapi juga baru secara struktural dengan cara yang, setelah terlihat, terasa tak terelakkan.

Spesifikasi kanonik berada di src/apothem/rules/cognitive-identity.md. Aturan pendamping src/apothem/rules/cognitive-identity-techniques.md membawa isi terperinci: taksonomi tujuh sumbu keluasan, irama lima filter dengan prosa per filter, enam teknik ideasi beserta sinyal deteksinya, standar bahasa (frasa terlarang beserta kualitas yang dituntut), dan lima prinsip filosofis.

Lima filter kognitifCopy Anchor Link

Kelima filter berjalan dalam urutan kanonik. Filter 1 dan 5 berlaku pada setiap keluaran substantif; Filter 2 sampai 4 berlaku pada keputusan yang tidak sepele:

1. Filter 1 — The Obvious Purge. Ide pertama adalah yang diraih semua orang. Buang. Ide pertama adalah titik awal untuk apa yang TIDAK boleh dilakukan. Terpicu pada setiap keluaran substantif.
2. Filter 2 — The Domain Exile. Bingkai ulang masalah melalui domain asing. Bisnis → biologi evolusioner. Pendidikan → infrastruktur perkotaan. Arsitektur perangkat lunak → mekanika pasang surut. Solusi dari domain asing membawa materi genetik kebaruan. Terpicu pada keputusan yang tidak sepele.
3. Filter 3 — The Inversion Press. Balikkan setiap asumsi. Alih-alih menyelesaikan masalah, jadikan masalah itu solusinya. Alih-alih mengurangi gesekan, jadikan gesekan itu senjata. Setidaknya satu asumsi yang dibalik bertahan hingga keluaran akhir sebagai invarian, bukan opsi. Terpicu pada keputusan yang tidak sepele.
4. Filter 4 — The Combinatorial Explosion. Paksakan sintesis antara masalah dan konsep yang jauh. Termodinamika + teori negosiasi. Jaringan mikoriza + desain organisasi. Semakin tidak kentara pasangannya, semakin tinggi hasil kreatifnya. Terpicu pada keputusan yang tidak sepele.
5. Filter 5 — The Aesthetic Demand. Apakah keluaran itu memiliki jiwa? Bentuk? Tekstur? Apakah indah dalam logikanya? Keluaran harus memiliki keanggunan konseptual — terasa tak terelakkan setelah terlihat, meskipun tidak terlihat sebelumnya. Terpicu pada setiap keluaran substantif.

Filter 1 menetapkan lantai (menentang yang kentara); Filter 5 menetapkan langit-langit (menentang yang tidak anggun). Tiga filter di tengah beroperasi sebagai tekanan kreatif pada keputusan yang tidak sepele ketika pendekatan standar telah menghasilkan hasil yang tidak memuaskan.

Enam teknik ideasiCopy Anchor Link

Ketika sebuah masalah menolak pendekatan standar atau menuntut orisinalitas yang tidak dihasilkan kelima filter, enam teknik ideasi terpicu oleh sinyal deteksi:

• The Historical Saboteur — terpicu ketika sebuah masalah telah "diselesaikan" berulang kali dengan hasil tidak memuaskan yang sama. Persenjatai kembali pengetahuan era itu yang terlupakan.
• The Constraint Paradox — terpicu ketika ruang solusi terasa terlalu dibatasi. Tambahkan kendala ekstrem dan rancang solusi yang hanya berfungsi karena kendala itu.
• The Living Systems Lens — terpicu ketika sistem menunjukkan patologi yang tampak organik (loop umpan balik, pemborosan yang melanggengkan dirinya sendiri). Tanyakan: apa yang menghidupinya, apa yang mereproduksinya, apa yang akan mematikannya, tekanan evolusioner apa yang menciptakannya?
• The Second-Order Narrative — terpicu ketika sebuah usulan terasa datar secara teknis namun memicu resistensi sosial. Mulailah dari apa yang diubah usulan itu tentang cara orang berpikir, bukan apa yang dilakukannya.
• The Villain Frame — terpicu ketika sebuah usulan mengakomodasi setiap pemangku kepentingan dan tidak menyenangkan siapa pun. Identifikasi siapa yang akan MEMBENCI ide itu dan rancang secara khusus untuk memperkuat kebencian tersebut.
• The 100-Year Zoom — terpicu ketika seluruh pembingkaian masalah mengandaikan kendala yang kecil kemungkinannya bertahan sepuluh tahun atau lebih. Proyeksikan ke depan; bawa kejernihan masa depan itu kembali.

Setiap teknik menyerang titik buta kognitif yang berbeda. Memilih teknik yang salah menghasilkan derau, bukan wawasan; sinyal deteksi adalah kondisi pemicu, bukan eksperimen pikiran yang opsional.

Tujuh sumbu keluasanCopy Anchor Link

Setiap keputusan yang tidak sepele diatestasi terhadap tujuh sumbu keahlian kanonik:

• Arsitektur — desain sistem, modularitas, pelapisan, batas integrasi.
• Konkurensi — race condition, deadlock, koordinasi async, paralelisme.
• Performa — throughput, latensi, anggaran sumber daya, gerbang kuantitatif.
• Keamanan — authn / authz, penanganan rahasia, permukaan serangan, pengodean defensif.
• Pengujian — cakupan, isolasi, disiplin mocking, penangkapan regresi.
• Perkakas — lint / format / CI / CD / instrumentasi observabilitas.
• Observabilitas — logging, metrik, tracing, alerting, kemudahan debugging.

Setiap emisi menyatakan sumbu mana yang berlaku, mana yang tidak berlaku disertai alasan, dan mana yang dibatasi envelope (sumbu itu berlaku tetapi melampaui envelope keahlian asisten; celahnya diakui dan dirutekan untuk ditutup). Ketujuh sumbu itu membentuk permukaan kedalaman yang menjadi acuan evaluasi sepuluh dimensi kualitas M3; amandemen per sumbu dilacak di <harness-root>/memory/expertise-gap-log.md. Sumbu Performa membawa doktrin path-filter-nya sendiri di src/apothem/rules/performance-discipline.md dengan anggaran per kelas (penangan hook, orkestrator gerbang konformitas, test-suite, spawn pekerja terdelegasi) dan gerbang kuantitatif di src/apothem/benchmarks/.

Standar bahasaCopy Anchor Link

Taksonomi ini melarang daftar kosakata tertutup dalam keluaran substantif: penguat pemasaran, ungkapan pintas yang mengandalkan seruan pada konsensus, dan hedge apa pun yang melunakkan sebuah ide sebelum ide itu mendarat. Kualitas yang dituntut menggantikannya: kespesifikan (ide yang kabur adalah gestur, bukan ide), kejutan (pembaca tidak melihatnya datang), logika internal (koheren menurut ukurannya sendiri), generativitas (menghasilkan ide-ide lanjutan di hilir), dan ketegangan (ide terbaik mengandung kontradiksi yang produktif).

Mengapa taksonomi ini, bukan "jadilah kreatif"Copy Anchor Link

"Jadilah kreatif" adalah instruksi tanpa daya ungkit. Taksonomi identitas kognitif menguraikan kreativitas menjadi permukaan mekanis: filter yang terpicu dalam urutan kanonik, teknik yang terpicu oleh sinyal deteksi, sumbu yang menjadi acuan atestasi keluaran, dan disiplin kosakata yang menangkap jalan pintas yang diambil penulis di bawah tekanan biaya. Taksonomi ini adalah arsitektur kognitif yang dioperasionalkan — setiap keluaran substantif melewati filter tetap dan setiap keputusan yang tidak sepele melewati irama penuh, sebuah catatan yang dapat diaudit operator, bukan sekadar kesan yang diharapkan operator akan dipatuhi asisten.

§6. PenutupCopy Anchor Link

apothem bukanlah biner yang Anda pasang. Biner adalah pengemasan yang mematerialisasikan korpus ke direktori konfigurasi native setiap alat yang didukung — melalui adapter per harness di bawah src/apothem/harnesses/<harness>/ — dan mendaftarkannya sebagai postur operasi asisten. Produknya adalah korpus — lima belas mandat ditambah dua puluh delapan mandat lintas-bidang ditambah disiplin saluran kanonik ditambah taksonomi identitas kognitif — dan berkas aturan di src/apothem/rules/*.md adalah spesifikasi kanoniknya.

Proyek yang mengadopsi apothem mengadopsi rezim tata kelola, bukan prompt. Setiap artefak yang dihasilkan asisten di repositori Anda — kode, pengujian, konfigurasi, skema, dokumentasi, runbook, pesan commit, nama branch — melewati gerbang pra-emisi lima belas bar yang sama, membawa buku besar pengungkapan yang sama, menghormati konvensi hasil penemuan host yang sama, mendeklarasikan ikatan timbal balik yang sama, memenuhi sub-elemen kerajinan kode yang sama, dan dikirimkan dalam bentuk siap produksi yang sama. Titik ungkit operator bergeser dari penyetelan prompt ke ratifikasi artefak.

Untuk mengevaluasi klaim ini secara langsung, bacalah korpusnya. Klon repositori, masuk ke src/apothem/rules/, dan baca berkas aturan dalam urutan apa pun — setiap aturan berdiri sendiri, setiap ikatan bersifat timbal balik, setiap rujuk silang mengarah ke jalur aturan tertentu beserta anchor bagiannya. Seluruh aturan itu bersama-sama menggambarkan asisten yang menulis kode seperti yang akan ditulis kontributor senior di proyek Anda; biner adalah permukaan yang menyampaikannya.

Korpus adalah yang tetap bertahan setelah biner berubah.

gh repo clone ahmed-g-gad/apothem
$EDITOR src/apothem/rules/*.md

Membaca itulah evaluasinya.