Skip to content

Latest commit

 

History

History
676 lines (528 loc) · 26.8 KB

File metadata and controls

676 lines (528 loc) · 26.8 KB
title Spécification projet — ulk
type spec
version 4.1.0
date 2026-04-03
updated 2026-04-13
status active
author shuri
tags
specification
ai-toolkit
claude-code
monorepo

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
  • Idempotenceinstall.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)

  • 46+ agents spécialisés (agents/ + sous-dossiers)
  • 7 subagents persistants (.claude/agents/ avec auto-memory)
  • 12+ skills CLI custom (skills/ulk-*/)
  • Installation locale (symlinks) et distante (curl | bash)
  • Orchestrateurs Bruce (PM) et Blackemperor (5 modes)
  • Pipeline documentaire Shuri (spec → todo → sync)
  • Protocoles partagés (8 fichiers _shared/)
  • Schemas JSON (10 schemas cross-platform)
  • Site GitHub Pages avec référence des commandes
  • Générateur de documentation (cheatheet/)
  • Registre CLI (33 outils, diagnostic automatique)
  • Path-specific rules (.claude/rules/)
  • App macOS SwiftUI (clients/app-apple/ — 34 fichiers Swift, partiellement fonctionnelle)
  • Agent Teams (expérimental, activation manuelle)

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

  1. Convention over configuration — la structure des dossiers définit le comportement
  2. CLI-first over MCP — 0 token de contexte pour les CLI vs N tokens pour les MCP
  3. Zéro dépendance — aucun package.json à la racine, aucun node_modules
  4. Agents as code — chaque agent est un fichier Markdown auto-descriptif et versionnable
  5. Context frugality — chaque token compte, protocoles d'économie intégrés à tous les niveaux
  6. 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.