Spécification projet — ulk

Document généré par l’agent Shuri (01) en mode orchestré (CONTEXTE PROJET fourni). Sources : code source + docs reverse-engineerées par Strange (16) + brief projet.

1. Contexte et objectifs

1.1 À propos du nom

Bruce (nom réel Ulk) est un Swedish Vallhund — une race de chien viking millénaire, trapue et intrépide, surnommée “le chien des Vikings”. Comme son ancêtre qui accompagnait les drakkars à travers les mers nordiques, Ulk accompagne les développeurs à travers les océans de code.

“Ulk” signifie “loup” en vieux norrois. Car sous ses airs adorables, Bruce est un gardien féroce de la qualité du code.

1.2 Vision

ulk est un AI Development Toolkit open-source qui étend Claude Code (CLI officiel d’Anthropic) avec un écosystème de 46+ agents spécialisés couvrant l’intégralité du cycle de développement logiciel — de la spécification au déploiement, en passant par l’audit, le débogage et la synchronisation.

Mission : Devenir le standard pour le développement assisté par IA, en fournissant aux développeurs un compagnon intelligent, frugal en tokens, et progressivement extensible.

1.3 Objectifs

Objectif	Description	Mesure
Automatisation AI	46+ agents spécialisés couvrant tout le cycle dev	Nombre d’agents actifs
Frugalité contexte	CLI-first + context-protocol pour économiser les tokens LLM	-30% tokens via context-protocol
Installation légère	Une commande pour installer, zéro configuration	`curl \| bash` ou `install.sh`
Orchestration intelligente	Bruce + Blackemperor comme points d’entrée uniques	Réduction du temps de démarrage
Mémoire persistante	7 subagents avec auto-memory inter-sessions	Sessions reprises sans reconnaissance
Extensibilité	Skills CLI, agents custom, blueprints métier	SDK agents en roadmap
Documentation vivante	Site GitHub Pages + génération automatique	Auto-deploy sur push

1.4 Auteur

Mathieu Drouet (alias izo) — créateur et mainteneur principal. Usage quotidien en développement, publication open-source pour la communauté Claude Code.

2. Problème à résoudre

2.1 Problèmes identifiés

Problème	Impact	Solution ulk
Claude Code sans mémoire inter-sessions	Perd le contexte à chaque session	Subagents avec `memory: local`
Consommation de tokens excessive	Coûts élevés, sessions courtes	CLI-first + context-protocol
Agents monolithiques non réutilisables	Chaque projet repart de zéro	46+ agents spécialisés installables
Pas de workflow documentaire standardisé	Docs obsolètes, spec inexistante	Pipeline Shuri (spec → todo → sync)
Orchestration manuelle des tâches	Pertes de temps, oublis	Bruce + task-runner avec Kanban
Pas de standard pour le dev assisté par IA	Pratiques inconsistantes	ulk comme référence méthodologique

2.2 Contraintes structurelles

Zéro dépendance npm à la racine — intentionnel, pour ne pas imposer un runtime
CLI-first — préférer les outils CLI (gh, vercel, neonctl…) aux MCP pour réduire la consommation de contexte
Règle des 50% — ne jamais dépasser 50% du contexte LLM en session
Idempotence — install.sh re-exécutable sans effets de bord
Non-destructif — les agents ne suppriment jamais de contenu manuel

3. Utilisateurs et cas d’usage

3.1 Profils utilisateurs

Profil	Description	Usage principal
Solo developer (primaire)	Mathieu Drouet, usage quotidien	Orchestration complète via Bruce
Développeur Claude Code (secondaire)	Communauté CLI, early adopters	Installation d’agents spécifiques
Équipe de développement (futur)	Partage de conventions et workflows	Blueprints métier, Agent Teams

3.2 Cas d’usage principaux

Démarrage de projet

Utilisateur: "bruce go"
→ Godspeed diagnostic → Shuri spec → Shuri todo → Task-runner
→ Projet structuré, backlog priorisé, convention documentées

Session de développement

Utilisateur: "next"
→ Bruce consulte todo.md → Task-runner exécute → 2b3 checkpoint
→ Tâche implémentée, testée, commitée, docs mises à jour

Audit et qualité

Utilisateur: "audit all" (via Bruce)
→ Blackemperor mode=audit → Vision + Perf-auditor + A11y (parallèle)
→ Rapport consolidé + todo.md enrichi

Correction d’erreurs

