DOC
User Stories — ulk
User Stories — ulk
Reconstitue depuis
docs/spec.md,docs/guide.md,agents/CLAUDE.mdet le code source des agents.
1. Installation et configuration
US-001 — Installer ulk depuis zero
En tant que developpeur utilisant Claude Code, je veux installer ulk en une commande, afin de disposer immediatement de 46+ agents specialises dans mon environnement Claude Code.
Criteres d’acceptation :
curl -fsSL https://raw.githubusercontent.com/izo/ulk/main/install-remote.sh | bashinstalle sans erreur- Les commandes
/ulk:bruce,/ulk:godspeedsont disponibles dans Claude Code - L’installation est idempotente (relancer ne casse rien)
US-002 — Installer avec options avancees
En tant que developpeur avance, je veux choisir les modules optionnels (VPS, Agent Teams, skills communaute, memory loop), afin de personnaliser mon installation selon mes besoins.
Criteres d’acceptation :
./install.sh --with-vps --with-teams --with-a11y-skills --with-memory-loopactive les options choisies./install.sh --dry-runsimule sans modifier le systeme./install.sh --verifyconfirme l’etat de l’installation
US-003 — Verifier l’installation
En tant que utilisateur, je veux diagnostiquer mon environnement CLI et skills, afin de savoir quels outils sont disponibles et lesquels manquent.
Criteres d’acceptation :
./install.sh --checkaffiche un rapport CLI + Skills avec statut par outil- Le rapport indique les commandes d’installation pour les outils manquants
US-004 — Mettre a jour ulk
En tant que utilisateur d’une version anterieure, je veux mettre a jour ulk simplement, afin de beneficier des nouveaux agents et corrections.
Criteres d’acceptation :
git pull && ./install.shmet a jour sans perte de donnees- Les agents custom eventuels ne sont pas ecrases
2. Demarrage de projet
US-010 — Demarrer un nouveau projet
En tant que developpeur,
je veux lancer bruce go sur un projet vide,
afin d’ obtenir une specification structuree et un backlog priorise automatiquement.
Criteres d’acceptation :
- Bruce lance Godspeed pour diagnostic
- Shuri genere
docs/spec.md(specification) etdocs/todo.md(backlog Kanban) - Task-runner prend la premiere tache
- Le tout en une seule commande
US-011 — Obtenir un diagnostic instantane
En tant que developpeur arrivant sur un projet existant,
je veux lancer /ulk:godspeed,
afin de connaitre la stack, l’etat du projet et la prochaine action suggeree en quelques secondes.
Criteres d’acceptation :
- Godspeed detecte la stack (framework, langages, DB, tests)
- Le diagnostic est cache 30 minutes
- Une action suivante est suggeree
US-012 — Faire analyser mon brief par un ingenieur IA
En tant que porteur de projet, je veux soumettre un brief a Tony (50), afin d’ obtenir une recommandation de stack, une architecture et un timing chiffre.
Criteres d’acceptation :
- Tony pose un questionnaire technique
- Genere
docs/engineering-report.mdavec stack recommandee, architecture et planning - Handoff automatique vers Shuri pour generer la spec
3. Session de developpement
US-020 — Prendre la prochaine tache
En tant que developpeur en session,
je veux taper bruce next ou next,
afin que la prochaine tache prioritaire de docs/todo.md soit prise et executee automatiquement.
Criteres d’acceptation :
- Task-runner selectionne la tache la plus prioritaire
- Le statut passe de
[ ]a[~](en cours) - A la fin, le statut passe a
[x](fait) - La velocite est mesuree et memorisee
US-021 — Checkpoint de fin de session
En tant que developpeur finissant une session,
je veux lancer /ulk:2b3,
afin que le code soit verifie, les docs mises a jour, et un commit propre soit cree.
Criteres d’acceptation :
- 2b3 verifie le diff (lint, types)
- Verifie la conformite avec CLAUDE.md
- Met a jour docs/todo.md
- Si MEMORY.md existe, capture dans le vault (Phase 5.7)
- Cree un commit git structure
US-022 — Surveiller la consommation de contexte
En tant que utilisateur en session longue,
je veux que Gandalf m’alerte quand j’approche des 40% de contexte,
afin de pouvoir sauvegarder et /clear avant degradation.
Criteres d’acceptation :
- Gandalf detecte le % de contexte utilise
- Alerte au-dela de 40%
- Suggere les actions de sauvegarde avant
/clear
4. Audit et qualite
US-030 — Audit omniscient du projet
En tant que lead technique,
je veux lancer /ulk:sargeras pour un audit complet 10 axes,
afin d’ obtenir un score quantitatif et un verdict de production-readiness.
Criteres d’acceptation :
- 10 axes audites : architecture, qualite, securite, perf, design, UX, coherence, infra, docs, dette
- Metriques quantitatives (fichiers, lignes, god files, tests, markers dette)
- Rapport genere dans
docs/audits/sargeras-YYYY-MM-DD.md - Verdict GO/NO-GO avec top 20 actions priorisees
US-031 — Audits paralleles via orchestrateur
En tant que developpeur preparant une release,
je veux lancer blackemperor audit,
afin que 4 audits (code, perf, a11y, SEO) s’executent en parallele et produisent un rapport consolide.
Criteres d’acceptation :
- Shuri genere d’abord la spec (contexte)
- Vision, Perf-auditor, A11y-auditor lancent en parallele
- Shuri consolide les findings dans todo.md
- Temps d’execution reduit de ~40% vs sequentiel
US-032 — Corriger une erreur
En tant que developpeur face a une erreur,
je veux dire fix ou fix #42,
afin que Robocop diagnostique, corrige, verifie et ferme l’issue automatiquement.
Criteres d’acceptation :
- Robocop lit l’erreur (runtime, compilation, test, lint)
- Diagnostique la cause racine
- Applique le fix et verifie (pas de regression)
- Si issue GitHub, commente et ferme
5. Documentation
US-040 — Generer la specification depuis le code
En tant que developpeur sur un projet existant sans spec,
je veux lancer /ulk:shuri mode=spec,
afin d’ obtenir une specification structuree generee depuis le code et les configs.
Criteres d’acceptation :
- Shuri scanne les fichiers de configuration, detecte la stack
- Pose des questions specifiques a la stack detectee
- Genere
docs/spec.mdavec contexte, objectifs, architecture, risques
US-041 — Reconstituer la documentation manquante
En tant que developpeur arrivant sur un projet legacy sans documentation,
je veux lancer /ulk:strange,
afin de reconstituer 6 documents (cahier des charges, doc technique, user stories, architecture, etc.) depuis le code source.
Criteres d’acceptation :
- Strange analyse le code source, tests, configs, entry points
- Genere 6 documents dans
docs/rewrite/ - Chaque document avec frontmatter YAML Obsidian
US-042 — Harmoniser une documentation desorganisee
En tant que mainteneur,
je veux lancer lovecraft harmonize,
afin que la documentation existante soit detectee, reorganisee et completee automatiquement.
Criteres d’acceptation :
- Lovecraft detecte l’etat (EMPTY, PARTIAL, DRIFTED, HEALTHY, OBSIDIAN_READY)
- Propose un plan de migration explicite
- Demande confirmation avant execution
- Effectue backup dans
docs/_archive-YYYY-MM-DD-HHMM/
US-043 — Generer un snapshot contexte pour LLM
En tant que developpeur,
je veux lancer friday mode=context,
afin d’ obtenir un fichier docs/context.md de 15K caracteres max resumant tout le projet pour injection dans un prompt LLM.
Criteres d’acceptation :
docs/context.mdgenere avec les infos essentielles du projet- Taille maximale 15K caracteres
- Referencable via
@docs/context.mddans Claude Code
6. Deploiement et livraison
US-050 — Pre-release check
En tant que lead technique,
je veux lancer blackemperor mode=release,
afin d’ obtenir un verdict GO/NO-GO base sur les quality gates.
Criteres d’acceptation :
- Audits paralleles (vision, perf, a11y)
- Robocop corrige les issues critiques
- Tests executes
- Verdict GO/NO-GO avec rapport de quality gates
US-051 — Deployer sur une plateforme
En tant que developpeur,
je veux invoquer un agent de deploiement (deploy-vercel, deploy-netlify, deploy-cloudflare, deploy-docker, deploy-aws),
afin de deployer mon projet sur la plateforme cible avec les bonnes configurations.
Criteres d’acceptation :
- L’agent detecte le framework et configure le deploiement
- Preview et production deployments supportes
- Configuration environment variables si necessaire
US-052 — Generer un starter kit mobile
En tant que developpeur avec un projet web existant,
je veux lancer happy puis steve ou fluke,
afin d’ obtenir un starter kit mobile natif (iOS ou Android) connecte a mon API.
Criteres d’acceptation :
- Happy audite le projet web et genere
docs/api/(OpenAPI 3.1) - Steve genere un starter kit SwiftUI compilable dans
docs/apple-starter-kit/ - Fluke genere un starter kit Kotlin/Compose ou Flutter dans
docs/android-starter-kit/
7. Synchronisation et communication
US-060 — Synchroniser avec Notion/Linear
En tant que chef de projet,
je veux lancer brigitte,
afin de synchroniser bidirectionnellement mon backlog avec Notion et/ou Linear.
Criteres d’acceptation :
- Sync bidirectionnelle (local vers Notion/Linear et inverse)
- Resolution de conflits
- Communications generees a partir du changelog
US-061 — Importer depuis Notion
En tant que developpeur migrant depuis Notion,
je veux lancer bifrost import,
afin d’ importer recursement mes pages Notion dans docs/imports/.
Criteres d’acceptation :
- Lecture de la page maitre + pages liees recursivement
- Generation de
docs/imports/spec_notion.md+todo_notion.md - Metadonnees d’import dans
.notion-import-meta.json