Deployment-Checkliste

Vorab-Verifizierungsschritte, bevor das Apothem-Ökosystem auf einer neuen Maschine bereitgestellt, mit anderen geteilt oder als produktionsreif behandelt wird.

1. YAML-GültigkeitCopy Anchor Link

• Alle Regeldateien werden ohne YAML-Fehler geparst — der Frontmatter-Block öffnet mit ---, schließt mit --- und enthält keinen verwaisten Inhalt außerhalb des Blocks
• Alle delegierten Worker-Dateien werden ohne YAML-Fehler geparst
• Alle Befehlsdateien werden ohne YAML-Fehler geparst
• Alle SKILL.md-Skill-Dateien werden ohne YAML-Fehler geparst

Verifizierung: python scripts/dev/validate_ecosystem.py parst das Frontmatter jedes Artefakts und meldet YAML-Fehler + fehlende erforderliche Felder. Zur ad-hoc Erkennung verwaister Listenelemente: rg -n "^- " src/apothem/rules/*.md.

2. Frontmatter-VollständigkeitCopy Anchor Link

Überprüfen Sie für jeden Artefakttyp, ob die erforderlichen Felder vorhanden sind:

Regeln (src/apothem/rules/*.md)Copy Anchor Link

• name — kebab-case-Bezeichner, der dem Dateinamen entspricht
• description — Zusammenfassung in einem einzigen Satz
• alwaysApply — true für immer aktive Regeln, false für pfadgefilterte Regeln
• pathFilter — bei jeder Regel vorhanden: "" für immer aktive Regeln (alwaysApply: true), eine durch Kommas getrennte Glob-Liste für pfadgefilterte Regeln (alwaysApply: false)

Regeln enthalten keinen Schlüssel version, updated, scope oder portability.

Befehle (src/apothem/commands/*.md)Copy Anchor Link

• name — Befehlsname in kebab-case
• version, updated, description, argument-hint, portability, allowed-tools vorhanden
• disable-model-invocation vorhanden und beabsichtigt (false für schreibgeschützte oder beratende Befehle; true nur, wenn die Ausführung des Befehls Zustand außerhalb des Arbeitsbaums ändert oder davon abhängt, dass der Operator den Zeitpunkt wählt)
• Kein Schlüssel effort: command.schema.json setzt additionalProperties: false und lässt ihn nicht zu

Delegierte WorkerCopy Anchor Link

Pfad:

src/apothem/agents/*.md

• name, version, updated, description vorhanden
• tools — durch Kommas getrennte Liste der erlaubten Werkzeuge
• disallowedTools — listet explizit die nicht erlaubten Werkzeuge auf
• maxTurns — gesetzt (mit Begründungskommentar, wenn > 10)
• permissionMode — darf NICHT "bypassPermissions" sein; lassen Sie den Schlüssel ungesetzt, da die agnostische Grundhaltung keinen Berechtigungsmodus vorgibt
• memory weggelassen, sofern persistenter Speicher nicht beabsichtigt ist; wenn gesetzt, einer von user, project, local (keine boolesche Form)

Skills (src/apothem/skills/*/SKILL.md)Copy Anchor Link

• name, version, updated, description, archetype, disable-model-invocation, allowed-tools vorhanden
• userInvocable deklariert (true/false). Die Quellschreibweise ist userInvocable; ein Skill trägt genau eine der beiden Schreibweisen userInvocable oder user-invocable (die Schreibweise von Claude Code).

3. SicherheitCopy Anchor Link

• Kein delegierter Worker verwendet permissionMode: "bypassPermissions" — dies umgeht die interaktive Bestätigung für Write/Bash-Operationen
• Die tools-Listen des Workers sind minimal — nur die Werkzeuge, die der Worker tatsächlich benötigt
• Worker mit Bash-Zugriff sind begründet und haben maxTurns-Grenzen
• Keine fest codierten Pfade, Tokens oder Geheimnisse in irgendeinem Artefakt
• Hooks in settings.json haben angemessene Timeouts (≤ 60 Sekunden) und führen keinen beliebigen Code aus Benutzereingaben aus

4. Integrität der QuerverweiseCopy Anchor Link

