Claude Code — XII Development

Vue d'ensemble

Identité, environnement et inventaire de la configuration globale

Louis-XII

XII Development

Développeur iOS natif — SwiftUI + UIKit · Domotique Home Assistant · macOS / zsh

Environnement

Modèle principalsonnet-4-6

Plan / Auditopus-4-7

PlateformemacOS 25.4

Shellzsh

LangueFrançais

Config~/.claude/

Skills installés

48

5 catégories

Agents

24

sous-agents spécialisés

Workflows

8

pipelines actifs

Hooks

7

scripts de protection

Plugins

5

MCP · extensions

Projets

dev in progress

Grille

Guide TV iOS — application native Swift / SwiftUI. Projet principal du studio XII Development.

~/Xcode/grilleapp/ grilleapp.langeles.ovh ↗

₽

routine version

Finances-Weekly

Tableau de bord financier hebdomadaire — agrégation comptes + catégorisation auto + alertes budget personnalisées.

~/Web/finances-weekly/ finances.langeles.ovh ↗

⌂

coming soon

Home Assistant

Automatisations domotiques YAML — pilotage des périphériques via scénarios custom.

YAML / automatisations Config HA ↗

Outils système installés

Outil	Chemin	Usage
`swiftlint`	/opt/homebrew/bin/swiftlint	Analyse statique Swift (audit qualité)
`pandoc`	pandoc	Conversion Markdown → HTML/PDF
`weasyprint`	/opt/homebrew/bin/weasyprint	Moteur PDF HTML→PDF — gère emojis + CSS priorité
`pdflatex`	/Library/TeX/texbin/pdflatex	Moteur PDF fallback (BasicTeX)
`pango`	Homebrew	Dépendance système de weasyprint

Workflows & pipelines

5 pipelines spécialisés — orchestrent agents et skills en séquence

Étapes moyennes

par flow

5 étapes

Analyse → Plan → Implémentation → Review → Finalisation. Plan et review sont systématiquement séparés.

Modèles utilisés

répartition

sonnet

opus

Claude Sonnet 4.6

Modèle principal (12 agents). Opus 4.7 réservé aux étapes plan, audit et code review.

Couverture

domaines

iOS

Web

HA

3 domaines

Pipelines spécialisés iOS, Web et Home Assistant. Audit et release exclusivement iOS.

▦

/workflow-flow-ios

Feature iOS Swift — 5 étapes MVVM

available

1

Analyse sonnet ⚡ parallèle

explore-docs (Context7 + Apple HIG) + analyze-codebase, vérif branche, sauvegarde BASE_SHA + contexte pour --from.

2

Plan MVVM opus ⏸ pause

Plan structuré (fichiers, rôles, flux ViewModel → View) — validation explicite requise.

3

Implémentation opus

Code Swift/SwiftUI MVVM strict via agent-flow-implement, generators-scout, vérification LSP après chaque fichier.

4

Review sonnet

agent-flow-review : LSP + doc-sync + build/tests sur simulateur iOS découvert dynamiquement + diff Git, garde-fou 2 relances max.

5

Checklist

Documentation/Validation/YYYY-MM-DD_CHECKLIST_NOM.md, HTML + devsite, puis commit/push/changelog optionnels.

Options · 12

--hotfix · --refactor · --quick · --from <1-5> — mode de travail

--skip-docs · --skip-review · --skip-checklist — périmètre

--issue <n> · --context <fichier> · --perf · --a11y · --api — traçabilité et qualité ciblée

◉

/workflow-audit-ios

Audit sécurité + qualité iOS — 5 étapes

available

1

Exploration sonnet ⚡ parallèle

explore-project (cartographie) + explore-docs (Apple HIG) en parallèle.

2

Audit opus ⚡ parallèle

OWASP MASVS v2/MASTG + SwiftLint et diagnostics LSP, findings classés par sévérité.

3

Rapport ⏸ pause

Markdown généré dans Documentation/Audit/ — pause pour lecture du résumé exécutif.

4

BACKLOGS + HTML sonnet

Mise à jour BACKLOGS.md, export HTML interactif via agent-generator-html + devsite-publisher.

5

Application opus

agent-audit-apply applique les corrections choisies, validation LSP après chaque fix.

