Dokumentationsorchestrierung
Wenn diese Fähigkeit aufgerufen wird, führe die folgende Pipeline aus:
Schritt 1: Architekturprüfung
Erzeuge den Agenten general-purpose mit folgender Aufforderung:
Überprüfe die aktuelle Codebasis auf Änderungen seit der letzten Aktualisierung der Dokumente. Lies die vorhandenen Maschinendokumente (eine einzige root
AGENTS.md-Registry) und vergleiche sie mit dem tatsächlichen Projekt. Erstelle einen präzisen Änderungsbericht, der folgendes abdeckt:
- Neue oder entfernte Bundles, Skills, Agents, Konfigurationsschlüssel oder CLI-Befehle
- Geänderte Installer-Exporte oder Vorlagensemantik (
installer/lib/*.mjs)bundle.yaml-Konfigurationsdeklarationen, die nicht mit der Platzhalterverwendung übereinstimmen- Abweichungen der gerenderten Ausgabe:
node installer/cli.mjs doctor --allow-missingsauber (festgeschriebenes Rendern und Lock in Sync — nach Bundle-Bearbeitungen neu rendern und committen);.gitignoredeckt weiterhin die absichtlich nicht verfolgten Renderings ab (Label-Hook-Workflow, Worktrees,.waffle/-Übersichtsdokumente)Gib NUR den Änderungsbericht als strukturierten Text aus. Ändere KEINE Dateien.
Schritt 2: Agentendokumentation
Nimm den Änderungsbericht und erzeuge den Agenten docs-agent mit folgender Aufforderung:
Hier ist der Architekturänderungsbericht für die wafflestack-Codebasis:
{Ausgabe Schritt 1}
Aktualisiere die Maschinendokumente — eine einzige root
AGENTS.md-Registry — um den aktuellen Stand des Projekts widerzuspiegeln. Lies die tatsächlichen Quelldateien, um die Details zu überprüfen — verlasse dich nicht ausschließlich auf den Änderungsbericht. Befolge die Richtlinien des docs-agent-Skills für Format und Struktur.
Schritt 3: Menschendokumentation
Nach Abschluss des docs-agent, erzeuge den Agenten docs-human mit folgender Aufforderung:
Die Maschinendokumente wurden gerade aktualisiert. Aktualisiere die menschenlesbare Dokumentation —
DECISIONS.md,STATUS.mdundARCHITECTURE.mdim Repository-Root — entsprechend.Lies die aktualisierten Maschinendokumente und die tatsächlichen Quellen, um die Genauigkeit sicherzustellen. Befolge die Richtlinien des docs-human-Skills für Format, Struktur und seine Sicherheitsvorkehrungen (dokumente mit der Stimme des Eigentümers werden markiert, niemals neu geschrieben).
Wichtig
- Jeder Schritt muss abgeschlossen sein, bevor der nächste beginnt — die Ausgabe jedes Schrittes speist den nächsten.
- Schritt 1 ist schreibgeschützt — der Prüfungsagent berichtet nur.
- docs-agent und docs-human SOLLEN ihre jeweiligen Dokumentationsdateien ändern.