Skip to content

DOC

Pipeline spec → todo Kanban avec Shuri

Générer une spécification projet complète et convertir en backlog Kanban actionnable

Pipeline spec → todo Kanban avec Shuri

Contexte

Vous avez un projet nouveau ou existant et vous voulez une documentation structurée : spécification technique complète, puis conversion en backlog Kanban lisible. Shuri orchestre ce pipeline end-to-end.

Prérequis

  • Projet avec racine accessible (README.md, CLAUDE.md optionnels)
  • .claude/ directory (créé automatiquement si absent)
  • docs/ directory (créé par Shuri si absent)
  • Accès Write sur le projet

Étapes

1. Invocation complète (mode full)

Lancez Shuri en mode pipeline complet :

/ulk:shuri

ou

Analyse complète du projet, génère spec et todo

Shuri démarre la Phase 1 (Exploration) → Phase 2 (Spec) → Phase 3 (Todo) → Phase 4 (Sync).

2. Phase 1 — Exploration (automatique)

Shuri effectue :

# Structure du projet
ls -la
find . -maxdepth 2 -type f | head -50

# Configuration
cat package.json 2>/dev/null || cat go.mod 2>/dev/null || cat pyproject.toml 2>/dev/null

# Documentation existante
cat README.md 2>/dev/null
cat CLAUDE.md 2>/dev/null

Sortie intermédiaire :

=== Cartographie ===
📁 Type projet : Node.js / TypeScript
🏗️ Framework : Next.js
📝 Doc existante : README.md, CLAUDE.md

3. Phase 2 — Génération spec (docs/spec.md)

Shuri produit docs/spec.md avec sections :

# Spécification Projet

## Aperçu
[Description du projet, objectifs, cas d'usage]

## Architecture
[Diagrammes, structure, patterns]

## Endpoints / API
[Routes, schemas, exemples]

## Modèles de données
[Entités, relations, validations]

## Flux utilisateur
[User flows, workflows clés]

## Non-fonctionnels
[Performance, sécurité, scaling]

4. Phase 3 — Génération todo (docs/todo.md)

Shuri génère un backlog Kanban structuré :

# Backlog Kanban

## P0 (Critique)
- [ ] Setup base de données
- [ ] Auth utilisateur
- [ ] API endpoints principaux

## P1 (Important)
- [ ] Dashboard utilisateur
- [ ] Intégrations tierces
- [ ] Tests unitaires

## P2 (Nice-to-have)
- [ ] Analytics
- [ ] Optimisation SEO
- [ ] Documentation API

Chaque tâche inclut estimations et dépendances.

5. Phase 4 — Synchronisation locale (CLAUDE.md, README.md)

Shuri mets à jour :

cat CLAUDE.md | head -30

Résultat :

## Project Overview

**[Project Name]** is a [type] application...

## Essential Commands

```bash
npm run dev       # Start development
npm run build     # Build for production
npm run test      # Run tests

Architecture

[Auto-generated from spec.md]


### 6. (Optionnel) Mode spec uniquement

Si vous voulez seulement la spec sans todo :

Invocation : /ulk:shuri mode=spec ou “Génère la spec”


Produit uniquement `docs/spec.md`.

### 7. (Optionnel) Mode todo uniquement

Invocation : /ulk:shuri mode=todo


Produit uniquement `docs/todo.md`.

## Exemple de sortie

Fichiers créés :

docs/ ├── spec.md (2-3 KB, spécification complète) ├── todo.md (1-2 KB, backlog Kanban) └── [autres fichiers existants]

CLAUDE.md (mis à jour avec résumé)


Rapport Shuri :

=== Pipeline Shuri Terminé ===

✅ Spec générée : docs/spec.md (2847 lignes) ✅ Todo créé : docs/todo.md (145 items) ✅ CLAUDE.md mis à jour ✅ Sync locale complète

Prochaines étapes :

  1. Vérifier docs/spec.md (ajuster si nécessaire)
  2. Prioriser docs/todo.md (déplacer items entre P0/P1/P2)
  3. Créer velocity/sprints si nécessaire
  4. Lancer task-runner (04) pour première feature

## Variantes

- **Variante A — Contexte fourni** : Passer un bloc `CONTEXTE PROJET:` pour accélérer (économie 5-10K tokens).
- **Variante B — Kanban conversion** : Mode `convert` transforme todo.md → board Obsidian via obsidian-vault (39).
- **Variante C — Sync uniquement** : Mode `sync` met à jour CLAUDE.md et README sans régénérer spec/todo.
- **Variante D — Legacy project** : Utiliser `strange (16)` d'abord pour reverse-documenter avant Shuri.

## Agents enchaînés

Flux typique : `shuri (01)` spec+todo → `friday (09)` contexte LLM → `blackemperor (18)` mode=audit pour validation.

## Troubleshooting

| Symptôme | Cause probable | Résolution |
|----------|----------------|------------|
| Spec trop courte (< 1 KB) | Projet trop simple ou config manquante | Ajouter manuel sections manquantes |
| Todo vide ou générique | Pas assez de code à analyser | Utiliser mode=spec d'abord, puis affiner |
| CLAUDE.md non mis à jour | Conflit de permissions | Vérifier Write access sur racine |
| Stack non détecté | Fichiers config manquants | Vérifier package.json, tsconfig.json, etc. |

## Voir aussi

- `agents/docs/01-shuri.md` — pipeline complet
- `agents/docs/16-strange.md` — reverse documentation (legacy)
- `agents/docs/39-obsidian-vault.md` — convertir todo en Kanban Obsidian
- `agents/orchestrators/18-blackemperor.md` — validation spec vs code