Options · 3

--security — audit-ios-security uniquement (OWASP MASVS/MASTG)

--quality — audit-ios-quality uniquement (architecture + SwiftLint)

--all — audit complet (comportement par défaut)

◷

/workflow-flow-web

Feature webapp/web — 4 étapes

beta

1

Analyse sonnet ⚡ parallèle

Docs framework via Context7 + MDN + WCAG (explore-docs), analyse stack et code existant (analyze-codebase).

2

Plan opus ⏸ pause

Plan structuré composants/pages, routing, state, styling — validation obligatoire avant implémentation.

3

Implémentation opus

Skill frontend-design, responsive mobile-first, états complets (hover/focus/loading/error/empty).

4

Review sonnet

web-design-guidelines (100+ règles) + webapp-testing (Playwright golden path), bilan final.

Options · 7

--skip-review · --quick · --checklist — périmètre

--framework <next|react|vue|vanilla|html> · --design-first — stack technique

--hotfix · --from <1-4> · --api · --a11y · --perf · --deploy — mode et qualité ciblée

◷

/workflow-audit-web

Audit design/UX + qualité code web — 5 étapes

beta

1

Exploration

Détecte le mode (fichier isolé / projet), liste HTML/CSS/JS, produit un manifest compact.

2

Audit opus ⚡ parallèle

audit-web-design (Web Interface Guidelines, contraste) + audit-web-quality (WCAG 2.2, SEO, sémantique).

3

Rapport sonnet ⏸ pause

agent-report-generator fusionne les findings DES/QUA — pause pour choix utilisateur.

4

BACKLOGS + HTML sonnet

Mise à jour BACKLOGS-WEB.md, conversion HTML via agent-generator-html, ouverture automatique.

5

Application opus

agent-apply-web applique les corrections HTML/CSS/JS selon la sévérité.

Options · 4

--design — audit-web-design uniquement

--quality · --all — audit-web-quality uniquement / audit complet

--visual — capture screenshot avant audit design

↑

/workflow-release-ios

Pré-release App Store — 4 étapes

progress

1

Release Review opus ⚡ parallèle

5 axes (sécurité, privacy, UX, distribution, API) + scan légal privacy manifest.

2

Conformité légale ⏸ pause

Skill legal — RGPD, privacy manifest, documents légaux, validation avant App Store.

3

App Store sonnet

agent-appstore-content génère le What's New depuis les commits Git et le contenu App Store.

4

Corrections opus

Application des points bloquants sélectionnés avant soumission.

Options

[chemin] — projet ciblé, défaut au répertoire courant

⌂

/workflow-flow-ha-yaml

Home Assistant YAML — automations, scripts, scènes

coming soon

◌◌◌

En cours de définition

⊞

/workflow-code-architecture

Scaffolding arborescence projet iOS/web

coming soon

◌◌◌

En cours de définition

◈

/workflow-claude-config

Sync docs + dashboard HTML config twelve/studio

beta

1

Sync documentation

Met à jour docs/, CLAUDE.md, README.md pour refléter l'état actuel de la config.

2

Génération HTML sonnet

agent-config-html génère le dashboard puis push vers GitHub (Louis-XII/.claude).

Options · 1

--no-push — génère le HTML sans pousser vers GitHub

Légende des badges d'étape

sonnetModèle Claude Sonnet — étape rapide / analyse

opusModèle Claude Opus — raisonnement profond

⚡ parallèlePlusieurs agents lancés simultanément

⏸ pauseArrêt obligatoire pour validation utilisateur

Skills installés

Slash commands globaux dans ~/.claude/skills/ — disponibles dans tous les projets

Workflows