Utilisateur: "fix" ou "fix #42"
→ Bruce → Robocop → Diagnostic → Fix → Vérification → Close issue

Synchronisation documentation

Utilisateur: "sync"
→ Brigitte → Linear/Notion bidirectionnel
→ Bifrost pour import/export Notion ponctuels

Fin de session

Utilisateur: "checkpoint"
→ 2b3 → Diff code → Conformité CLAUDE.md → Update docs → Commit

4. Portée (Scope)

4.1 In scope (v3.x — actuel)

4.2 Out of scope (v3.x)

❌ Interface web de gestion des agents (futur dashboard)
❌ Exécution d’agents sans Claude Code (dépendance au runtime Anthropic)
❌ Bridge JS ↔ Swift finalisé (schemas définis, bridge non implémenté)
❌ Multi-utilisateur / partage en temps réel
❌ SDK officiel pour agents custom (roadmap v4)

4.3 Roadmap (futur)

Priorité	Fonctionnalité	Description
P1	Bundles agents	Consolidation en bundles thématiques (Frontend, Backend, Mobile)
P1	Blueprints métier	Templates complets SaaS / Mobile / Legacy
P1	packages/core	Bibliothèque TypeScript partagée (parser, types, GitHub client)
P2	packages/status-board	Dashboard local de suivi projet
P2	SDK agents custom	API pour créer des agents compatibles ulk
P2	Optimisation ulk.png	Image 1.8MB à compresser
P3	packages/apple	App macOS SwiftUI via package
P3	Nested Agent Teams	Équipes d’agents hiérarchiques

5. Architecture et choix techniques

5.1 Stack

Couche	Technologie	Justification
Runtime agents	Claude Code CLI (Anthropic)	Runtime officiel, intégration native
Langage agents	Markdown + frontmatter YAML	Auto-documenté, diff-able, zéro dépendance
Générateur docs	Node.js sans dépendances	Cheatheet — portable, léger
Site web	HTML/CSS statique	GitHub Pages, zéro infrastructure
App native	Swift / SwiftUI (macOS)	clients/app-apple/
Schemas	JSON Schema draft-07	Cross-platform JS ↔ Swift
CI/CD	GitHub Actions	Auto-deploy + cron hebdomadaire
Gestion source	Git + gh CLI	Standard, CLI > MCP

5.2 Principes architecturaux

Convention over configuration — la structure des dossiers définit le comportement
CLI-first over MCP — 0 token de contexte pour les CLI vs N tokens pour les MCP
Zéro dépendance — aucun package.json à la racine, aucun node_modules
Agents as code — chaque agent est un fichier Markdown auto-descriptif et versionnable
Context frugality — chaque token compte, protocoles d’économie intégrés à tous les niveaux
Séparation des responsabilités — agents locaux (shuri) vs externes (brigitte) vs one-shot (bifrost)

5.3 Structure du monorepo

ulk/
├── agents/                     # Sources des agents (46+ fichiers .md)
│   ├── _shared/                # 8 protocoles partagés
│   ├── 10-analyze/             # Analyseurs de stack (5 agents)
│   ├── 11-deploy/              # Déploiement (5 agents)
│   ├── 12-test/                # Tests (2 agents)
│   ├── 15-frontend/            # Suite frontend (7 agents + checklists)
│   └── agents-vps/             # Suite VPS (optionnelle)
├── commands/                   # Miroir installable (symlinké via install.sh)
├── skills/                     # 12 skills CLI custom (ulk-*/SKILL.md)
├── schemas/                    # 10 JSON schemas cross-platform
├── .claude/
│   ├── agents/                 # 7 subagents avec mémoire persistante
│   └── rules/                  # 6 règles path-specific
├── clients/app-apple/          # App macOS SwiftUI (34 fichiers Swift)
├── site/                       # GitHub Pages (index.html + data/)
├── cheatheet/                  # Générateur de documentation (Node.js)
├── tools/                      # Registre CLI + diagnostic
├── install.sh                  # Installation locale (symlinks)
├── install-remote.sh           # Installation distante (copie)
└── uninstall.sh                # Désinstallation

5.4 Modèle de distribution des agents

Modèle	Agents	Usage
opus	6 agents	Orchestrateurs complexes : Bruce, Blackemperor, Robocop, Strange, Sargeras, Rodin
sonnet	40+ agents	Spécialistes : audits, génération, sync, analyse

