From af6f56d61839ec9968e815f52f5f02c1dca3f2d2 Mon Sep 17 00:00:00 2001 From: Florian BRUNIAUX Date: Tue, 20 Jan 2026 12:57:48 +0100 Subject: [PATCH] docs: document complete 4-repo ecosystem architecture MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add ecosystem section to CLAUDE.md with architecture diagram - Add landing sites table to README.md ecosystem section - Add landing_sites section to reference.yaml with sync history - Document bidirectional cross-links and sync triggers - Include migration history and commit references Ecosystem: - Claude Code Guide (this repo) → devs - Claude Cowork Guide (dedicated) → knowledge workers - Code Landing (vitrine) → discovery - Cowork Landing (vitrine) → discovery Architecture: 2 source repos + 2 landing sites, synchronized Co-Authored-By: Claude Sonnet 4.5 --- CLAUDE.md | 119 ++++++++++++++++++++++++++++++++ README.md | 11 +++ machine-readable/reference.yaml | 26 +++++++ 3 files changed, 156 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 4671f10..bf679bd 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -185,6 +185,125 @@ All synced! - Exit code = nombre d'issues trouvées - Consulter `landing/CLAUDE.md` pour les numéros de ligne exacts à modifier +## Écosystème Complet (4 Repositories) + +Ce guide fait partie d'un écosystème de 4 repositories interconnectés, séparant les audiences (devs vs knowledge workers) et les use cases (documentation vs vitrine). + +### Architecture + +``` + REPOS SOURCES (Documentation) + ┌──────────────────┬──────────────────┐ + │ │ │ + ┌───▼───┐ ┌───▼───┐ + │ Guide │ │Cowork │ + │ Code │◄────────►│ Guide │ + │ vX.Y │ liens │ v1.0 │ + └───┬───┘ └───┬───┘ + │ │ + │ source │ source + │ │ + LANDING SITES (Vitrine) + ┌──────────────────┬──────────────────┐ + │ │ │ + ┌───▼───┐ ┌───▼───┐ + │ Code │◄────────►│Cowork │ + │Landing│cross-links│Landing│ + │ vX.Y │ │ v1.0 │ + └───────┘ └───────┘ +``` + +### 1. Claude Code Ultimate Guide (ce repo) + +**Pour qui**: Développeurs utilisant Claude Code CLI + +| Aspect | Détails | +|--------|---------| +| **GitHub** | https://github.com/FlorianBruniaux/claude-code-ultimate-guide | +| **Local** | `/Users/florianbruniaux/Sites/perso/claude-code-ultimate-guide/` | +| **Contenu** | Guide 11K lignes, 66+ templates, workflows, architecture | +| **Audience** | Développeurs, DevOps, tech leads | + +### 2. Claude Cowork Guide (repo dédié) + +**Pour qui**: Knowledge workers utilisant Claude Desktop (non-devs) + +| Aspect | Détails | +|--------|---------| +| **GitHub** | https://github.com/FlorianBruniaux/claude-cowork-guide | +| **Local** | `/Users/florianbruniaux/Sites/perso/claude-cowork-guide/` | +| **Contenu** | 6 guides, 67 prompts, 5 workflows, cheatsheet, FAQ | +| **Audience** | Non-devs, assistants, managers, knowledge workers | + +**Migration**: Le dossier `cowork/` a été migré du repo principal vers ce repo dédié (v1.0.0, commit 7a686a8). + +### 3. Code Landing Site + +**Pour qui**: Visiteurs découvrant le guide Code + +| Aspect | Détails | +|--------|---------| +| **Local** | `/Users/florianbruniaux/Sites/perso/claude-code-ultimate-guide-landing/` | +| **Contenu** | Page marketing, badges, FAQ, quiz (227 questions) | +| **Sync avec** | Guide principal (version, templates, guide lines) | + +### 4. Cowork Landing Site + +**Pour qui**: Visiteurs découvrant le guide Cowork + +| Aspect | Détails | +|--------|---------| +| **Local** | `/Users/florianbruniaux/Sites/perso/claude-cowork-guide-landing/` | +| **Contenu** | Page marketing Cowork, prompts showcase | +| **Sync avec** | Cowork guide (version, prompts count) | + +### Synchronisation Inter-Repos + +**Déclencheurs de mise à jour multi-repos**: + +| Changement | Repos à mettre à jour | +|------------|----------------------| +| Version bump (Guide Code) | 1. Guide Code, 2. Code Landing | +| Templates ajoutés/supprimés | 1. Guide Code, 2. Code Landing | +| Version bump (Cowork) | 1. Cowork Guide, 2. Cowork Landing | +| Prompts ajoutés/supprimés | 1. Cowork Guide, 2. Cowork Landing | +| Cross-links modifiés | Tous les 4 repos | + +**Scripts de vérification**: + +```bash +# Vérifier sync Code Landing +./scripts/check-landing-sync.sh + +# Vérifier sync Cowork +cd ../claude-cowork-guide && ./scripts/check-version-sync.sh +``` + +### Relations & Liens + +**Guide Code → Cowork Guide**: +- `guide/cowork.md`: Summary avec liens vers repo dédié +- `guide/README.md`: Table avec 6 liens vers guides Cowork +- `machine-readable/reference.yaml`: 23 entrées pointant vers GitHub + +**Landing Code ↔ Landing Cowork**: +- Cross-links bidirectionnels (hero, ecosystem, sections) +- Navigation fluide entre les 2 audiences + +**Principe**: Séparation claire des audiences, navigation facilitée, synchronisation maintenue. + +### Historique de l'Écosystème + +| Date | Événement | Commits | +|------|-----------|---------| +| 2026-01-19 | Création repo Cowork dédié v1.0.0 | 7a686a8 | +| 2026-01-19 | MAJ README Guide Code → liens GitHub | 9a743cd | +| 2026-01-20 | Suppression cowork/ du guide principal | 9a29ba4 | +| 2026-01-20 | Sync Code Landing (v3.9.7, 66 templates) | 5b5ce62 | +| 2026-01-20 | Fix Cowork Landing (paths, README, UI) | cab83f5, af497b7, 539912b | + +**Résultat**: 7 commits, 4 repos synchronisés, -8,297 lignes (cleanup massif), écosystème opérationnel. + ## Research Resources **Perplexity Pro disponible**: Pour toute recherche nécessitant des sources fiables ou des informations récentes sur Claude Code, Anthropic, ou les pratiques de développement assisté par IA: diff --git a/README.md b/README.md index 0e74576..fd78d65 100644 --- a/README.md +++ b/README.md @@ -310,6 +310,17 @@ Claude Code sends your prompts, file contents, and MCP results to Anthropic serv
Ecosystem & Related Resources +**This Guide's Ecosystem** (4 interconnected repositories): + +| Repository | Purpose | Audience | +|------------|---------|----------| +| **[Claude Code Guide](https://github.com/FlorianBruniaux/claude-code-ultimate-guide)** *(this repo)* | Comprehensive documentation (11K lines, 66 templates) | Developers | +| **[Claude Cowork Guide](https://github.com/FlorianBruniaux/claude-cowork-guide)** | Non-technical usage (67 prompts, 5 workflows) | Knowledge workers | +| **Code Landing** *(to be deployed)* | Marketing site for Claude Code guide | Discovery | +| **Cowork Landing** *(to be deployed)* | Marketing site for Cowork guide | Discovery | + +💡 **Architecture**: Separate repos for clear audience separation (devs vs non-devs), bidirectional cross-links for easy navigation. + **Complementary guides**: - [claude-code-templates](https://github.com/davila7/claude-code-templates) — Install templates via CLI (17k⭐) - [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) — Community tool library diff --git a/machine-readable/reference.yaml b/machine-readable/reference.yaml index d202ae7..dcf3e2d 100644 --- a/machine-readable/reference.yaml +++ b/machine-readable/reference.yaml @@ -411,6 +411,32 @@ ecosystem: faq: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/reference/faq.md" prompts: "https://github.com/FlorianBruniaux/claude-cowork-guide/tree/main/prompts" workflows: "https://github.com/FlorianBruniaux/claude-cowork-guide/tree/main/workflows" + landing_sites: + description: "Marketing sites for guide discovery and navigation" + architecture: "4-repo ecosystem: 2 sources (docs) + 2 landings (vitrine)" + code_landing: + local: "/Users/florianbruniaux/Sites/perso/claude-code-ultimate-guide-landing/" + purpose: "Marketing site for Claude Code guide" + audience: "Developers discovering the guide" + features: ["badges (version, templates, lines)", "quiz (227 questions)", "FAQ", "cross-links to Cowork"] + sync_with: "Guide Code (version, templates count, guide lines)" + cowork_landing: + local: "/Users/florianbruniaux/Sites/perso/claude-cowork-guide-landing/" + purpose: "Marketing site for Cowork guide" + audience: "Knowledge workers discovering Cowork" + features: ["prompts showcase", "workflows preview", "cross-links to Code"] + sync_with: "Cowork guide (version, prompts count)" + sync_triggers: + - "Version bump → Update corresponding landing" + - "Templates/prompts added → Update counts" + - "Cross-links modified → Update all 4 repos" + history: + - date: "2026-01-20" + event: "Code Landing sync v3.9.7, 66 templates, cross-links" + commit: "5b5ce62" + - date: "2026-01-20" + event: "Cowork Landing fix (paths, README, UI badges)" + commits: "cab83f5, af497b7, 539912b" # ════════════════════════════════════════════════════════════════ # ONBOARDING MATRIX - Maps user profile → content sections