Context LLM — ulk

Snapshot pour injection dans un prompt LLM. ~15K caracteres max.

Projet

ulk est un AI Development Toolkit open-source (MIT) qui etend Claude Code avec 46+ agents IA specialises. Monorepo leger, zero dependances npm a la racine. Version 4.0.1. Auteur : Mathieu Drouet (izo). Repository : github.com/izo/ulk.

Structure

ulk/
├── agents/           # 46+ agents (.md + frontmatter YAML)
│   ├── _shared/      # 13 protocoles partages
│   ├── orchestrators/  # Bruce (25), Blackemperor (18), Lovecraft (47)
│   ├── docs/         # Shuri (01), Friday (09)
│   ├── audit/        # Sargeras (45), Vision (05), A11y (06), Perf (07), SEO (32)
│   ├── session/      # 2b3 (08), Robocop (11), Gandalf (34), Task-runner (04)
│   ├── specials/     # Strange (16), Tony (50), Rodin (46), Sensei (38)
│   ├── mobile/       # Happy (49), Steve (27), Fluke (48)
│   ├── sync/         # Brigitte (24), Bifrost (21)
│   ├── analyze/      # Analyseurs stack (Astro, Next, Nuxt, SPIP, SwiftUI)
│   ├── deploy/       # Vercel, Netlify, Cloudflare, Docker, AWS
│   ├── test/         # Unit (Jest/Vitest), E2E (Playwright/Cypress)
│   ├── frontend/     # 7 agents + checklists
│   └── vps/          # 17+ agents VPS (optionnel)
├── commands/         # Miroir installable (genere)
├── skills/           # 12 skills CLI
├── schemas/          # 11 JSON Schemas (draft-07)
├── packages/
│   ├── core/         # @ulk/core (TypeScript: parsers, types, GitHub client)
│   └── status-board/ # Dashboard CLI
├── .claude/
│   ├── agents/       # 8 subagents persistants (memory: local)
│   └── rules/        # 6 regles path-specific
├── site/             # GitHub Pages
├── cheatheet/        # Generateurs docs (Node.js vanilla)
├── tools/            # CLI registry (33+ outils) + diagnostic
└── install.sh        # Installeur idempotent

Agents principaux

Agent	#	Modele	Mission
Bruce	25	opus	Point d’entree PM, orchestre tout
Godspeed	00	sonnet	Diagnostic projet, cache 30min
Shuri	01	sonnet	Pipeline doc : spec/todo/sync/full
Task-runner	04	sonnet	Execute taches todo.md
Vision	05	sonnet	Audit code 8 dimensions + simplify
A11y-auditor	06	sonnet	WCAG 2.1/2.2
Perf-auditor	07	sonnet	Core Web Vitals, bundle, DB
2b3	08	sonnet	Checkpoint fin de session
Robocop	11	opus	Fix erreurs (runtime, compile, test)
Blackemperor	18	opus	Orchestrateur 5 modes
Sargeras	45	opus	Audit omniscient 10 axes
Tony	50	opus	Brief vers stack + archi + timing

Distribution : 10 agents opus (orchestration complexe), 62+ agents sonnet (taches focalisees).

Commandes essentielles

# Installation
curl -fsSL https://raw.githubusercontent.com/izo/ulk/main/install-remote.sh | bash
./install.sh                    # Locale
./install.sh --with-vps --with-teams --with-memory-loop  # Options

# Mise a jour
git pull && ./install.sh

# Generateurs
node cheatheet/generate-commands.cjs   # commands/ depuis agents/
node cheatheet/generate-registry.cjs   # registry.json + registry.md

# Packages
cd packages/core && npm install && npm run build && npm run test
node packages/status-board/src/cli.js  # Dashboard

# Diagnostic
./install.sh --check   # CLI + Skills
./install.sh --verify  # Installation

Workflows cles

Nouveau projet : bruce go -> Godspeed diagnostic -> Shuri spec + todo -> Task-runner execute.

Session dev : bruce next -> Task-runner prend la tache -> implemente -> 2b3 checkpoint + commit.

Audit complet : blackemperor audit -> Shuri spec -> [Vision + Perf + A11y] parallele -> todo consolide.

Fix erreur : bruce fix ou fix #42 -> Robocop diagnostic -> fix -> verification -> close issue.

Pre-release : blackemperor mode=release -> audits paralleles -> Robocop -> tests -> GO/NO-GO.

Conventions

Format agent : fichier .md avec frontmatter YAML (name, model, phase, tools, invocation, extends).

Phases : define -> plan -> build -> verify -> review -> ship -> orchestrator. Max 3 phases par agent.

Modeles : opus = orchestrateurs/analyse complexe. sonnet = taches focalisees.

Context Protocol : bloc CONTEXTE PROJET: transmis par les orchestrateurs aux sous-agents. Economise 3-10K tokens par agent en evitant le re-scan.

CLI > MCP : preferer les CLI (gh, vercel, neonctl) aux MCP pour 0 token de contexte. MCP reserves a Figma, Notion, Linear.

Regle des 50% : ne jamais depasser 50% du contexte LLM. /clear proactif a 40%.

Todo.md Monoboard : format Kanban compatible Obsidian. Colonnes : Backlog / Todo / In Progress / Blocked / Done. Priorites P0-P3, efforts XS-XXL.

Frontmatter standard : title, type, category, date, status (draft/active/deprecated/archived), author, tags.

Git : [prefix]: [description] (#ID). Prefixes : feat, fix, refactor, docs, test, chore, perf, security.

Non-destructif : les agents ne suppriment jamais de contenu utilisateur.

Idempotent : install.sh et les agents produisent le meme resultat a chaque execution.

Memoire

8 subagents avec memory: local dans .claude/agents/ : bruce, godspeed, gandalf, task-runner, 2b3, strange, steve, tony. Stockage : ~/.claude/agent-memory-local/<agent>/.

Knowledge Vault Loop : MEMORY.md (staging) -> lovecraft capture -> docs/_memory/ (vault Obsidian) -> lovecraft distribute -> CLAUDE.md (bloc vault:begin/end).

Fichiers d’etat

docs/spec.md — Specification projet (source de verite)
docs/todo.md — Kanban Monoboard (backlog priorise)
CLAUDE.md — Instructions projet pour Claude Code
agents/registry.json — Registre auto-genere (72 agents)
tools/cli-registry.json — Registre 33+ outils CLI