5.5 Philosophie CLI-first

CLI disponible     → l'utiliser (0 tokens de contexte)
CLI absent + MCP   → utiliser le MCP
Ni l'un ni l'autre → informer l'utilisateur

CLI	Remplace	Catégorie
`gh`	GitHub MCP	VCS
`vercel`	Vercel MCP	Deploy
`neonctl`	Neon MCP	Database
`gws`	Google Calendar/Gmail MCP	Productivity

MCP maintenus (pas de CLI viable) : Figma, Notion, Linear.

6. Système d’agents

6.1 Point d’entrée principal

Bruce (25) — Orchestrateur PM. Auto-détecte l’état du projet via Godspeed, orchestre les autres agents.

Commande	Action
`go`	Lance l’action la plus logique
`status`	Relance Godspeed diagnostic
`next`	Prochaine tâche dans todo.md
`fix`	Dispatche Robocop
`audit` / `audit all`	Audit code / audits parallèles
`review`	Review complétude via Blackemperor
`ship`	Blackemperor mode=ship
`sync`	Brigitte (Notion/Linear)

6.2 Agents principaux

#	Agent	Modèle	Mission
00	Godspeed	sonnet	Diagnostic projet (stack, état, suggestions)
01	Shuri	sonnet	Pipeline doc : spec → todo Kanban → sync locale
04	Task-runner	sonnet	Exécution et suivi de tâches depuis todo.md
05	Vision	sonnet	Audit code 8 dimensions (score /10) + simplification
06	A11y-auditor	sonnet	Audit accessibilité WCAG 2.1/2.2
07	Perf-auditor	sonnet	Audit performance (Core Web Vitals, bundle, backend)
08	2b3	sonnet	Checkpoint fin de session (diff → conformité → commit)
09	Friday	sonnet	Docs manager : context.md snapshot + organisation /docs
11	Robocop	opus	Détective et fixeur d’erreurs (runtime, compile, tests, lint)
16	Strange	opus	Documentation inversée depuis le code source
17	Agamotto	opus	Reverse design system (Figma/Pencil/Penpot → tokens)
18	Blackemperor	opus	Orchestrateur 5 modes (audit/legacy/release/review/ship)
21	Bifrost	sonnet	Pont Notion : import + export QA
24	Brigitte	sonnet	Sync Notion/Linear bidirectionnel + communications
25	Bruce	opus	Point d’entrée principal — PM orchestrateur
26	Picsou	sonnet	Estimation coûts hébergement multi-providers
27	Steve	sonnet	Orchestrateur Apple : web → API → SwiftUI starter
31	Ranma	sonnet	Planificateur de migration inter-stacks
32	SEO-auditor	sonnet	Audit SEO & GEO (technique, on-page, AI citations)
34	Gandalf	sonnet	Gardien de santé contexte (50% rule, hygiène de session)
35	Project-decomposer	sonnet	Specs → prompts Claude Code autonomes
38	Sensei	sonnet	Mode apprentissage : explications, diagrammes, HTML
39	Obsidian-vault	sonnet	Transforme /docs en vault Obsidian complet
40	Astride	sonnet	Code review sarcastique (snobisme de combat)
41	Amiral	sonnet	Audit de généralisabilité open-source
42	Claude-md-optimizer	sonnet	Audit + optimisation CLAUDE.md
43	Tools-checker	sonnet	Diagnostic environnement CLI + Skills
45	Sargeras	opus	Audit omniscient 10 axes, métriques quantitatives, verdict
46	Rodin	opus	Interlocuteur socratique anti-chambre d’écho
50	Tony	opus	Ingénieur en chef : brief → stack + architecture + timing (modes from-scratch / audit)

6.3 Agents spécialisés (sous-dossiers)

Frontend (15-frontend/) — 7 agents :

00-orchestrateur : Coordinateur frontend, point d’entrée unifié
01-brique : Figma/HTML → composants shadcn/ui (React/Vue)
02-frontend-qa : QA frontend (3 modes : full, landing, shadcn)
03-visual-auditor : Audit visuel via Chrome DevTools MCP
04-backoffice-auditor : Audit Back Office (Next.js + shadcn)
05-svg-analyzer : Inventaire pages + maquettes SVG
06-pencil-generator : Next.js → fichiers .pen (Pencil)

Analyseurs de stack (10-analyze/) — 5 agents : Astro, Next.js, Nuxt, SPIP, SwiftUI — analyse approfondie par framework.

