Compétence de Mise à Jour du Wiki
Actualise les sections de prose rédigées à la main des pages wiki pour refléter l'état actuel de la base de code. Les blocs de métriques/données générées sont gérés par l'orchestrateur et ne doivent jamais être touchés.
Quand l'Invoquer
- L'utilisateur tape
/update-wiki— met à jour toutes les pages contenant de la prose - L'utilisateur tape
/update-wiki Architecture— met à jour uniquementwiki/Architecture.md - L'utilisateur dit "actualiser la prose du wiki", "mettre à jour le récit d'intégration", "réécrire les documents d'architecture"
- Après une refonte significative qui modifie le récit de conception du système
Ce que Fait cette Compétence (Étape par Étape)
-
Déterminer le périmètre. Si un argument de nom de page a été fourni (par ex.,
Architecture), le résoudre enwiki/{NomDeLaPage}.md. Sinon, mettre en file d'attente toutes les pages contenant de la prose listées ci-dessous. -
Pour chaque page cible : a. Lire le fichier de la page wiki. b. Identifier chaque bloc
<!-- claude:prose -->...<!-- claude:prose:end -->. c. Lire les fichiers sources pertinents listés dans le registre ci-dessous pour construire un contexte. d. Réécrire le contenu entre les marqueurs afin qu'il reflète avec précision la base de code actuelle — conserver la même structure générale (titres, ordre des paragraphes) sauf si elle est factuellement incorrecte. e. Réécrire le contenu mis à jour dans le fichier, en préservant exactement les marqueurs. -
Ne jamais toucher aux blocs générés. Tout contenu situé à l'intérieur de
<!-- generated:start -->...<!-- generated:end -->doit rester identique octet pour octet. Ces blocs sont maintenus par le script orchestrateur du wiki. -
Le journal des décisions architecturales est entièrement propriété de Claude.
wiki/Architecture-Decision-Log.mdn'a ni blocsgeneratedni marqueursclaude:prose. Claude maintient l'intégralité du fichier. Lors de la mise à jour, ajouter de nouvelles entrées ADL pour toute décision architecturale prise depuis la dernière entrée enregistrée. Ne pas modifier les entrées existantes. -
Invite de commit. Après que toutes les pages ont été mises à jour, rappeler à l'utilisateur :
"Prose du wiki mise à jour. Exécutez
/commitpour sauvegarder les modifications, puis poussez vers le dépôt distant du wiki."
Pages Contenant de la Prose et Leurs Fichiers Sources
wiki/Architecture.md
Objectif du bloc de prose : Récit de conception du système — explique les responsabilités des modules, le flux de données et comment le site statique et l'agent de chat Lambda s'assemblent.
Fichiers sources pertinents à lire :
WebContent/js/main.jsWebContent/js/filter.jsWebContent/js/carousel.jsWebContent/js/utils.jslambda/lambda_function.pyindex.html(pour le contexte de la structure de la page)projects.html(pour le contexte de la structure de la page)
wiki/Lambda-Chat-Agent.md
Objectif du bloc de prose : Justification de la conception de l'agent — explique l'architecture Lambda, le chargement de la base de connaissances, la construction de l'invite et la gestion des réponses.
Fichiers sources pertinents à lire :
lambda/lambda_function.pylambda/context/(tous les fichiers.mds'ils sont présents)
wiki/Contributing.md
Objectif du bloc de prose : Récit d'intégration — explique le flux de travail de développement, la philosophie de test et les conventions du projet pour les nouveaux contributeurs.
Fichiers sources pertinents à lire :
CLAUDE.mdMakefilepackage.jsonpyproject.toml.github/workflows/ci-cd.yml
wiki/Architecture-Decision-Log.md
Traitement spécial : Pas de marqueurs claude:prose. Claude possède l'intégralité du fichier. Ajouter de nouvelles entrées ADL ; ne jamais modifier les entrées existantes.
Fichiers sources pertinents à lire :
- Examiner le journal git récent pour les modifications architecturales significatives
CLAUDE.mdpour les décisions d'outillage actuelleslambda/lambda_function.pypour les décisions backend
Règles de Préservation des Marqueurs
<!-- claude:prose -->
[Claude réécrit ce contenu]
<!-- claude:prose:end -->
<!-- generated:start -->
[NE JAMAIS TOUCHER — données gérées par l'orchestrateur]
<!-- generated:end -->
- Les marqueurs d'ouverture et de fermeture doivent apparaître sur leurs propres lignes, inchangés.
- Ne pas ajouter de lignes vides supplémentaires immédiatement à l'intérieur des marqueurs.
- Ne pas imbriquer les marqueurs.
Avertissement
NE JAMAIS modifier les blocs <!-- generated:start --> ... <!-- generated:end -->. Ces blocs contiennent des métriques et des tableaux générés automatiquement par l'orchestrateur du wiki. Les modifier entraînerait un conflit de fusion lors de la prochaine exécution de l'orchestrateur, ou écraserait silencieusement vos modifications.