CommunityRédaction et éditiongithub.com

dustinkeeton/wafflestack

🧇 Une seule pâte, chaque dépôt — définitions réutilisables d'agents et de compétences IA rendues en fichiers natifs des plateformes (.claude/, .codex/, .agents/)

Qu'est-ce que wafflestack ?

Ce skill orchestre un pipeline de documentation pour le framework Wafflestack, qui normalise les définitions d'agents IA et de compétences en fichiers compatibles avec les plateformes (.claude/, .codex/, .agents/). Il commence par une analyse d'architecture en lecture seule pour identifier les divergences entre le code source et la documentation machine existante (registre AGENTS.md). Ensuite, deux agents spécialisés mettent à jour les documents : d'abord l'agent 'docs-agent' qui synchronise la documentation technique (AGENTS.md), puis l'agent 'docs-human' qui aligne les documents destinés aux humains (DECISIONS.md, STATUS.md, ARCHITECTURE.md). Chaque étape s'appuie sur la sortie de la précédente, garantissant que la documentation technique et humaine reste cohérente avec l'état réel du projet. Ce skill est utile pour les développeurs utilisant des outils comme Claude Code, Cursor, Codex ou GitHub Agents, car il automatise la maintenance de la documentation au sein d'une structure de skill réutilisable.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add dustinkeeton/wafflestack

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Orchestration de la documentation

Lorsque ce skill est invoqué, exécutez le pipeline suivant :

Étape 1 : Audit d'architecture

Lancez l'agent general-purpose avec cette invite :

Auditez le codebase actuel pour détecter les modifications depuis la dernière mise à jour de la documentation. Lisez la documentation machine existante (un registre racine unique AGENTS.md) et comparez-la avec le projet réel. Produisez un rapport de modifications concis couvrant :

  • Bundles, compétences, agents, clés de configuration ou commandes CLI nouveaux ou supprimés
  • Exportations d'installateur modifiées ou sémantique de template changée (installer/lib/*.mjs)
  • Déclarations de configuration bundle.yaml désynchronisées avec l'utilisation des espaces réservés
  • Dérive de sortie rendue : node installer/cli.mjs doctor --allow-missing propre (rendu engagé + verrou en synchronisation — re-rendre et engager après les modifications de bundle) ; .gitignore couvre toujours les rendus délibérément non suivis (workflow de hook d'étiquette, worktrees, docs de vue d'ensemble .waffle/)

Produisez UNIQUEMENT le rapport de modifications sous forme de texte structuré. Ne modifiez AUCUN fichier.

Étape 2 : Documentation agent

Prenez le rapport de modifications et lancez l'agent docs-agent avec cette invite :

Voici le rapport de modifications architecturales pour le codebase wafflestack :

{sortie étape 1}

Mettez à jour la documentation machine — un registre racine unique AGENTS.md — pour refléter l'état actuel du projet. Lisez les fichiers source réels pour vérifier les détails — ne vous fiez pas uniquement au rapport de modifications. Suivez les directives de la compétence docs-agent pour le format et la structure.

Étape 3 : Documentation humaine

Une fois que docs-agent a terminé, lancez l'agent docs-human avec cette invite :

La documentation machine vient d'être mise à jour. Mettez à jour la documentation destinée aux humains — DECISIONS.md, STATUS.md et ARCHITECTURE.md à la racine du dépôt — pour correspondre.

Lisez la documentation machine mise à jour et le code source réel pour garantir l'exactitude. Suivez les directives de la compétence docs-human pour le format, la structure et ses garde-fous (les documents rédigés par le propriétaire sont signalés, jamais réécrits).

Important

  • Chaque étape doit se terminer avant que la suivante ne commence — la sortie de chacune alimente la suivante.
  • L'étape 1 est en lecture seule — l'agent d'audit ne fait que rapporter.
  • docs-agent et docs-human DOIVENT modifier leurs fichiers de documentation respectifs.

Skills associés