CommunitySchreiben & Editierengithub.com

wafflestack

🧇 Ein Teig, jedes Repo — wiederverwendbare KI-Agenten- und Skill-Definitionen, gerendert in harness-native Dateien (.claude/, .codex/, .agents/)

Was ist wafflestack?

Diese Fähigkeit orchestriert die Dokumentation eines wafflestack-basierten Projekts. Bei Aufruf führt sie eine dreistufige Pipeline aus: Zuerst führt eine Prüfung der Architektur (Schritt 1) eine schreibgeschützte Analyse der Codebasis durch und erstellt einen Änderungsbericht. Anschließend aktualisiert der docs-agent (Schritt 2) die maschinenlesbare Dokumentation in einer einzigen `AGENTS.md`-Registry, um den tatsächlichen Zustand des Projekts widerzuspiegeln. Schließlich bringt der docs-human-Agent (Schritt 3) die menschenlesbaren Dokumente (`DECISIONS.md`, `STATUS.md`, `ARCHITECTURE.md`) auf den neuesten Stand, wobei die Sicherheitsvorkehrungen bezüglich der Stimme des Eigentümers beachtet werden. Die Pipeline ist streng sequenziell: Der Ausgang jedes Schrittes speist den nächsten, und Schritt 1 ist ausschließlich lesend. Diese Fähigkeit ist dazu gedacht, in Umgebungen wie Claude Code, Cursor oder Codex verwendet zu werden, in denen Agenten auf strukturierte Weise Dokumentation über mehrere Ausgabeformate hinweg verwalten. Sie stellt sicher, dass maschinen- und menschenlesbare Dokumentation synchron bleiben.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add dustinkeeton/wafflestack

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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-missing sauber (festgeschriebenes Rendern und Lock in Sync — nach Bundle-Bearbeitungen neu rendern und committen); .gitignore deckt 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.md und ARCHITECTURE.md im 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.

Verwandte Skills