Déploiement (11-deploy/) — 5 agents : Vercel, Netlify, Cloudflare, Docker, AWS.

Tests (12-test/) — 2 agents : Unit (Jest/Vitest), E2E (Playwright/Cypress).

VPS (agents-vps/) — suite optionnelle, 17+ agents.

6.4 Subagents persistants (.claude/agents/)

7 subagents avec memory: local pour la persistance inter-sessions :

Subagent	Clé mémoire	Persiste
bruce	`bruce_project_state`	État projet, stack, dernière/prochaine tâche
godspeed	`godspeed_cache`	Cache diagnostic (expire au prochain commit)
gandalf	`gandalf_last_check`	% contexte, alertes, recommandations
task-runner	`taskrunner_metrics`	Vélocité, ajustements catégories, blockers
2b3	`checkpoint_patterns`	Issues récurrents, taux de succès simplification
strange	`analysis_state`	État analyse, lacunes, documents générés
steve	`api_decisions`	Décisions API, plateformes cibles, phase
bill	`android_state`	Stack web, source API, phases complétées

Stockage : ~/.claude/agent-memory-local/<agent-name>/

6.5 Protocoles partagés (_shared/)

Fichier	Usage
`base-rules.md`	Règles communes, formats, conventions de scoring
`context-protocol.md`	Passage de contexte inter-agents (-30% tokens)
`update-protocol.md`	Mise à jour incrémentale (jamais de réécriture complète)
`auditor-base.md`	Template rapport + scoring pour agents d’audit
`stack-detection.md`	Détection automatique de stack
`agent-teams.md`	Patterns de coordination multi-agents (experimental)
`cli-tools-protocol.md`	Priorité CLI > MCP
`claude-code-mastery.md`	Bonnes pratiques avancées Claude Code

7. Données et modèles

7.1 Format des agents (fichier Markdown)

---
name: agent-name
description: Description et déclencheurs d'invocation
tools: View, Read, Grep, Glob, Bash, Write, AskUserQuestionTool
model: opus | sonnet
---

7.2 Format des subagents (avec mémoire)

---
name: agent-name
description: Description
tools: [...]
model: sonnet
memory: local
---

7.3 Schemas JSON (schemas/)

10 schemas validant les structures de données cross-platform :

Schema	Usage
`todo.schema.json`	Format todo.md Monoboard Kanban
`spec.schema.json`	Structure docs/spec.md
`project.schema.json`	Métadonnées projet
`dashboard.schema.json`	Dashboard de suivi
`cli-registry.schema.json`	Registre outils CLI
+ 5 autres	Recettage, releases, etc.

7.4 Format todo.md (Monoboard Kanban)

---
kanban-plugin: board
project: [Nom du Projet]
version: "1.0.0"
updated: YYYY-MM-DD
---

## Backlog | ## Todo | ## In Progress | ## Blocked | ## Done | ## Archive

Format des cartes :

Courte : - [ ] #PREFIX-NNN [PX] Titre #zone #effort-size
Détaillée : avec checklist, dépendances, zone fichier

7.5 Registre CLI (tools/cli-registry.json)

33 outils CLI référencés avec leur équivalent MCP et fallback.

8. UX et parcours clés

8.1 Installation

# Option A — Distante (one-liner)
curl -fsSL https://raw.githubusercontent.com/izo/ulk/main/install-remote.sh | bash

# Option B — Locale (clone + symlink)
git clone https://github.com/izo/ulk && cd ulk && ./install.sh

# Options
./install.sh --with-vps --with-teams --with-community-skills
./install.sh --check-tools   # Diagnostic CLI + Skills
./install.sh --verify        # Diagnostic complet

8.2 Mise à jour

/ulk:update   # ou : git pull && ./install.sh

8.3 Invocation des agents

Les agents s’invoquent via langage naturel dans Claude Code :

/ulk:bruce         → Orchestrateur principal
/ulk:godspeed      → Diagnostic projet
/ulk:shuri         → Pipeline documentaire
/ulk:blackemperor  → Orchestrateur 5 modes

Ou via mots-clés naturels : "bruce", "go", "audit", "spec", etc.

8.4 Workflow type (session quotidienne)

1. Ouvrir Claude Code dans le projet
2. "bruce go"                    → diagnostic automatique
3. "next"                        → prochaine tâche
4. [implémentation]
5. "checkpoint"                  → 2b3 vérifie, commite
6. /clear                        → nouvelle session propre