Skill	Commande	Usage
`workflow-flow-ios`	/workflow-flow-ios	Développement feature iOS Swift — 5 étapes MVVM
`workflow-flow-web`	/workflow-flow-web	Développement webapp/web — 4 étapes, auto-détection stack
`workflow-release-ios`	/workflow-release-ios	Pré-release App Store — review, légal, App Store
`workflow-audit-ios`	/workflow-audit-ios	Audit sécurité + qualité iOS — SwiftLint + diagnostics LSP + rapport PDF
`workflow-audit-web`	/workflow-audit-web	Audit design/UX + qualité code web — WCAG 2.2, SEO, Web Interface Guidelines
`workflow-flow-ha-yaml`	/workflow-flow-ha-yaml	Home Assistant YAML — automations, scripts, scènes, blueprints (5 étapes)
`workflow-claude-config`	/workflow-claude-config	Sync docs + dashboard HTML config twelve/studio
`workflow-code-architecture`	/workflow-code-architecture	Scaffolding arborescence projet iOS/web — profils iOS MVVM / React / Next
`workflow-impots`	/workflow-impots	Remplissage automatique déclaration impôts depuis PDF fiscaux

iOS / Swift

Skill	Commande	Usage	Source
`ios-swift-development`	/ios-swift-development	MVVM, SwiftUI, URLSession, Combine, Core Data	aj-geddes
`swiftui-pro`	/swiftui-pro	SwiftUI best practices, APIs dépréciées, performance	twostraws
`swift-concurrency-pro`	/swift-concurrency-pro	async/await, actors, Sendable, Swift 6	twostraws
`ios-development`	/ios-development	iOS global — HIG, URLSession, patterns réseau	rshankras
`swift-development`	/swift-development	Swift idioms, concurrence, performance	rshankras
`design`	/design	Liquid Glass, animations, design system Apple	rshankras
`security`	/security	Keychain, biométrie, privacy manifest, OWASP	rshankras
`testing`	/testing	TDD iOS, characterization tests, snapshot tests	rshankras
`apple-intelligence`	/apple-intelligence	Foundation Models, App Intents, on-device AI	rshankras
`core-ml`	/core-ml	Core ML, Create ML, Vision framework	rshankras
`macos-development`	/macos-development	SwiftUI macOS, AppKit bridging, macOS 26	rshankras
`watchos`	/watchos	SwiftUI for Watch, Watch Connectivity	rshankras
`generators`	/generators	Génération de code boilerplate (networking, auth, paywall...)	rshankras
`release-review`	/release-review	Review avant soumission App Store	rshankras
`app-store`	/app-store	ASO, descriptions, screenshots, réponses aux avis	rshankras
`monetization`	/monetization	Stratégie de monétisation iOS	rshankras
`growth`	/growth	Acquisition, analytics, presse, communauté	rshankras
`legal`	/legal	Privacy policy, CGU, RGPD, conformité App Store	rshankras
`product-development`	/product-development	PRD, specs, planning produit	rshankras

Web

Skill	Commande	Usage	Source
`frontend-design`	/frontend-design	Interfaces production-grade — composants, pages, dashboards	anthropics/skills
`web-design-guidelines`	/web-design-guidelines	Audit 100+ règles UX, a11y, perf, responsive	vercel-labs
`webapp-testing`	/webapp-testing	Tests web via Playwright — golden path, UI, screenshots	anthropics/skills
`web-design-reviewer`	/web-design-reviewer	Review visuelle design web (local ou distant)	awesome-copilot
`design-md`	/design-md	Synthèse design system → fichier DESIGN.md	stitch-skills
`impeccable`	/impeccable	Review et amélioration d’interfaces — polish, animations, UX	pbakaus

Utilitaires

Skill	Commande	Usage	Source
`commit`	/commit	Commit Conventional Commits via git-agent	fradser
`requesting-code-review`	/requesting-code-review	Review avant merge	obra
`find-docs`	/find-docs	Docs à jour via Context7	context7
`find-skills`	/find-skills	Recherche de skills disponibles	vercel-labs
`doc-sync`	/doc-sync	Sync documentation miroir Grille	local
`claude-update-docs`	/claude-update-docs	Propage un changement dans toute la doc ~/.claude/	local
`skill-creator`	/skill-creator	Créer / améliorer des skills	anthropics/skills
`shared`	—	Templates de création de skills (interne à skill-creator)	anthropics/skills
`simplify`	/simplify	Review qualité du code modifié	intégré
`loop`	/loop	Tâche récurrente auto-cadencée	intégré
`schedule`	/schedule	Agents distants planifiés (cron)	intégré
`claude-api`	/claude-api	Apps Anthropic SDK avec prompt caching	intégré
`md-to-html`	/md-to-html	Convertit un .md en HTML interactif (TOC, dark mode, print→PDF)	local
`claude-config-export`	/claude-config-export	Génère et publie le dashboard HTML de configuration Claude Code	local

