Identité & Contexte
Vue d’ensemble
Louis-XII
XII Development
Développeur iOS natif — SwiftUI + UIKit • Domotique Home Assistant • macOS / zsh
Configuration installée
42
Skills
17
Agents
5
Workflows
5
Hooks actifs
Environnement
Modèle principal
claude-sonnet-4-6
Agents Opus (plan/audit)
claude-opus-4-7
Agents Sonnet
claude-sonnet-4-6 — 12 agents
Agents Opus
claude-opus-4-7 — 5 agents
Langue
Français
Plateforme
macOS darwin 25.4.0
Shell
zsh
Config globale
~/.claude/
Projets actifs
Grille
Guide TV iOS — application native Swift/SwiftUI. Projet principal du studio XII Development.
/Users/louis/Xcode/grilleapp/
Home Assistant
Automatisations domotiques YAML — piloter les périphériques via des scénarios custom.
YAML / automatisations
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 |
Pipelines de travail
Workflows
5 pipelines spécialisés — chacun orchestre des agents et des skills en séquence.
/flow-ios <feature> [options]Développement feature iOS Swift — 5 étapes MVVM
1
Analyse claude-sonnet-4-6 ⚡ parallèle
Branche Git vérifiée,
agent-explore-docs + agent-analyze-codebase lancés en parallèle.2
Plan claude-opus-4-7 ⏸ pause
Plan MVVM structuré (fichiers, rôles, flux de données). Pause obligatoire avant implémentation.
3
Implémentation claude-opus-4-7
Code Swift/SwiftUI MVVM strict. Conventions : variables en début de bloc, MARK obligatoires, commentaires FR.
4
Review claude-sonnet-4-6
agent-flow-review : doc-sync + build iPhone 17 Pro + analyse diff Git.5
Checklist claude-sonnet-4-6
Génère
Documentation/Validation/YYYY-MM-DD_CHECKLIST_NOM.md + HTML sur le Bureau.Options
--hotfix — Branche hotfix/, plan condensé, focus non-régression pour corrections urgentes.--refactor — Adapte le workflow pour refacto : accent sur la non-régression, pas de nouvelle feature.--quick — Combine --skip-docs + --skip-review + checklist allégée pour un cycle ultra-rapide.--skip-docs — Saute le doc-sync à l'étape 4.--skip-review — Saute la review de code à l'étape 4.--skip-checklist — Saute la génération de checklist à l'étape 5.--issue <n> — Branche feature/n-nom, commit closes #n, en-tête checklist.--from <étape> — Reprend à l'étape indiquée (1–5) sans relancer les précédentes.--perf — Ajoute critères de performance à la review et à la checklist.--a11y — Renforce les checks accessibilité (VoiceOver, Dynamic Type, contraste).--api — Feature réseau : ajoute cases gestion d'erreur, états de chargement et timeouts.--context <fichier> — Lit un fichier de specs ou une maquette dès l'étape 1./audit-ios [chemin] [options]Audit sécurité + qualité iOS — rapport HTML interactif
1
Exploration claude-sonnet-4-6 ⚡ parallèle
agent-explore-project (cartographie) + agent-explore-docs (docs Apple HIG) en parallèle.2
Audit claude-opus-4-7 ⚡ parallèle
audit-ios-security (OWASP MASVS v2) + audit-ios-quality (SwiftLint + HIG) en parallèle.3
Rapport claude-sonnet-4-6 ⏸ pause
agent-report-generator génère le Markdown dans Documentation/Audit/. Pause après lecture du résumé.4
BACKLOGS + HTML claude-sonnet-4-6
Alimente
BACKLOGS.md + agent-generator-html → fichiers HTML sur le Bureau.5
Application claude-opus-4-7
agent-audit-apply applique les corrections par sévérité décroissante (Critique → Faible).Options
--security — Lance uniquement l'audit sécurité OWASP MASVS v2 + MASTG (skip qualité).--quality — Lance uniquement l'audit architecture, SwiftLint et conformité HIG (skip sécurité).--all — Lance les deux audits en parallèle (comportement par défaut)./release-ios [chemin]Pré-release App Store — 4 étapes
1
Release Review claude-opus-4-7 ⚡ parallèle
agent-release-code-review (Opus, 5 axes) + agent-release-legal-scan (Sonnet) en parallèle.2
Conformité légale claude-sonnet-4-6
Skill
legal : RGPD, privacy manifest, documents légaux, conformité App Store.3
App Store claude-sonnet-4-6 ⏸ pause
agent-appstore-content génère le What's New depuis Git. Bilan consolidé + pause.4
Corrections claude-opus-4-7
Application des points bloquants par ordre de priorité (sécurité/privacy → légal → UX).
Pas d'options paramétrables
Le chemin du projet est passé en argument. Sans argument, utilise le répertoire courant.
/flow-web <feature> [options]Développement webapp/web — 4 étapes, auto-détection stack
1
Analyse claude-sonnet-4-6 ⚡ parallèle
Détection stack depuis
package.json + agent-explore-docs / agent-analyze-codebase en parallèle.2
Plan claude-opus-4-7 ⏸ pause
Plan structuré adapté à la stack détectée. Pause obligatoire avant implémentation.
3
Implémentation claude-opus-4-7
Skill
frontend-design en priorité — qualité production-grade, états complets (hover, focus, loading, error, empty).4
Review claude-sonnet-4-6
Audit
web-design-guidelines 100+ règles + tests Playwright via webapp-testing.Options
--framework <nom> — Impose explicitement le framework (React, Vue, etc.).--design-first — Priorise la qualité visuelle et le système de design avant la logique.--hotfix — Mode correction rapide, skip analyse approfondie.--a11y — Renforce les critères d'accessibilité WCAG dans la review.--perf — Ajoute critères Core Web Vitals et de performance dans la review.--api — Focus sur les endpoints et la gestion d'erreur réseau.--deploy — Inclut une étape de déploiement après la review./flow-ha <automatisation>Home Assistant YAML — 5 étapes under progress
1
Analyse
Comprendre l'automatisation ou l'entité concernée.
2
Planification
Proposer la structure YAML adaptée.
3
Implémentation
Ecrire le YAML valide et commenté.
4
Validation
Vérifier la syntaxe et la logique de l'automatisation.
5
Finalisation
Documenter le changement et vérifier l'intégration dans Home Assistant.
Pas d'options paramétrables
Slash Commands
Skills installés
Skills globaux dans
~/.claude/skills/ — disponibles dans tous les projets.Workflows
| Skill | Commande | Usage |
|---|---|---|
flow-ios | /flow-ios | Développement feature iOS Swift — 5 étapes MVVM |
flow-web | /flow-web | Développement webapp/web — 4 étapes, auto-détection stack |
release-ios | /release-ios | Pré-release App Store — review, légal, App Store |
audit-ios | /audit-ios | Audit sécurité + qualité iOS — rapport HTML |
flow-ha | /flow-ha | Automatisations Home Assistant YAML |
Utilitaires
| Skill | Commande | Usage | Source |
|---|---|---|---|
commit | /commit | Commit Conventional Commits via git-agent | fradser/dotclaude |
requesting-code-review | /requesting-code-review | Review avant merge | obra/superpowers |
find-docs | /find-docs | Docs à jour via Context7 | context7 |
find-skills | /find-skills | Recherche de skills disponibles | vercel-labs/skills |
doc-sync | /doc-sync | Sync documentation miroir Grille | local |
update-docs | /update-docs | Propage un changement dans toute la doc ~/.claude/ | local |
skill-creator | /skill-creator | Créer / améliorer des skills | 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 |
iOS / Swift — développement
| 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 |
Web — développement
| 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/agent-skills |
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) | github/awesome-copilot |
design-md | /design-md | Synthèse design system → fichier DESIGN.md | google-labs-code/stitch-skills |
Finance
| Skill | Commande | Usage | Source |
|---|---|---|---|
yfinance-data | /yfinance-data | Prix, historique, dividendes via yfinance (sans clé API) | himself65/finance-skills |
finance-sentiment | /finance-sentiment | Sentiment Reddit/X/news via Adanos Finance API | himself65/finance-skills |
etf-premium | /etf-premium | Calcul premium/décote ETF vs NAV via Yahoo Finance | himself65/finance-skills |
finance-weekly | /finance-weekly | Rapport HTML hebdo portefeuille (orchestre yfinance + etf-premium + sentiment) | local |
Sous-processus spécialisés
Agents
Fichiers de définition dans
~/.claude/agents/. Chaque agent s’exécute dans un contexte isolé — préserve le contexte principal et permet la parallélisation.| Agent | Modèle | Invoqué par | Rôle |
|---|---|---|---|
agent-config-html |
claude-sonnet-4-6 | /claude-config-export |
Génère le dashboard HTML config depuis template + sources ~/.claude/ |
agent-explore-docs |
claude-sonnet-4-6 | /flow-ios étape 1, /audit-ios étape 1 |
Documentation Apple HIG + Developer Docs + Context7 — synthèse actionnable |
agent-analyze-codebase |
claude-sonnet-4-6 | /flow-ios étape 1 |
Synthèse du code existant (signatures, types, MARK) — protège le contexte principal |
agent-flow-plan |
claude-opus-4-7 | /flow-ios étape 2 |
Plan MVVM structuré (fichiers, rôles, points techniques) |
agent-flow-implement |
claude-opus-4-7 | /flow-ios étape 3 |
Implémentation Swift/SwiftUI complète selon plan validé |
agent-generators-scout |
claude-sonnet-4-6 | /flow-ios étape 3 (via agent-flow-implement) |
Identifie les templates generators applicables |
agent-flow-review |
claude-sonnet-4-6 | /flow-ios étape 4 |
doc-sync + build iPhone 17 Pro + analyse diff Git |
agent-checklist-generator |
claude-sonnet-4-6 | /flow-ios étape 5 |
Génère la checklist de validation post-implémentation |
agent-explore-project |
claude-sonnet-4-6 | /audit-ios étape 1 |
Cartographie du projet iOS avant audit |
audit-ios-security |
claude-opus-4-7 | /audit-ios étape 2 |
Audit sécurité OWASP MASVS v2 + MASTG |
audit-ios-quality |
claude-opus-4-7 | /audit-ios étape 2 |
Audit architecture + SwiftLint + conformité HIG |
agent-report-generator |
claude-sonnet-4-6 | /audit-ios étape 3 |
Fusion findings + rapport Markdown dans Documentation/Audit/ |
agent-generator-html |
claude-sonnet-4-6 | /audit-ios étape 4, /flow-ios étape 5, /md-to-html |
Conversion Markdown → HTML interactif auto-contenu sur le Bureau |
agent-audit-apply |
claude-opus-4-7 | /audit-ios étape 5 |
Application des corrections d'audit par sévérité décroissante |
agent-release-code-review |
claude-opus-4-7 | /release-ios étape 1 |
Review sécurité, privacy, UX, distribution, API (5 axes) |
agent-release-legal-scan |
claude-sonnet-4-6 | /release-ios étape 1 |
Scan privacy manifest, APIs déclarées, légal |
agent-appstore-content |
claude-sonnet-4-6 | /release-ios étape 3 |
Génération What's New et contenu App Store depuis commits Git |
Scripts automatiques
Hooks & Protection
Scripts exécutés automatiquement par Claude Code. Configurés dans
~/.claude/settings.json.Hooks actifs
swift_main_guard.py
PreToolUse — Write|Edit (.swift) — projet iOS
Bloque toute écriture sur un fichier
.swift quand la branche courante est main.Déclencheur : tentative d'écriture ou modification d'un fichier
.swift. Si branche = main, retourne une erreur et bloque l'outil. Oblige à travailler sur feature/ ou hotfix/.commit_format_check.py
PreToolUse — Bash(git commit*) — global
Valide le format Conventional Commits avant chaque
git commit -m.Parse le message, vérifie le format
type(scope): description et les types valides. Affiche ✓ Format commit valide en vert si OK — bloque avec erreur rouge si non conforme.Sécurité Bash
PreToolUse — Bash — global
Bloque deux commandes destructives avant exécution.
Script inline dans
settings.json. Intercepte la suppression système et les force push sur la branche principale. Retourne une erreur bloquante avec explication.Stop — fin de session
Stop — fin de chaque session Claude Code
Enregistre la session et joue un son de notification.
Deux actions : (1) log
date | répertoire courant dans ~/.claude/session-log.txt ; (2) joue Glass.aiff (macOS) en arrière-plan via afplay.statusline.py
Continu — Status Line
Affiche en temps réel dans l'interface Claude Code.
Affiche : tokens utilisés dans la session, heure courante, branche Git courante. Configuré dans
settings.json → statusLine. Script : ~/.claude/statusline.py.Format Conventional Commits
Types valides — le hook bloque tout commit non conforme :
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 sur un nouveau projet iOS
Ajouter dans .claude/settings.json du projet :
{
"hooks": {
"PreToolUse": [
{
"matcher": "Write|Edit",
"hooks": [
{
"type": "command",
"command": "python3 ~/.claude/hooks/swift_main_guard.py",
"statusMessage": "Verification branche Swift..."
}
]
}
]
}
}
Règles de code
Conventions
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
PascalCase pour les types. camelCase pour les propriétés et méthodes. Pas de force unwrap (!) sauf cas justifié explicitement.Variables & constantes
Déclarées en début de bloc (fonction, struct, class, View) — jamais dispersées dans le corps du bloc.
Commentaires de navigation
Commentaires
// MARK: - obligatoires pour chaque bloc logique, fonction, section de View et extension.Commentaires en français
Tous les commentaires dans le code sont en français. Les termes techniques, identifiants et noms de fichiers restent dans leur forme originale.
Palette Grille
Fond sombre#001524
Fond clair#F8F6F0
Texte#FFFFFF
Accent bleu#4F8EFF
Accent violet#4F46E5
Git Flow
Branches
main — branche stable, jamais de code directement. feature/ — nouvelles fonctionnalités. hotfix/ — corrections urgentes.Commits
Format Conventional Commits obligatoire (
feat:, fix:, refactor:…). Jamais de commit sans demande explicite de l'utilisateur.BACKLOGS.md
Fichier
Documentation/BACKLOGS.md dans chaque projet. Findings d'audit archivés par criticité. Les items corrigés migrent vers la section ✓ lors de l'application.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 HTML (weasyprint + couleurs CLAUDE.md + logo auto), archivage + BACKLOGS.md
claude-config-export + agent-config-html
Dashboard HTML config XII Development, règle absolue images via Bash (jamais Read tool sur binaires)
README.md restructuré
Index léger — détails extraits dans
docs/ (hooks.md, agents.md, workflow-flow-ios.md, workflow-audit-ios.md, skills.md)Doc structure ~/.claude
Mettre à jour
docs/ quand on crée/modifie hooks, agents, skills ou workflowsInstallation skills
Après
npx skills add, convertir les symlinks en copies réelles (cp -r depuis ~/.agents/skills/)Collaboration
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.
Structure des fichiers ~/.claude
~/.claude/
├── CLAUDE.md ← instructions globales
├── README.md ← index de la configuration
├── settings.json ← hooks, status line
├── statusline.py ← script status line
│
├── docs/ ← documentation détaillée
│ ├── hooks.md
│ ├── agents.md
│ ├── skills.md
│ ├── workflow-flow-ios.md
│ ├── workflow-flow-web.md
│ ├── workflow-audit-ios.md
│ └── workflow-release-ios.md
│
├── agents/ ← sous-agents spécialisés (17 agents)
├── skills/ ← skills globaux (42 skills)
├── assets/ ← template HTML, scripts
├── hooks/ ← scripts de protection
└── memory/ ← mémoire persistante