8.5 Workflow orchestré (audit complet)

"blackemperor audit" →
  Shuri spec
  ↓
  Vision + Perf-auditor + A11y-auditor (parallèle, -40% temps)
  ↓
  Shuri todo (consolidation)
  ↓
  Rapport + actions priorisées

9. Qualité : sécurité, performance, observabilité

9.1 Sécurité

Aspect	Implémentation
Secrets dans agents	Jamais de credentials dans les fichiers .md
CLI > MCP	Réduction de la surface d’attaque via MCP
Open-source	Code lisible et auditable
install.sh	Idempotent, pas d’exécution de code non contrôlé

9.2 Performance contexte LLM

Mécanisme	Économie estimée
Context-protocol (`CONTEXTE PROJET:`)	-3 à -10K tokens par agent
CLI-first vs MCP	0 tokens vs N tokens
Parallélisme orchestrateurs	-40% temps total
Règle des 50%	Sessions viables et prévisibles
Mode orchestré (contexte reçu)	Skip Phase 1 reconnaissance

9.3 Observabilité

Outil	Données
`tools/check-tools.sh`	État CLI + Skills installés
Gandalf	% contexte en temps réel, alertes
Task-runner	Vélocité, métriques de progression
Sargeras	Audit 10 axes avec métriques quantitatives
`docs/audits/`	Rapports historisés

9.4 Qualité des agents

Annonces de phases : Chaque agent annonce ses phases pour la transparence
Questions avant génération : AskUserQuestionTool avant toute rédaction
Non-destructif : Ne jamais supprimer de contenu manuel
Idempotence : Relancer plusieurs fois donne le même résultat
IDs stables : Séquentiels par préfixe, jamais de doublons

10. Risques, hypothèses, inconnues

10.1 Risques identifiés

Risque	Probabilité	Impact	Mitigation
Breaking changes Claude Code CLI	Moyen	Élevé	Veille active, mise à jour rapide
CLAUDE.md trop volumineux (>200 lignes)	Actif	Moyen	Claude-md-optimizer (42)
Fragmentation agents (trop nombreux)	Moyen	Moyen	Roadmap bundles + blueprints
Dépendance à opus pour orchestrateurs	Faible	Faible	Sonnet comme fallback
Agent Teams instables (experimental)	Élevé	Faible	Activation opt-in, documentation
Image ulk.png optimisée	~~Résolu~~	—	Compressée 748K→179K via pngquant (ULK-020)
Bridge JS↔Swift non finalisé	Actif	Moyen	Schemas définis, à implémenter

10.2 Hypothèses

Claude Code reste le runtime principal (pas de migration vers d’autres LLM)
Les agents Markdown restent le format supporté par Claude Code
La communauté Claude Code adopte les conventions ulk comme référence
L’auteur maintient un rythme régulier de contributions

10.3 Inconnues

Roadmap officielle Claude Code (Agent Teams stable ? SDK officiel ?)
Adoption communautaire (métriques à définir)
Compatibilité avec les futures versions du CLI Anthropic
Financement / modèle économique (actuellement bénévolat)

11. Roadmap proposée

Phase 1 — Consolidation (v3.x actuel → v3.5)

Tâche	Priorité	Effort
Stabiliser la branche `fix/update-agent-invocation-paths`	P0	XS
Optimiser CLAUDE.md (>200 lignes → réduire)	P1	S
Compresser ulk.png (1.8MB)	P2	XS
Finaliser packages/core (TypeScript parser, types)	P1	L
Finaliser packages/status-board (dashboard local)	P2	XL
Compléter la couverture de tests	P2	M
Générer docs/todo.md depuis cette spec	P0	S

Phase 2 — Bundles et blueprints (v4.0)

Tâche	Priorité	Effort
Bundle Frontend (brique + frontend-qa + visual-auditor)	P1	M
Bundle Backend (robocop + vision + perf-auditor)	P1	M
Bundle Mobile (steve + bill + agamotto)	P1	M
Blueprint SaaS (Next.js + Vercel + Neon)	P2	L
Blueprint Mobile (Steve + Bill workflow complet)	P2	L
Blueprint Legacy Revival (ranma + blackemperor legacy)	P2	L

Phase 3 — SDK et écosystème (v4.5+)