Finance

Skill	Commande	Usage	Source
`yfinance-data`	/yfinance-data	Prix, historique, dividendes via yfinance (sans clé API)	himself65
`finance-sentiment`	/finance-sentiment	Sentiment Reddit/X/news via Adanos Finance API	himself65
`etf-premium`	/etf-premium	Calcul premium/décote ETF vs NAV via Yahoo Finance	himself65
`finance-weekly`	/finance-weekly	Revue hebdo portefeuille → rapport HTML	local

Agents

Sous-processus spécialisés — contexte isolé, parallélisable

Agent	Modèle	Invoqué par	Rôle
`agent-config-html`	sonnet	/claude-config-export	Génère le dashboard HTML config depuis template + sources ~/.claude/
`agent-explore-docs`	sonnet	/workflow-flow-ios · 1 / /workflow-audit-ios · 1	Documentation Apple HIG + Developer Docs + Context7
`agent-analyze-codebase`	sonnet	/workflow-flow-ios · 1	Synthèse du code existant (signatures, types, MARK)
`agent-flow-plan`	opus	/workflow-flow-ios · 2	Plan MVVM structuré (fichiers, rôles, points techniques)
`agent-flow-implement`	opus	/workflow-flow-ios · 3	Implémentation Swift/SwiftUI complète selon plan validé
`agent-generators-scout`	sonnet	/workflow-flow-ios · 3	Identifie les templates generators applicables
`agent-flow-review`	sonnet	/workflow-flow-ios · 4	LSP + doc-sync + build + tests (simulateur iOS dynamique) + diff Git
`agent-checklist-generator`	sonnet	/workflow-flow-ios · 5	Génère la checklist de validation
`agent-devsite-publisher`	sonnet	/workflow-flow-ios · 5 / /workflow-audit-ios · 4	Organisation devsite/ + régénération index.html
`agent-explore-project`	sonnet	/workflow-audit-ios · 1	Cartographie du projet iOS avant audit
`audit-ios-security`	opus	/workflow-audit-ios · 2	Audit sécurité OWASP MASVS v2 + MASTG
`audit-ios-quality`	opus	/workflow-audit-ios · 2	Audit architecture + SwiftLint + diagnostics LSP + conformité HIG
`agent-report-generator`	sonnet	/workflow-audit-ios · 3 / /workflow-audit-web · 3	Fusion findings + rapport Markdown
`agent-generator-html`	sonnet	/workflow-audit-ios · 4 / /workflow-flow-ios · 5	Conversion Markdown → HTML interactif
`agent-audit-apply`	opus	/workflow-audit-ios · 5	Application des corrections d’audit avec validation LSP
`audit-web-design`	opus	/workflow-audit-web · 2	Audit design/UX — Web Interface Guidelines, contraste, responsive
`audit-web-quality`	opus	/workflow-audit-web · 2	Audit qualité — WCAG 2.2, SEO, HTML sémantique, performance JS
`agent-apply-web`	opus	/workflow-audit-web · 5	Application des corrections HTML/CSS/JS issues de l’audit
`agent-release-code-review`	opus	/workflow-release-ios · 1	Review sécurité, privacy, UX, distribution, API
`agent-release-legal-scan`	sonnet	/workflow-release-ios · 1	Scan privacy manifest, APIs déclarées, légal
`agent-appstore-content`	sonnet	/workflow-release-ios · 3	Génération What’s New et contenu App Store
`agent-pencil-designer`	opus	Manuel	Design UI/UX dans fichiers .pen via MCP Pencil
`agent-analyze-ha`	sonnet	/workflow-flow-ha-yaml · 1	Analyse contexte HA — fichiers SMB + entités MCP
`agent-changelog`	sonnet	Fin de pipeline (workflow-flow-ios · 5, workflow-audit-ios · 4)	Génère CHANGELOG.html depuis CHANGELOG.md

Hooks & Protection

Scripts exécutés automatiquement — configurés dans ~/.claude/settings.json

swift_main_guard.py

PreToolUse · Write/Edit (.swift) · projet iOS

