Artefakt-Registries

Kanonisches Register der Artefakt-Kohorten. Dieses Dokument trägt die vollständigen Aufzählungen von Commands, Regeln, delegierten Workern, Hooks, Skills, Output-Styles, der Disziplin der Artefaktevolution und den Deklarationen leerer Artefaktklassen; die substanziellen Tabellen leben hier. Das Quell-Layout des Projekts liefert die verdichtete, stets geladene Ansicht.

1. Commands

Dreißig Commands werden aus src/apothem/commands/*.md registriert (nicht rekursiv). Jeder Command ist eine erstklassige registrierte Datei; der /plan-Orchestrator verkettet nur die bereits erstklassigen Plan-Stages und trägt keine eigene Stage-Logik, sodass es weiterhin keinen monolithischen Dispatcher und keine Subcommand-Gruppierung gibt. Die Nicht-Plan-, Nicht-Workflow-Commands:

Plan-Pipeline-Commands

Die Plan-Pipeline wird als acht erstklassige Commands ausgeliefert — einer pro Stage, jeder direkt als /plan-<stage> aus seiner eigenen registrierten Datei unter src/apothem/commands/plan-<stage>.md aufrufbar.

Operator-Workflow- & Orchestrator-Commands

Drei Commands treten in eine tiefe Prozedur ein, statt eigene Stage-Logik zu tragen: zwei Operator-Workflow-Einstiegspunkte (jeweils gestützt durch einen gleichnamigen Begleit-Skill) plus den schlanken Plan-Pipeline-Orchestrator.

2. Regeln

Verhaltensregeln leben unter src/apothem/rules/ — ein kleiner, stets geladener Kern plus ein größerer, pfadgefilterter Satz (bei passenden Artefaktberührungen bedarfsgeladen). Die vollständige Aufzählung pro Regel — mit den Spalten Scope (stets geladen / pfadgefiltert) und Implements — ist die quellgenerierte reference/rules.mdx, aktualisiert aus src/apothem/rules/*.md durch den Reference-Inventory-Generator; konsultiere sie für die maßgebliche aktuelle Liste.

CM-21-Facettenabgrenzung (drei Regeln implementieren CM-21 gemeinsam mit verschiedenen, nicht überlappenden Facetten): kreative Filter & kognitive Identität → cognitive-identity.md; Generierungsmethodik (Schreib- & Umschreib-Protokolle) → clean-room-generation.md; Planungs-/Review-Techniken → planning-techniques.md. Jede Regel besitzt ihre Facette; die anderen verweisen darauf.

Verweis auf das Interactive-Questions-Schema. Das kanonische Invocation-Schema der strukturierten Inquiry — Pflichtfelder, Feldübersichtstabelle, zwei ausführbare durchgearbeitete Beispiele (Single-Select bei §2.1 und Multi-Select bei §2.2) — lebt unter src/apothem/rules/interactive-questions.md §2 „Structured-Inquiry Shape". Nachgelagerte Artefakte dürfen §2.1 oder §2.2 als Invocation-Vorlagen kopieren; das dreiteilige Option-Annotation-Schema, das der description-Body jeder Option trägt, ist im §3 derselben Datei spezifiziert.

3. Delegierte Worker

Zwölf persistente Worker-Definitionen werden mit dem Ökosystem ausgeliefert; die Team-Muster der Orchestrierungsregel disponieren zu ihnen. Jede Definition lebt unter dem unten aufgeführten Dateipfad.

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

4. Hooks

Jeder registrierte Hook-Command verwendet die Exec-Form-Command-Gestalt von Claude Code (command: "python" plus ein args-Array) und ruft entweder -m apothem.hooks.dispatch oder -m apothem.conformity.gate auf. Der Dispatcher importiert src/apothem/hooks/lib/resolve_root.py für die Auflösung der Ökosystem-Wurzel und delegiert an zwei Helfer, die daneben unter src/apothem/hooks/ selbst liegen: src/apothem/hooks/emit_hook_context.py formatiert Event-Payloads für den Assistenten und src/apothem/hooks/session_start_bootstrap.py trägt die SessionStart-Vorbereitungsarbeit, die der Dispatcher übergibt, wenn er dieses Event routet. Die dem Assistenten beim Auslösen der unterstützten Events angezeigten Hook-Nachrichten leben als Markdown-Kontextdateien unter src/apothem/hooks/messages/ — eine pro Event-Variante: 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. Jede geroutete Kontextdatei wird vom Dispatcher geladen, wenn ihr Event auslöst und ihr Kontextargument in settings.json registriert ist; drei Kontextdateien (pretooluse-conformity.md, pretooluse-dependency-guard.md, pretooluse-eval-guard.md) werden als verfügbare Varianten ohne aktuellen settings.json-Routing-Eintrag ausgeliefert.

Event             Automates                Timeout  Purpose
----------------- ------------------------ -------- --------------------------------------------------
SessionStart      CM-14                    30s      Read memory, check plan state, report readiness
PreCompact        CM-24 §2.3               30s      Verify state externalized before compaction
PostCompact       CM-24 §6.2               30s      Restore working state after compaction
Stop              CM-14/CM-22/CM-24/CM-26  60s      Session-end externalization
PreToolUse        CM-7/CM-22               10s      Write/Edit/NotebookEdit validation — codebase-isolation, frontmatter, license-header, and plans-locality checks plus the conformity gate. Bash validation — git artifact isolation and plans-locality
PostToolUse       —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event
UserPromptSubmit  —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event
Notification      —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event

Konvention. Zeilen, in denen Automates — ist, werden von dispatch.py akzeptiert, aber nicht in settings.json verdrahtet; die Spalte Timeout zeigt den Dispatch-Level-Standard, der gilt, falls und wenn das Event später verdrahtet wird.

Kanonischer Block der Timeout-Werte. Die Spalte Timeout dieser Tabelle ist die einzige Quelle der Wahrheit für Hook-Timeout-Werte im gesamten Ökosystem. Die timeout-Felder pro Hook in settings.json, die Spiegeltabellen in site/content/docs/reference/settings-reference.mdx § Hook Events und site/content/docs/reference/artifact-schema.mdx § Hooks Pipeline sowie die Regelanleitung in src/apothem/rules/persistent-conventions-vigilance.md § Convention Awareness leiten sich alle aus dieser Spalte ab. Künftige Timeout-Revisionen landen hier und die Konsumenten leiten beim nächsten Verweis neu ab.

Review-Kadenz der Settings-Vorlage

settings.json ist die einzige Claude Code Vorlage. Jeder Hook-Command verwendet Exec-Form statt eines shell-spezifischen Wrappers, sodass plattformübergreifendes Verhalten innerhalb einer Datei überprüft wird statt durch das Vergleichen gepaarter Vorlagen. Neue Permission-Einträge, Hook-Events, Timeouts und Statusmeldungen landen atomar in dieser Datei.

5. Skills

Wiederverwendbare Skills leben unter src/apothem/skills/, einen Ordner pro Skill.

Konvention. Der Pfad jeder Zeile ist ein Ordner; der Einstiegspunkt ist die Datei SKILL.md darin — z. B. src/apothem/skills/plan-suite/SKILL.md — gemäß der Ordner-mit-SKILL.md-Skill-Konvention, deklariert im Quell-Layout des Projekts.

6. Output-Styles

Vier Output-Styles leben unter src/apothem/output-styles/.

7. Artefaktevolution

Verpflichtend. Wenn ein wiederverwendbares Muster, eine Korrektur oder eine Technik wiederkehrt (2+ Instanzen in einer Session oder im Gedächtnis als wiederkehrend vermerkt), muss das Ökosystem sich weiterentwickeln. Der Zyklus hat vier Schritte: Detect des Musters während jeder Interaktion; Search bestehender Skills, Regeln, Commands, Hooks und Gedächtnis nach Überlappung; Act durch In-Place-Weiterentwicklung des passenden Artefakts (Aktualisierung von Prozedur, Anti-Mustern, Scope) oder Erstellung eines neuen, wenn das Anliegen genuin orthogonal ist; Validate, dass Querverweise weiterhin auflösen und abhängige Artefakte konsistent bleiben. Bevorzuge Verfeinerung gegenüber Erstellung — neue Artefakte vergrößern die Wartungsoberfläche. Siehe src/apothem/rules/persistent-conventions-vigilance.md §2+§4 für das vollständige Protokoll einschließlich des geschlossenen Katalogs von Lückenerkennungs-Triggern über jede Artefaktklasse.

8. Leere Artefaktklassen

Oberflächen, die in der Ökosystem-Registry deklariert, aber absichtlich leer sind, bis ein Aktivierungs-Trigger auslöst. Jede Zeile verzeichnet die reservierte Oberfläche, die Datei oder das Verzeichnis, das die Klasse gerüstet, und den Trigger, der die Zeile von Leer-Attestierung zu Befüllt befördert.

Leer-Attestierung ist eine positive Deklaration, keine Lücke. Das Gerüst der Klasse (sofern eines existiert) ist das kanonische No-op-Artefakt, das den Aktivierungsmoment verfolgt. Promotionen von Leer-Attestierung zu Befüllt landen atomar mit dem ersten nicht-leeren Wert des Gerüsts im relevanten Registry-Abschnitt.