Tâche	Priorité	Effort
SDK pour agents custom compatibles ulk	P2	XL
Dashboard local (packages/status-board finalisé)	P2	XL
Bridge JS↔Swift finalisé (schemas + implémentation)	P3	XXL
Nested Agent Teams (si Claude Code supporte)	P3	L

12. TODO priorisée

Générer docs/todo.md avec shuri mode=todo après validation de cette spec.

Tâches immédiates (P0) :

Merger fix/update-agent-invocation-paths → main
Générer docs/todo.md (Monoboard Kanban) depuis cette spec

Tâches importantes (P1) :

Réduire CLAUDE.md (audit via claude-md-optimizer)
Finaliser packages/core (TypeScript library)
Documenter les conventions de création d’agents (mise à jour agents-authoring.md)
Vérifier cohérence numérotation agents (trous dans la séquence)

Tâches utiles (P2) :

Compresser ulk.png (1.8MB → < 200KB)
Finaliser packages/status-board
Compléter couverture tests
Bundle agents thématiques (définition + implémentation)

Nice-to-have (P3) :

SDK agents custom
Bridge JS↔Swift
Nested Agent Teams

13. Annexes

13.1 Glossaire

Terme	Définition
Agent	Fichier Markdown avec frontmatter YAML définissant un assistant IA spécialisé pour Claude Code
Subagent	Agent avec `memory: local` dans `.claude/agents/` — persistance inter-sessions
Skill	Documentation structurée d’un CLI dans `~/.claude/skills/ulk-*/` — chargée automatiquement par Claude Code
MCP	Model Context Protocol — serveur d’outils pour Claude Code
Context-protocol	Convention ulk : bloc `CONTEXTE PROJET:` transmis entre orchestrateurs pour éviter la reconnaissance (-30% tokens)
Monoboard	Format de todo.md en Kanban avec `kanban-plugin: board`, compatible Obsidian
Opus	Modèle Claude le plus puissant — réservé aux orchestrateurs complexes
Sonnet	Modèle Claude intermédiaire — agents spécialistes
Bruce	(1) le chien Vallhund suédois de l’auteur, (2) l’orchestrateur principal ulk
CLI-first	Philosophie ulk : préférer les CLI aux MCP pour économiser le contexte LLM
Agent Teams	Fonctionnalité expérimentale Claude Code : sessions Claude Code indépendantes qui communiquent entre elles
Blob CONTEXTE	Bloc de texte normalisé transmis par les orchestrateurs aux sous-agents pour éviter la phase de reconnaissance

13.2 Références

Ressource	URL
Site officiel ulk	https://izo.github.io/ulk/
Repository GitHub	https://github.com/izo/ulk
Claude Code docs	https://code.claude.com/docs
Agent Teams docs	https://code.claude.com/docs/en/agent-teams
CHANGELOG	`CHANGELOG.md`

13.3 Fichiers clés du projet

Fichier	Rôle
`CLAUDE.md`	Instructions projet pour Claude Code (>200 lignes — à optimiser)
`agents/*.md`	Définitions des agents
`agents/_shared/*.md`	Protocoles partagés
`.claude/agents/*.md`	Subagents avec mémoire persistante
`.claude/rules/*.md`	Règles path-specific (chargées à la demande)
`install.sh`	Script d’installation locale
`install-remote.sh`	One-liner installation distante
`tools/cli-registry.json`	Registre des 33 outils CLI
`tools/check-tools.sh`	Diagnostic environnement
`cheatheet/generate-unified-docs.js`	Générateur de documentation
`site/data/commands.json`	Référence des 66 commandes (site web)

13.4 Convention de numérotation des agents

Plage	Catégorie
00-09	Agents core (diagnostic, doc, tasks, audit)
10-analyze/	Analyseurs de stack (sous-dossier)
11-deploy/	Agents de déploiement (sous-dossier)
11-19	Agents debug, reverse-doc, orchestrateurs
12-test/	Agents de test (sous-dossier)
15-frontend/	Suite frontend (sous-dossier)
20-29	Agents sync, communications, orchestrateurs PM
30-39	Agents spécialisés (SEO, migration, vault)
40-49	Agents avancés (audit omniscient, mobiles, IA)
50+	Agents stratégiques (engineering, architecture) — prochain : 51

Spec générée le 2026-04-03 par Shuri (01) en mode orchestré. Prochaine étape recommandée : shuri mode=todo pour générer docs/todo.md.