Bloque toute écriture sur un fichier .swift quand la branche courante est main.

Si branche = main, retourne une erreur et bloque l'outil. Oblige à travailler sur feature/ ou hotfix/.

yaml_write_guard.py

PreToolUse · Write/Edit (.yaml/.yml) · global

Bloque toute écriture YAML sans confirmation explicite de l'utilisateur.

Vérifie la présence de /tmp/.yaml_write_auth — créé par Claude après confirmation, consommé après l'écriture. Protège les configs Home Assistant.

commit_format_check.py

PreToolUse · Bash(git commit*) · global

Valide le format Conventional Commits avant chaque git commit.

Format requis type(scope): description — types valides feat/fix/refactor/docs/style/test/chore/hotfix/perf/ci/build/revert. ✓ vert si conforme, bloquant sinon.

bump_build_number.py

PreToolUse · Bash(git commit*) · projet Xcode

Incrémente CURRENT_PROJECT_VERSION avant chaque commit sur un projet Xcode. nouveau

Bumpe uniquement la valeur max (target principal) dans project.pbxproj et la stage automatiquement (git add). Ne fait rien si le repo n'est pas un projet Xcode.

Sécurité Bash

PreToolUse · Bash · global

Bloque les commandes destructives avant exécution.

Bloque rm -rf / et git push --force main / -f main. Configuré inline dans settings.json.

Stop · fin de session

Stop · fin de chaque session

Log session + son de fin.

Enregistre date | répertoire courant dans session-log.txt et joue Glass.aiff.

statusline.py

Continu · barre de statut

Affiche workflow en cours, modèle, tokens, branche Git, quotas.

Segments : workflow actif, branche Git, modèle · effort · tokens session, context window, rate limits 5h/7j.

Format Conventional Commits

feat fix refactor docs style test chore hotfix perf ci build revert

✓feat(favoris): ajout filtre par chaîne

✓fix: crash tableau vide

✓chore: nettoyage imports inutilisés

✗ajout feature favoris

✗WIP

Installation swift_main_guard

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "python3 ~/.claude/hooks/swift_main_guard.py"
          }
        ]
      }
    ]
  }
}

Plugins

Extensions externes (MCP) connectées à Claude Code — installées via claude mcp add

C7

context7

MCP · documentation

Documentation à jour pour 1000+ librairies via la commande /find-docs.

Idéal pour SwiftUI, React, FastAPI : récupère les docs officielles versionnées en temps réel.

actif

PW

playwright-mcp

MCP · tests web

Tests navigateur automatisés utilisés par le skill webapp-testing.

Navigation headless, capture DOM, screenshots — valide le golden path lors de la review web.

actif

XC

xcode-build-mcp

MCP · Xcode iOS

Build et exécution des tests iOS sur simulateur.

Découverte dynamique du simulateur disponible (préfère iPhone 17 Pro), XCTest via xcodebuild test.

actif

HA

home-assistant-mcp

MCP · domotique

Accès aux entités, états et services Home Assistant.

Utilisé par /workflow-flow-ha-yaml — lecture entités + reload automations après écriture YAML.

actif

Pe

pencil

MCP · design UI/UX

Création et édition de fichiers .pen — design web et mobile.

Utilisé par agent-pencil-designer (Opus) — palette twelve/studio appliquée par défaut.

actif

Installer un nouveau plugin

claude mcp add <nom> <commande>
# Exemple
claude mcp add context7 npx -y @upstash/context7-mcp
claude mcp list                # plugins installés
claude mcp remove <nom>        # désactiver

Conventions

Règles de code et style Git appliquées sur tous les projets

iOS / Swift

Architecture MVVM stricte

Logique dans les ViewModels, pas dans les Views. SwiftUI en priorité, UIKit uniquement si nécessaire (ex : scroll synchronisé).

Nommage Swift

PascalCase pour les types, camelCase pour propriétés et méthodes. Pas de force unwrap (!) sauf cas justifié explicitement.

Variables en début de bloc

Variables et constantes déclarées en début de fonction, struct, class ou View — jamais dispersées dans le corps.

Commentaires de navigation

// MARK: - obligatoires sur chaque bloc logique, fonction, section de View et extension. Commentaires en français.

Palette Grille

Fond sombre

