From a4e0425581aed5a242f0c8efb6cff0605e6bface Mon Sep 17 00:00:00 2001 From: Bastien Chanot Date: Fri, 19 Jun 2026 15:15:21 +0200 Subject: [PATCH] docs: sync README/USAGE/CHANGELOG (doc-syncer clean run) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - README: make-update comment, +6 skill rows (/close /harden /validate /geo /client-handover /profile), scope note corrected - USAGE: caveman in always-on, /geo split in decision tree + tables, +6 skill rows, /ship-feature 8→9 steps - CHANGELOG: doc-syncer ROADMAP sync-only note - CLEAN proposals rejected: Standard-Readme is a public-lib convention, not fit for a personal config repo distributed by clone Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01X3e8LaH2vymmxyh36h3jFU --- CHANGELOG.md | 2 +- README.md | 14 ++++++++++---- USAGE.md | 23 +++++++++++++++++++---- 3 files changed, 30 insertions(+), 9 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 7c28b8d..0e81566 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -26,7 +26,7 @@ Format follows [Keep a Changelog](https://keepachangelog.com/). ### Changed - `/seo` split into parallel `seo` + `geo` agents with shared resources - `/onboard` rewritten: archetype-aware pipeline (orchestrator + config-only agent), security audit archetype-aware -- `doc-syncer`: stack-aware audit + deploy-doc gating; later scoped to public docs only, `.claude/` read-only +- `doc-syncer`: stack-aware audit + deploy-doc gating; later scoped to public docs only, `.claude/` read-only; sync-only ROADMAP handling — planned→shipped reconciliation from code/git, never from `.claude/`; numeric incoherence → HUMAN question - `CLAUDE.md`: major refactor (contradiction purge, restructure), subagent-delegation rule, design-toolchain mandate, memory-registry governance - Memory registries: enforced English + caveman format - Default model / effort settings updated diff --git a/README.md b/README.md index ed1e352..e7d2895 100644 --- a/README.md +++ b/README.md @@ -111,10 +111,16 @@ Versions are pinned in `plugins.lock.json`. To update: edit the file, then re-ru | `/capitalize` | Flush uncapitalized context to memory registries before /clear or /compact | | `/prune-memory` | Curate and compress the .claude/memory/ registries | | `/pdf-translate` | Translate a PDF to another language, output as HTML (via Vision) | +| `/close` | End-of-session ritual — write decisions / learnings / blockers to memory registries | +| `/harden` | Web hardening audit — HTTPS/TLS, HSTS, CSP, security headers | +| `/validate` | W3C HTML/CSS validity + WCAG 2.1 accessibility audit | +| `/geo` | GEO-only audit — AI-search visibility (ChatGPT, Perplexity, Claude, Gemini…) | +| `/client-handover` | Final project delivery — audits + branded deliverable (Markdown / HTML / PDF) | +| `/profile` | Activate a skill profile (design / dev / qa / audit / minimal) | -> This table lists the core personal skills. Plugins (gstack, pr-review-toolkit…) -> and external marketplaces add many more — run `/skills-perso` for your authored -> set, or browse `skills/` for everything installed. +> This table lists personal skills. Gstack skills (investigate, review, retro, +> office-hours, context-save, context-restore, cso…) and marketplace plugins add +> many more — run `/skills-perso` for your full list, or browse `skills/`. --- @@ -192,7 +198,7 @@ make install # bootstrap: CLI + auth + symlinks + plugins make plugin # install plugins only make link # create/update symlinks into ~/.claude/ make doctor # diagnostic -make update # pull + submodules + symlinks + doctor +make update # update Claude Code, config, submodules, plugins, and verify make onboard # onboard an existing project (run from its dir) make profile cmd="set X" # activate a skill profile (design/dev/qa/audit/minimal/full) make profile-list # list skill profiles diff --git a/USAGE.md b/USAGE.md index 9ae9bdb..775a181 100644 --- a/USAGE.md +++ b/USAGE.md @@ -60,7 +60,10 @@ Tu veux... │ → /doc ← audit complet tous les fichiers .md │ ├─ Optimiser le SEO/GEO ? -│ → /seo +│ ├─ Audit complet SEO + GEO ? +│ │ → /seo +│ └─ GEO uniquement (visibilité IA) ? +│ → /geo │ ├─ Vérifier si les plugins sont bien configurés ? │ → /plugin-check "description du projet" @@ -98,7 +101,7 @@ Tu veux... | Nettoyage code ciblé | `/refactor` | | Dead code / style codebase | `/code-clean` | | Docs périmées | `/doc` | -| SEO/GEO audit | `/seo` | +| SEO/GEO audit | `/seo` (GEO seul → `/geo`) | | Commit structuré | `/commit-change` | | Navigation codebase large | `/graphify` | | Lister ses skills | `/skills-perso` | @@ -106,6 +109,12 @@ Tu veux... | Audit du delta (depuis dernier run) | `/audit-delta` | | Flush mémoire avant /clear | `/capitalize` | | Curer la mémoire | `/prune-memory` | +| Fin de session (mémoire) | `/close` | +| Audit web (TLS, CSP, headers) | `/harden` | +| Validité HTML/CSS + a11y | `/validate` | +| Visibilité IA (GEO seul) | `/geo` | +| Livraison client finale | `/client-handover` | +| Changer profil skills | `/profile` | | Rien ne marche | `/health` | --- @@ -115,7 +124,7 @@ Tu veux... | Commande | Quand | Notes | |---|---|---| | `/init-project` | Nouveau projet from scratch | 12-13 steps, deux gates obligatoires | -| `/ship-feature` | Feature sur projet existant | 8 steps, une gate | +| `/ship-feature` | Feature sur projet existant | Pipeline 9 steps, une gate | | `/feat` | Petite feature (1-5 fichiers) | Léger, pas d'orchestration lourde | | `/bugfix` | Bug avec investigation root cause | Hypothèses, diagnostic, fix minimal | | `/hotfix` | Bug superficiel (typo, CSS, config) | Max 2 fichiers, cause évidente | @@ -127,6 +136,7 @@ Tu veux... | `/code-clean` | Dead code, violations de style | Audit + rapport, fixes après approbation | | `/doc` | Docs périmées après des changements | Audit drift code↔docs, patch chirurgical | | `/seo` | Audit SEO/GEO complet | Détecte framework, audite meta/OG/sitemap | +| `/geo` | Audit GEO uniquement (IA) | Visibilité ChatGPT, Perplexity, Claude, Gemini… | | `/commit-change` | Commits bien structurés | Groupe les changements par unité logique | | `/graphify` | Navigation codebase large-scope | Knowledge graph, pour tâches multi-fichiers | | `/skills-perso` | Lister ses skills personnels | Skills créés dans ~/.claude/skills/ | @@ -135,6 +145,11 @@ Tu veux... | `/audit-delta` | Audit récurrent du delta depuis le dernier run | Axes : conformité / bugs / dead code / sécurité | | `/capitalize` | Avant /clear ou /compact | Flush le contexte non capitalisé en mémoire | | `/prune-memory` | Registres trop longs / bruyants | Curation : merge, superseded, compression | +| `/close` | Fin de session | Capitalise décisions / learnings / blockers | +| `/harden` | Audit sécurité web (SSL, CSP, HSTS) | Projet web avec config HTTP | +| `/validate` | Audit W3C + WCAG a11y | Avant livraison projet web | +| `/client-handover` | Livraison client | Audits finaux + livrable brandé | +| `/profile` | Changer le profil de skills | design / dev / qa / audit / minimal | > Cette table couvre les skills personnels principaux. Les plugins (gstack, > pr-review-toolkit…) et marketplaces externes en ajoutent beaucoup d'autres — @@ -145,7 +160,7 @@ Tu veux... ## Les plugins — décision rapide ``` -Toujours actifs (0 token) : security-guidance, rtk +Toujours actifs (0 token) : security-guidance, rtk, caveman Design élaboré/system → ui-ux-pro-max ON Deploy + QA browser → gstack ON