Registri Artefak

Registri kanonis kohort artefak. Dokumen ini membawa enumerasi lengkap command, rule, pembantu terdelegasi, hook, skill, output style, disiplin evolusi-artefak, dan deklarasi kelas-artefak-kosong; tabel substantifnya hidup di sini. Tata letak sumber proyek menyediakan tampilan always-on yang dipadatkan.

1. Command

Tiga puluh command terdaftar dari src/apothem/commands/*.md (non-rekursif). Setiap command adalah berkas terdaftar kelas-satu; orkestrator /plan hanya merangkai stage plan yang sudah kelas-satu dan tidak membawa logika stage miliknya sendiri, jadi tetap tidak ada dispatcher monolitik dan tidak ada pengelompokan subcommand. Command non-plan, non-workflow:

Command pipeline-plan

Pipeline plan dikirimkan sebagai delapan command kelas-satu — satu per stage, masing-masing dapat diinvokasi langsung sebagai /plan-<stage> dari berkas terdaftarnya sendiri di src/apothem/commands/plan-<stage>.md.

Command alur-kerja-operator & orkestrator

Tiga command memasuki suatu prosedur mendalam alih-alih membawa logika stage miliknya sendiri: dua titik-masuk alur-kerja-operator (masing-masing didukung oleh skill saudara dengan nama yang sama) ditambah orkestrator pipeline-plan yang tipis.

2. Rule

Rule perilaku hidup di bawah src/apothem/rules/ — inti always-on yang kecil ditambah himpunan ter-filter-jalur yang lebih besar (dimuat-sesuai-kebutuhan saat sentuhan artefak yang cocok). Enumerasi per-rule lengkap — dengan kolom Scope (always-on / ter-filter-jalur) dan Implements — adalah reference/rules.mdx yang dihasilkan-dari-sumber, disegarkan dari src/apothem/rules/*.md oleh generator reference-inventory; konsultasikan untuk daftar terkini yang otoritatif.

Delineasi facet CM-21 (tiga rule co-mengimplementasikan CM-21 dengan facet berbeda non-tumpang-tindih): filter kreatif & identitas kognitif → cognitive-identity.md; metodologi generasi (protokol penulisan & penulisan-ulang) → clean-room-generation.md; teknik perencanaan/tinjauan → planning-techniques.md. Setiap rule memiliki facet-nya; yang lain merujuk keluar.

Pointer skema interactive-questions. Skema invokasi inkuiri-terstruktur kanonis — field yang diperlukan, tabel ringkasan-field, dua contoh kerja yang dapat dieksekusi (single-select di §2.1 dan multi-select di §2.2) — hidup di src/apothem/rules/interactive-questions.md §2 "Structured-Inquiry Shape". Artefak hilir boleh menyalin §2.1 atau §2.2 sebagai template invokasi; skema anotasi-opsi tiga-segmen yang dibawa setiap body description opsi dispesifikasikan di §3 berkas yang sama.

3. Pembantu Terdelegasi

Dua belas definisi pekerja persisten dikirimkan bersama ekosistem; pola tim rule orkestrasi mendispatch kepadanya. Setiap definisi hidup di jalur berkas yang tercantum di bawah.

Pembantu             Berkas                                     Pola            Kebijakan Model
------------------- ------------------------------------------ --------------- -------------
Codebase Explorer   src/apothem/agents/codebase-explorer.md   Research        dipilih-host
Convention Auditor  src/apothem/agents/convention-auditor.md  Audit           dipilih-host
Dependency Auditor  src/apothem/agents/dependency-auditor.md  Audit           dipilih-host
Fact Checker        src/apothem/agents/fact-checker.md        Audit           dipilih-host
MCP Builder         src/apothem/agents/mcp-builder.md         Generation      dipilih-host
Memory Auditor      src/apothem/agents/memory-auditor.md      Audit           dipilih-host
Prompt Evaluator    src/apothem/agents/prompt-evaluator.md    Quality         dipilih-host
Quality Gate        src/apothem/agents/quality-gate.md        Quality         dipilih-host
Refactor Surgeon    src/apothem/agents/refactor-surgeon.md    Implementation  dipilih-host
Research Scout      src/apothem/agents/research-scout.md      Research        dipilih-host
Security Scanner    src/apothem/agents/security-scanner.md    Audit           dipilih-host
Test Runner         src/apothem/agents/test-runner.md         Quality         dipilih-host

4. Hook

Setiap command hook terdaftar menggunakan bentuk command exec-form Claude Code (command: "python" ditambah array args) dan menginvokasi entah -m apothem.hooks.dispatch atau -m apothem.conformity.gate. Dispatcher mengimpor src/apothem/hooks/lib/resolve_root.py untuk resolusi root-ekosistem dan mendelegasikan ke dua helper yang berada di sampingnya di bawah src/apothem/hooks/ itu sendiri: src/apothem/hooks/emit_hook_context.py memformat payload event untuk asisten, dan src/apothem/hooks/session_start_bootstrap.py membawa kerja persiapan SessionStart yang dilimpahkan dispatcher saat ia merutekan event itu. Pesan hook yang dimunculkan ke asisten saat event yang didukung terpicu hidup sebagai berkas konteks Markdown di bawah src/apothem/hooks/messages/ — satu per varian event: postcompact.md, precompact.md, pretooluse-bash.md, pretooluse-bash-plan-guard.md, pretooluse-conformity.md, pretooluse-dependency-guard.md, pretooluse-edit.md, pretooluse-edit-header-guard.md, pretooluse-eval-guard.md, pretooluse-notebookedit.md, pretooluse-write.md, pretooluse-write-header-guard.md, pretooluse-write-plan-guard.md, sessionstart.md, stop.md. Setiap berkas konteks yang dirutekan dimuat oleh dispatcher saat event-nya terpicu dan argumen konteksnya terdaftar di settings.json; tiga berkas konteks (pretooluse-conformity.md, pretooluse-dependency-guard.md, pretooluse-eval-guard.md) dikirim sebagai varian tersedia tanpa entri perutean settings.json saat ini.

Event             Mengotomatiskan          Timeout  Tujuan
----------------- ------------------------ -------- --------------------------------------------------
SessionStart      CM-14                    30s      Baca memori, periksa state plan, laporkan kesiapan
PreCompact        CM-24 §2.3               30s      Verifikasi state ter-eksternalisasi sebelum kompaksi
PostCompact       CM-24 §6.2               30s      Pulihkan working state setelah kompaksi
Stop              CM-14/CM-22/CM-24/CM-26  60s      Eksternalisasi akhir-sesi
PreToolUse        CM-7/CM-22               10s      Validasi Write/Edit/NotebookEdit — pemeriksaan isolasi-codebase, frontmatter, lisensi-header, dan lokalitas-plan plus gerbang konformitas. Validasi Bash — isolasi artefak git dan lokalitas-plan
PostToolUse       —                        10s      Diterima oleh whitelist src/apothem/hooks/dispatch.py untuk kompatibilitas-maju; tidak ada entri settings.json yang saat ini merutekan event ini
UserPromptSubmit  —                        10s      Diterima oleh whitelist src/apothem/hooks/dispatch.py untuk kompatibilitas-maju; tidak ada entri settings.json yang saat ini merutekan event ini
Notification      —                        10s      Diterima oleh whitelist src/apothem/hooks/dispatch.py untuk kompatibilitas-maju; tidak ada entri settings.json yang saat ini merutekan event ini

Konvensi. Baris di mana Mengotomatiskan adalah — diterima oleh dispatch.py tetapi tidak terhubung di settings.json; kolom Timeout menampilkan default tingkat-dispatch yang berlaku jika dan ketika event itu kemudian dihubungkan.

Blok kanonis nilai-timeout. Kolom Timeout tabel ini adalah satu-satunya sumber kebenaran untuk nilai timeout hook di seluruh ekosistem. Field timeout per-hook settings.json, tabel cermin di site/content/docs/reference/settings-reference.mdx § Hook Events dan site/content/docs/reference/artifact-schema.mdx § Hooks Pipeline, dan panduan rule di src/apothem/rules/persistent-conventions-vigilance.md § Convention Awareness semuanya berasal dari kolom ini. Revisi timeout di masa depan mendarat di sini dan konsumen menderivasi-ulang pada reference berikutnya.

Kadensi Tinjauan Template Settings

settings.json adalah satu-satunya template Claude Code. Setiap command hook menggunakan exec form alih-alih wrapper spesifik-shell, jadi perilaku lintas-OS ditinjau di dalam satu berkas alih-alih dengan men-diff template berpasangan. Entri permission baru, event hook, timeout, dan pesan status mendarat di berkas itu secara atomik.

5. Skill

Skill yang dapat digunakan-ulang hidup di bawah src/apothem/skills/, satu folder per skill.

Konvensi. Jalur setiap baris adalah sebuah folder; titik masuknya adalah berkas SKILL.md di dalamnya — mis. src/apothem/skills/plan-suite/SKILL.md — per konvensi skill folder-dengan-SKILL.md yang dideklarasikan di tata letak sumber proyek.

6. Output Style

Empat output style hidup di bawah src/apothem/output-styles/.

7. Evolusi Artefak

Wajib. Ketika suatu pola, koreksi, atau teknik yang dapat digunakan-ulang berulang (2+ instans dalam satu sesi, atau dicatat di memori sebagai berulang), ekosistem harus berevolusi. Siklusnya memiliki empat langkah: Detect pola selama interaksi apa pun; Search skill, rule, command, hook, dan memori yang ada untuk tumpang-tindih; Act dengan mengevolusi artefak yang cocok di-tempat (perbarui prosedur, anti-pola, scope) atau membuat yang baru ketika kepentingannya genuinely ortogonal; Validate bahwa referensi-silang masih ter-resolve dan artefak dependen tetap konsisten. Lebih suka perhalusan daripada pembuatan — artefak baru memajemukkan permukaan pemeliharaan. Lihat src/apothem/rules/persistent-conventions-vigilance.md §2+§4 untuk protokol lengkap termasuk katalog tertutup pemicu deteksi-celah di seluruh kelas artefak.

8. Kelas Artefak Kosong

Permukaan yang dideklarasikan dalam registri ekosistem tetapi sengaja kosong sampai suatu pemicu aktivasi terpicu. Setiap baris mencatat permukaan tercadang, berkas atau direktori yang men-scaffold kelas itu, dan pemicu yang mempromosikan baris dari kosong-atest ke terpopulasi.

Kosong-atest adalah deklarasi positif, bukan celah. Scaffold kelas (ketika ada) adalah artefak no-op kanonis yang melacak momen aktivasi. Promosi dari kosong-atest ke terpopulasi mendarat di seksi registri yang relevan secara atomik dengan nilai non-kosong pertama scaffold.