docs: sync README/USAGE/CHANGELOG (doc-syncer clean run)

- 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) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01X3e8LaH2vymmxyh36h3jFU
This commit is contained in:
Bastien Chanot 2026-06-19 15:15:21 +02:00
parent 35536bf1ed
commit a4e0425581
3 changed files with 30 additions and 9 deletions

View File

@ -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

View File

@ -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

View File

@ -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