bchanot/claude
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
Run /doc clean over the public docs and apply the verified items.

- README: drop the unused CONTEXT7_API_KEY step from fresh-install (the
  var is never read; add an optional ctx7 setup section), complete the
  Makefile target table (+link, onboard, profile×3), add personal-skill
  rows (audit-delta, capitalize, prune-memory, pdf-translate) with a
  scope note, link CHANGELOG.md.
- USAGE: add audit-delta / capitalize / prune-memory to the decision
  tree, the quick-decision table, and the command reference, plus a
  scope note about plugin/marketplace skills.
- CHANGELOG: add a Keep-a-Changelog [Unreleased] section with a drafted
  (review-flagged) summary of changes since 3.4.0.

GSD notation left unchanged: gsd --help confirms both 'gsd <cmd>' (CLI)
and '/gsd <cmd>' (in-TUI) are valid, so no blanket rewrite. CHANGELOG
[Unreleased] is a draft for human review, not exhaustive.

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Bastien Chanot 2026-06-19 12:39:18 +02:00
parent e631e3a6ca
commit f4e5bf425c
3 changed files with 78 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
CHANGELOG.md
View File

@ -4,6 +4,39 @@ All notable changes to claude-config will be documented in this file.
Format follows [Keep a Changelog](https://keepachangelog.com/).
## [Unreleased]
<!-- DRAFT (doc-syncer): grounded in commits since 3.4.0; review wording + completeness before release. -->
### Added
- `/audit-delta` — recurring multi-axis audit (norms / bugs / dead code / security) scoped to changes since last run, with per-axis SHA markers
- `/capitalize` — flush uncapitalized context to the memory registries before `/clear` or `/compact`
- `/prune-memory` — curate and compress the `.claude/memory/` registries
- `/close` — end-of-session memory ritual (decisions / learnings / blockers)
- `/pdf-translate` — translate a PDF to another language, output as HTML (via Vision)
- `/harden` — web hardening audit (SSL/TLS, HSTS, CSP, headers)
- `/validate` — W3C HTML/CSS validity + WCAG accessibility audit
- `/client-handover` — final ship + branded client deliverable (Markdown / HTML / PDF)
- `/profile` — partition skills by usage profile (design / dev / qa / audit / minimal / full)
- `frontend-design` and `design-motion-principles` skills (external marketplaces)
- Project archetype library + detection for `/onboard`
- `.claude/{tasks,memory,audits}/` governance layout + 5 memory registries (decisions, learnings, blockers, journal, evals)
- Caveman plugin + standalone hooks (output token compression)
### 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
- `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
### Removed
- `disable-model-invocation` frontmatter removed repo-wide (aligns skills with CLAUDE.md routing)
### Fixed
- Numerous skill/agent fixes across darwin optimization rounds (geo-analyzer, onboard, init-project, analyzer, plugin-check, prune-memory, …)
## [3.4.0] — 2026-04-15
### Added

37
README.md
View File

@ -3,6 +3,7 @@
Global Claude Code configuration — agents, skills, plugins, and project templates.
> **Guide d'utilisation complet :** voir [`USAGE.md`](./USAGE.md) — workflows typiques, exemples par type de projet, arbre de décision "quel skill utiliser ?".
> **Historique des versions :** voir [`CHANGELOG.md`](./CHANGELOG.md).
---
@ -44,22 +45,26 @@ claude-config/
git clone --recurse-submodules git@github.com:youruser/claude-config.git
cd claude-config
# 2. Create a free Context7 account at https://context7.com/
# Copy your API key and set it:
export CONTEXT7_API_KEY="your-key-here"
# 3. Bootstrap (CLI + auth + symlinks + plugins)
# 2. Bootstrap (CLI + auth + symlinks + plugins)
bash install.sh
# 4. Verify setup
# 3. Verify setup
bash doctor.sh
# 5. Restart Claude Code — plugins load automatically
# 4. Restart Claude Code — plugins load automatically
```
All scripts use their own location to find the repo — run them from anywhere.
Install output is logged to `install-YYYYMMDD-HHMMSS.log`.
**Optional — Context7** (fast doc lookup for React / Next.js / Prisma…): `install.sh`
installs the `ctx7` CLI. To wire it into Claude Code:
```bash
ctx7 setup --claude # configure Context7 for Claude Code
ctx7 login # optional: OAuth / API key for higher rate limits
```
---
## Installed components
@ -72,7 +77,7 @@ Install output is logged to `install-YYYYMMDD-HHMMSS.log`.
| **RTK** | Plugin (always on) | Code rewrite hook. Zero passive cost. | [rtk-ai/rtk](https://github.com/rtk-ai/rtk) |
| **security-guidance** | Plugin (always on) | Security hook. Zero passive cost. | [anthropics/claude-code](https://github.com/anthropics/claude-code) |
| **ui-ux-pro-max** | Plugin (toggle) | Design system, color/typography choices. Enable for design-heavy projects. | [nextlevelbuilder/ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) |
| **Context7** | Plugin (toggle) | Fast-evolving libs doc lookup (Next.js, React, Prisma...). Requires a free account + API key (see install). | [context7.com](https://context7.com/) |
| **Context7** | Plugin (toggle) | Fast-evolving libs doc lookup (Next.js, React, Prisma...). Requires a free account + API key (optional Context7 step in install). | [context7.com](https://context7.com/) |
| **pr-review-toolkit** | Plugin (toggle) | Multi-agent PR review. | [anthropics/claude-code](https://github.com/anthropics/claude-code) |
| **Graphify** | Python CLI | Codebase → knowledge graph → navigable wiki. Helps Claude map and search projects efficiently. | [pypi: graphifyy](https://pypi.org/project/graphifyy/) |
| **Caveman** | Plugin (always on) + hooks | Output token compression (~75%) via caveman-speak. Full install = plugin (`/caveman`, cavecrew, caveman-commit, caveman-review, caveman-stats) + standalone hooks (statusline + stats badge). The optional `caveman-shrink` MCP proxy compresses upstream-server prose — manual config required (it wraps another MCP server). See `install-plugins.sh` STEP 5.5 for the snippet. | [JuliusBrussee/caveman](https://github.com/JuliusBrussee/caveman) |
@ -102,6 +107,14 @@ Versions are pinned in `plugins.lock.json`. To update: edit the file, then re-ru
| `/health` | Run setup diagnostic |
| `/status` | Consolidated project snapshot — plugins, git, GSD milestone |
| `/skills-perso` | List personal (user-created) skills |
| `/audit-delta` | Recurring audit of changes since last run (norms, bugs, dead code, security) |
| `/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) |
> 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.
---
@ -176,9 +189,15 @@ bash update-all.sh # update all components (CLI, plugins, submodules, s
# Makefile (from repo directory)
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 plugin # install plugins only
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
make profile-current # show the active profile
make profile-reset # re-enable all gstack skills
make new-skill name=myskill # scaffold agent + skill files
```

17
USAGE.md
View File

@ -72,6 +72,13 @@ Tu veux...
│ → voir la progression: /gsd status
│ → un step a échoué: /gsd forensics (debug autonome)
│
├─ Auditer les changements depuis le dernier audit ?
│ → /audit-delta ← conformité / bugs / dead code / sécurité (scope = delta)
│
├─ Gérer la mémoire de session ?
│ → /capitalize ← flush le contexte avant /clear ou /compact
│ → /prune-memory ← curer / compresser les registres .claude/memory/
│
└─ Quelque chose ne marche pas ?
→ /health ← diagnostic complet (symlinks, plugins, permissions, token budget)
```
@ -96,6 +103,9 @@ Tu veux...
| Navigation codebase large | `/graphify` |
| Lister ses skills | `/skills-perso` |
| Plugins OK ? | `/plugin-check` |
| Audit du delta (depuis dernier run) | `/audit-delta` |
| Flush mémoire avant /clear | `/capitalize` |
| Curer la mémoire | `/prune-memory` |
| Rien ne marche | `/health` |
---
@ -122,6 +132,13 @@ Tu veux...
| `/skills-perso` | Lister ses skills personnels | Skills créés dans ~/.claude/skills/ |
| `/health` | Quand quelque chose ne fonctionne pas | Lance doctor.sh |
| `/status` | Reprendre après une pause | Snapshot : plugins, git, GSD milestone |
| `/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 |
> Cette table couvre les skills personnels principaux. Les plugins (gstack,
> pr-review-toolkit…) et marketplaces externes en ajoutent beaucoup d'autres —
> `/skills-perso` liste tes skills personnels.
---