#001524

Fond clair

#F8F6F0

Texte

#FFFFFF

Accent bleu

#4F8EFF

Accent violet

#4F46E5

Git Flow

Branches main (stable) · feature/ · hotfix/. Ne jamais committer sans demande explicite.

Conventional Commits

Format type(scope): description obligatoire — validé automatiquement par le hook commit_format_check.py.

BACKLOGS.md

Centralise les findings d'audit par sévérité, numérotation continue par axe (SEC/QUA/PERF/LEG), déplacés vers ✅ Traités une fois corrigés.

Structure ~/.claude

~/.claude/
├── CLAUDE.md                    ← instructions globales
├── README.md                    ← index de la config
├── settings.json                ← hooks + permissions globaux
├── docs/                        ← documentation détaillée
│   ├── hooks.md
│   ├── agents.md
│   ├── skills.md
│   ├── workflow-flow-ios.md
│   ├── workflow-flow-web.md
│   ├── workflow-audit-ios.md
│   ├── workflow-audit-web.md
│   ├── workflow-release-ios.md
│   ├── workflow-flow-ha-yaml.md
│   └── statusline.md
│
├── agents/                      ← sous-agents spécialisés (24 agents)
├── skills/                      ← skills globaux (48 skills)
├── assets/                      ← templates HTML, scripts
├── hooks/                       ← scripts de protection
└── memory/                      ← mémoire persistante

Mémoire

Entrées préservées entre les sessions — ~/.claude/projects/-Users-louis--claude/memory/

Workflow flow-ios

Pipeline iOS 5 étapes, 12 options, agents parallèles (explore-docs + analyze-codebase), checklist finale, BACKLOGS.md.

Workflow audit-ios

Audit iOS 5 étapes, agents parallèles, rapport PDF brandé (weasyprint + couleurs CLAUDE.md + logo auto), archivage + BACKLOGS.md.

Classification audit iOS

4 axes SEC/QUA/PERF/LEG, numérotation continue (lire BACKLOGS avant d'assigner les IDs).

workflow-claude-config

Workflow 2 étapes (sync docs + export HTML), dashboard config twelve/studio. Règle absolue : images via Bash base64 jamais Read tool.

Doc structure ~/.claude

README.md restructuré en index léger — détails extraits dans docs/ (hooks.md, agents.md, workflow-*.md, skills.md). Mettre à jour docs/ à chaque création/modif hook/agent/skill/workflow.

Doc avant commit

Étape 5.7 workflow-flow-ios : demander README.md + CLAUDE.md local + mémoire avant /commit.

Installation skills

Après npx skills add, convertir les symlinks en copies réelles (rm symlink + cp -r depuis ~/.agents/skills/).

Structure workflow ~/.claude

SKILL.md orchestrateur + fichiers étapes numérotés + statusline echo "nom:N:total" + doc workflow-nom.md.

Structure agent ~/.claude

Frontmatter (name/description/model/color) + corps (mission, processus, ce que tu retournes) + naming agent- + entrée docs/agents.md.

Système changelog

Hook PostToolUse (update_changelog.py) + agent-changelog + template-changelog.html (CSS-only timeline). Règle : \n\n## requis pour pandoc.

Templates HTML interactifs

4 templates autonomes (audit/backlogs/checklist/tests) + devsite-index 6 tuiles. Sidebar liquid glass, Geist, injection %%CONTENT%% pandoc brut.

URLs projets XII

Dashboard · Grille · Finance Weekly (langeles.ovh).

Workflow flow-ha-yaml

Pipeline 5 étapes, agent-analyze-ha, MCP HA (/api/mcp), SMB /Volumes/config, yaml_write_guard hook.

Réinstallation config Claude

Procédure Mac neuf : clone github.com/Louis-XII/.claude (privé) + recréer settings.local.json (secrets) + brew install pandoc/weasyprint/swiftlint/jq + plugins.

Règles générales

Appliquées à tous les projets ouverts avec Claude Code

Toujours lire le code avant de proposer une modification.
Proposer un plan et attendre validation avant d'implémenter.
Ne pas ajouter de fonctionnalités non demandées.
Ne pas créer de fichiers inutiles.
Pas de secrets / credentials dans le code ou les commits.