{
  "markdown": "# Claude Code Architecture — Agents, Skills, MCP, Workflows & Hooks\n\nUn kit d'architecture complet pour Claude Code qui transforme votre environnement de développement en un système multi-agents orchestré.\n\n## Ce que contient ce repository\n\n| Composant | Quantité | Description |\n|-----------|----------|-------------|\n| **Agents** | 19 | Experts spécialisés (architect, developer, frontend-specialist, vscode-developer...) |\n| **Skills** | 24 | Paquets de connaissances modulaires avec progressive disclosure |\n| **Workflows** | 17 | Workflows multi-agents (full-context, verify-goal, bmad-greenfield, vscode-extension-dev...) |\n| **Tools** | 13 | Outils utilitaires (scaffold, write-plan, execute-plan, continue, vscode-scaffold...) |\n| **Hooks** | 6 | Automatisations (auto-format, security-scanner, checkpoint-commit, context-monitor...) |\n| **Modules** | 10 | Packages installables indépendamment (core, dev, vscode, bmad, ai-llm...) |\n| **MCP Config** | 8 | Serveurs MCP préconfigurés |\n\n## Installation modulaire\n\nInstalle uniquement les modules dont tu as besoin :\n\n```bash\ngit clone https://github.com/V0latix/claude-code-architecture\ncd claude-code-architecture\n\n# Installation interactive (menu de sélection)\n./install.sh /path/to/mon-projet\n\n# Installer un module spécifique (ex: uniquement VSCode)\n./install.sh --modules vscode /path/to/mon-projet\n\n# Installer plusieurs modules\n./install.sh --modules vscode,bmad,process /path/to/mon-projet\n\n# Utiliser un bundle préconfiguré\n./install.sh --bundle full-stack /path/to/mon-projet\n./install.sh --bundle ai-developer /path/to/mon-projet\n\n# Tout installer (équivalent au clone complet)\n./install.sh --all /path/to/mon-projet\n\n# Voir tous les modules disponibles\n./install.sh --list\n```\n\n### Modules disponibles\n\n| Module | Contenu | Dépend de |\n|--------|---------|-----------|\n| `core` | Hooks, 8 skills fondamentales, outils utilitaires | — |\n| `process` | TDD discipline, debugging systématique, write-plan | core |\n| `dev` | developer, architect, code-reviewer, qa-engineer, 7 workflows | core, process |\n| `frontend` | frontend-specialist, ux-expert, shadcn/ui | core, dev |\n| `devops` | devops-engineer, security-auditor, docker-k8s, security-audit | core, dev |\n| `ai-llm` | ai-engineer, llm-ai-patterns, RAG, agents, chatbots | core, dev |\n| `bmad` | bmad-orchestrator, 3 workflows BMAD, templates | core, dev |\n| `vscode` | vscode-developer, vscode-extension-dev, scaffold | core, dev |\n| `data` | data-scientist, data-engineering, data-pipeline | core, dev |\n| `mobile` | mobile-developer, React Native / Flutter | core, dev, frontend |\n\n### Bundles présets\n\n| Bundle | Modules inclus | Pour qui |\n|--------|---------------|---------|\n| `full-stack` | core, process, dev, frontend, devops | Développeur full-stack Next.js/Node.js |\n| `ai-developer` | core, process, dev, ai-llm | Développeur IA/LLM |\n| `complete` | Tous les modules | Installation complète |\n\n## Mise à jour\n\nUne fois installé, mettez à jour les modules à la dernière version :\n\n```bash\n# Depuis le repo cloné (recommandé)\n./update.sh /path/to/mon-projet\n\n# Sans cloner le repo (one-liner)\ncurl -fsSL https://raw.githubusercontent.com/V0latix/claude-code-architecture/main/update.sh | bash -s /path/to/mon-projet\n```\n\nL'updater :\n- Lit `.claude/claude-architecture.json` pour connaître les modules installés\n- Tire les dernières modifications du repo\n- Ré-installe les mêmes modules automatiquement\n- Affiche \"Already up to date\" si aucune nouvelle version n'est disponible\n\n## Installation complète (cloner directement)\n\n```bash\ngit clone https://github.com/V0latix/claude-code-architecture\ncp -r claude-code-architecture/.claude votre-projet/\ncp claude-code-architecture/CLAUDE.md votre-projet/\ncp claude-code-architecture/.mcp.json votre-projet/\n```\n\nOu utiliser directement ce repository comme template GitHub.\n\n## Structure\n\n```\n.\n├── CLAUDE.md                    # Contexte projet (chargé automatiquement)\n├── .mcp.json                    # Configuration MCP servers\n├── .claude/\n│   ├── settings.json            # Hooks configurés\n│   ├── agents/                  # 20 agents spécialisés\n│   ├── skills/                  # 24 skills modulaires\n│   ├── commands/\n│   │   ├── workflows/           # 16 workflows multi-agents\n│   │   └── tools/               # 12 outils utilitaires\n│   └── hooks/scripts/           # Scripts d'automatisation\n└── docs/                        # Documentation et ADRs\n    ├── bmad/                    # Templates et checklists BMAD\n    └── stories/                 # Stories BMAD générées\n```\n\n## Agents disponibles\n\nInvoquer un agent avec `use [nom] agent:` dans Claude Code.\n\n| Agent | Modèle | Rôle |\n|-------|--------|------|\n| `analyst` | Sonnet | Brainstorming, recherche, briefs |\n| `architect` | Opus | Design système, ADR, choix technologiques |\n| `developer` | Opus | Implémentation, debugging, refactoring |\n| `frontend-specialist` | Sonnet | Implémentation React/Next.js (code UI) |\n| `qa-engineer` | Sonnet | Tests, qualité, couverture |\n| `security-auditor` | Opus | Audit sécurité, OWASP, SAST |\n| `devops-engineer` | Sonnet | CI/CD, Docker, Kubernetes |\n| `code-reviewer` | Opus | Review multi-critères en parallèle |\n| `product-manager` | Sonnet | PRD, spécifications, roadmap |\n| `scrum-master` | Haiku | User stories, sprints, agile |\n| `ux-expert` | Sonnet | UI/UX, wireframes, design system |\n| `doc-writer` | Haiku | Documentation technique |\n| `ai-engineer` | Opus | Applications LLM, RAG, chatbots, agents IA |\n| `data-scientist` | Sonnet | Analyse de données, ML, statistiques |\n| `performance-engineer` | Sonnet | Profiling, optimisation, benchmarks |\n| `mobile-developer` | Sonnet | Applications React Native / Flutter |\n| `vscode-developer` | Sonnet | Extensions VSCode — TreeView, Webview, LSP, Chat Participant, Marketplace |\n| `incident-responder` | Opus | Incidents production, postmortems |\n| `bmad-orchestrator` | Opus | Orchestrateur BMAD — routing de phase, gates, coordination |\n\n## Commandes disponibles\n\n### Workflows (préfixe `/workflows/`)\n\n```bash\n/workflows/full-context [feature]         # Analyse multi-agents complète\n/workflows/code-review [fichier]          # Review par 5 agents en parallèle\n/workflows/feature-dev [feature]          # Développement E2E\n/workflows/security-audit [module]        # Audit sécurité complet (OWASP)\n/workflows/refactor [cible]               # Refactoring intelligent\n/workflows/ai-feature [feature]           # Développement feature IA/LLM/RAG\n/workflows/performance-audit [module]     # Profiling, benchmarks, optimisation DB\n/workflows/incident-postmortem [incident] # Triage, résolution, postmortem blameless\n/workflows/new-project-setup              # Scaffold complet d'un nouveau projet\n/workflows/data-pipeline [pipeline]       # Pipeline ELT, dbt, qualité des données\n/workflows/api-design-review [api]        # Design/review API REST, OpenAPI, sécurité\n/workflows/repo-context [chemin/repo]     # Analyse repo existant → génère tout le contexte\n/workflows/vscode-extension-dev [ext]    # Développement extension VSCode end-to-end → Marketplace\n\n# BMAD — Breakthrough Method of Agile AI-driven Development\n/workflows/bmad-greenfield [projet]       # BMAD nouveau projet : Brief → PRD → Archi → Dev loop\n/workflows/bmad-brownfield [projet]       # BMAD projet existant : diagnostic, project-context.md, architecture, épics\n/workflows/bmad-quick [changement]        # BMAD Quick Flow : spec rapide → dev direct\n```\n\n### Tools (préfixe `/tools/`)\n\n```bash\n/tools/create-docs                   # Générer la documentation\n/tools/update-docs                   # Synchroniser docs/code\n/tools/scaffold [composant]          # Scaffolding de fichiers\n/tools/git-status                    # Git status enrichi\n/tools/test-gen [fichier]            # Générer des tests automatiquement\n/tools/deps-audit                    # Audit sécurité et obsolescence des dépendances\n/tools/changelog [version]           # Générer le CHANGELOG depuis git\n/tools/env-check                     # Recenser et documenter les variables d'env\n/tools/bmad-story [description]      # Créer une story BMAD prête pour le développement\n/tools/vscode-scaffold [nom] [type]  # Scaffold extension VSCode (command|treeview|webview|language|chat-participant)\n/tools/write-plan [feature]          # Créer un plan TDD granulaire dans docs/plans/ (tâches 2-5 min)\n/tools/execute-plan [chemin-plan]    # Exécuter un plan task par task avec TDD + verification\n```\n\n## Hooks automatiques\n\n| Hook | Déclencheur | Action |\n|------|-------------|--------|\n| `context-injector` | SessionStart | Log du contexte de session |\n| `security-scanner` | PreToolUse (Edit/Write) | Bloque les fichiers sensibles |\n| `auto-format` | PostToolUse (Edit/Write) | Formate le code automatiquement |\n| `checkpoint-commit` | PostToolUse (Write) | Commit automatique de checkpoint |\n| `squash-checkpoints` | Stop | Squash des checkpoints en un commit propre |\n\n## MCP Servers préconfigurés\n\nConfigurer les variables d'environnement requises, puis lancer :\n\n```bash\n# GitHub MCP\nexport GITHUB_TOKEN=ghp_...\n\n# PostgreSQL MCP (si utilisé)\nexport DATABASE_URL=postgresql://...\n\n# Brave Search MCP (si utilisé)\nexport BRAVE_API_KEY=BSA...\n```\n\n## Adapter au projet\n\n1. Modifier `CLAUDE.md` avec le stack réel du projet\n2. Ajuster les modèles dans les frontmatters des agents si besoin\n3. Activer/désactiver les hooks dans `.claude/settings.json`\n4. Configurer les MCP servers dans `.mcp.json`\n\n## Références\n\n- [Documentation Claude Code](https://docs.anthropic.com/fr/docs/claude-code)\n- [MCP Servers officiels](https://github.com/modelcontextprotocol/servers)\n- [Anthropic Skills](https://github.com/anthropics/skills)\n\n## Licence\n\nMIT\n",
  "bytes": 9725,
  "sha": "d57cd4e1c6d3c07b99c47bf4278a5a947e033da5e0b01527850d9a0a4358951a",
  "repo_slug": "v0latix/claude-code-architecture",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_v0latix_claude_code_architecture_volatix_cea12064/readme"
}