• Jede in der Tabelle src/apothem/rules/ aufgeführte Regel existiert auf der Festplatte am angegebenen Pfad
• Jeder in der Tabelle src/apothem/commands/ aufgeführte Befehl existiert auf der Festplatte
• Jeder in der Registrierungstabelle src/apothem/agents/ aufgeführte delegierte Worker existiert auf der Festplatte
• Jeder in der Tabelle src/apothem/skills/ aufgeführte Skill existiert auf der Festplatte
• Jeder Hook in der Tabelle src/apothem/hooks/ hat einen entsprechenden Eintrag in settings.json
• Alle src/apothem/rules/*.md-Dateien existieren und lösen ihre Bindings-Querverweise auf

5. MandatsabdeckungCopy Anchor Link

• Jedes CM-N-Mandat hat einen Durchsetzungsort (entweder eine Regeldatei oder eine explizite Inline-Definition)
• Keine Regeldatei widerspricht einer anderen (insbesondere rund um die Ernsthaftigkeitsskalierung)
• Die CM-21-Dreifacetten-Abgrenzung wird eingehalten — keine Regel beansprucht den Besitz der CM-21-Facette einer anderen Regel

6. Funktionale Smoke-TestsCopy Anchor Link

Führen Sie zuerst die Python-Validierungsoberfläche aus — sie ist schnell, offline und fängt strukturelle Regressionen ab:

• pytest tests — Unit-Tests für das Hook-Runtime, alle grün
• python scripts/dev/validate_hooks.py — Hook-Struktur + Nur-Python-Hygieneprüfung bestanden
• python scripts/dev/validate_ecosystem.py — vollständiger Baum + Frontmatter + delegierte Hook-Prüfungen bestanden
• python scripts/dev/chaos_pass.py — jeder konfigurierte Hook-Befehl liefert unter degradierten Eingaben einen gültigen JSON-Umschlag

Dann Live-Szenarien:

• /plan-spec <sample-file> — schließt Ingest und Klärung ohne Fehler auf Befehlsebene ab
• /plan-generate --dry-run — erzeugt eine Strukturvorschau, ohne Dateien zu schreiben
• /plan-status auf einer vollständigen Plan-Suite — liefert genaue Phasenzählungen
• Dispatch delegierter Worker: der Worker codebase-explorer, mit kleinem Umfang aufgerufen, schließt innerhalb von maxTurns ab und liefert strukturierte Ausgabe

7. Aktualität der DokumentationCopy Anchor Link

• CHANGELOG.md (im Ökosystem-Stammverzeichnis) spiegelt jede Artefaktänderung seit der letzten Veröffentlichung wider; der Abschnitt der nächsten Veröffentlichung wird befüllt, bevor das Tag landet, oder jede Änderung ist bereits in einen veröffentlichten Abschnitt geschnitten
• site/content/docs/developer-guide.mdx beschreibt die aktuelle Artefaktstruktur präzise
• site/content/docs/reference/artifact-schema.mdx stimmt mit den tatsächlich in den Artefakten vorhandenen Frontmatter-Feldern überein
• site/content/docs/reference/settings-reference.mdx stimmt mit der tatsächlichen Hook-Konfiguration in settings.json überein
• README.md ist mit dem Baum auf der Festplatte konsistent

8. Portabilität (beim Teilen mit anderen)Copy Anchor Link

• Alle Pfade in Hook-Befehlen sind umgebungsunabhängig oder verwenden die ~-Erweiterung
• Hook-Befehle verwenden die Exec-Form und vermeiden shell-spezifische Befehlszeichenfolgen
• Keine fest codierten C:\Users\username- oder /home/username-Pfade in irgendeinem Artefakt
• settings.json verwendet eine einzige Hook-Ereignis-Abdeckungstabelle und den kanonischen Dispatch-Modulpfad

9. VersionsabstimmungCopy Anchor Link

• Die version von CLAUDE.md ist die höchste aller Artefakte im Baum (oder per Konvention gleich der Version des zuletzt hochgesetzten Artefakts)
• Die version jedes Artefakts stimmt mit dem angegebenen semver (MAJOR.MINOR.PATCH) überein
• CHANGELOG.md enthält vor dem Tagging genau den Veröffentlichungseintrag für die Zielversion
• Das updated-Feld jedes Artefakts liegt am Datum seiner letzten verhaltensändernden Bearbeitung oder danach
• Kein Artefakt trägt eine version, die niedriger ist als die Version, bei der es zuletzt angefasst wurde (keine Regressionen)
• src/apothem/skills/plan-suite/SKILL.md und src/apothem/skills/plan-suite/master-template.md sind an dieselbe Vorlagenversionslinie gepinnt

FreigabeCopy Anchor Link

Deployment genehmigt von: ___________________ Datum: ___________________ Bereitgestellte Ökosystem-Version: ___________________