ulk 🐺

AI Development Toolkit pour Claude Code.

Pourquoi "ulk" ?

Bruce, de son vrai nom Ulk, est un Vallhund suédois — 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. Petit mais costaud, il ne recule devant aucun défi : audits de sécurité, refactoring de legacy code, ou déploiement à 3h du matin.

Le nom "ulk" signifie "loup" en vieux norrois. Car sous ses airs adorables, Bruce est un gardien féroce de la qualité du code.

Installation

curl -fsSL https://raw.githubusercontent.com/izo/ulk/main/install-remote.sh | bash

Après installation, utilisez /ulk:update pour mettre à jour.

Désinstallation

# Depuis le dossier ulk cloné
./uninstall.sh

# Ou directement
rm -rf ~/.claude/commands/ulk

Options disponibles :

• --force ou -f : Supprime sans confirmation
• --dry-run : Affiche ce qui serait supprimé sans rien faire

Commandes disponibles

Agents de développement (/ulk:agents:*)

Commande	Description
spec-writer	Génère un fichier spec.md complet
todo-generator	Crée todo.md avec tâches actionnables
task-runner	Exécute les tâches du todo.md
sync-local	Synchronise spec.md, CLAUDE.md, README.md
code-auditor	Audit qualité et architecture du code
code-simplifier	Simplifie et réduit la complexité
a11y-auditor	Audit accessibilité WCAG 2.1/2.2
perf-auditor	Audit performance et Core Web Vitals
2b3	Routine fin de session : vérif code → docs → todo → simplify → commit
context-generator	Génère llm.txt pour onboarding LLM
robocop	Détective et fixeur d'erreurs (all types)
documentalist	Gère et organise le dossier /docs
brique	Figma OU HTML/Tailwind → composants shadcn/ui (React/Vue)
frontend-qa	Audit frontend UX/UI (full, landing, shadcn)
blackemperor	Orchestrateur unifié 5 modes : audit, legacy, release, review, ship
notion-importer	Import Notion → spec_notion.md + todo_notion.md
brigitte	Communications bienveillantes + sync Notion/Linear
bruce	Point d'entrée principal ulk : idée → projet complet
godspeed	Diagnostic sous-agent : scan, détection stack, classification
picsou	Estimation coûts d'hébergement multi-providers
steve	API mobile + SwiftUI : audit web → API → starter kit
svg-analyzer	Analyse React/Next.js → génère SVG via Shad2SVG
ranma	Planificateur de migration (WP→SPIP, Next→Nuxt, etc.)
seo-auditor	Audit SEO & GEO (technique, on-page, AI citations)
pencil-generator	Génère fichiers .pen depuis Next.js
gandalf	Context guardian (hygiène de session, discipline)
visual-auditor	Audit visuel via Chrome DevTools MCP
marketing-maestro	Marketing showcase : CRO, copywriting
beetlejuice	Markdown → Notion QA
sensei	Mode apprentissage : explications, diagrammes, visualisations
backoffice-auditor	Audit cohérence Back Office (Next.js + Shadcn)
astride	Snobisme de combat : code review sarcastique, conseils en vraie vie

Orchestrateur blackemperor (/ulk:agents:blackemperor)

5 modes de workflow automatisé :

Mode	Invocation	Description
audit	"audit-complet"	spec + code + perf + a11y + todo (5 agents en parallèle)
legacy	"legacy-revival"	doc + simplify + fix + optimize (6 agents)
release	"pre-release"	Checklist pre-release + GO/NO-GO
review	"review"	Complétude code vs spec/prompt/issue
ship	"ship"	simplify + docs + sync + release

Frontend (/ulk:frontend:*)

Commande	Description
orchestrateur	Route vers le bon agent frontend selon l'intention
brique	Figma/HTML → shadcn/ui pixel-perfect (React/Vue, Next/Nuxt)
frontend-qa	Audit frontend UX/UI (full, landing, shadcn)
visual-auditor	Audit visuel via Chrome DevTools MCP
backoffice-auditor	Audit cohérence Back Office (Next.js + Shadcn)
svg-analyzer	Analyse React/Next.js → SVG via Shad2SVG
pencil-generator	Génère fichiers .pen depuis Next.js

Analyseurs de stack (/ulk:analyze:*)

Commande	Description
nuxt	Analyse Nuxt 3/4, SSR, Nuxt UI
next	Analyse Next.js 13-15, App Router, RSC
astro	Analyse Astro 3-5, Islands Architecture
swiftui	Analyse SwiftUI, MVVM/TCA
spip	Analyse SPIP 3-5, squelettes, CVT

Déploiement (/ulk:deploy:*)

Commande	Description
vercel	Déploie sur Vercel
netlify	Déploie sur Netlify
cloudflare	Déploie sur Cloudflare Pages/Workers
docker	Build et déploie containers Docker
aws	Déploie sur AWS S3/CloudFront/ECS

Tests (/ulk:test:*)

Commande	Description
unit	Configure tests unitaires Jest/Vitest
e2e	Configure tests E2E Playwright/Cypress

Agents VPS (/ulk:vps:*)

17 agents pour gérer vos serveurs multi-projets :

orchestrateur · audit · securite · reseau · docker · deploiement · cicd · monitoring · backups · incidents · migration · cleanup · documentation · compliance · couts-ressources · environnements · installateur

Site web

Le site de documentation est disponible sur izo.github.io/ulk.

Raccourcis clavier

Touche	Action
T	Toggle light/dark mode
D	Scroll vers Installation
C	Ouvrir GitHub (clone)
S	Ouvrir GitHub (source)

Design

• Style inspiré de Zed.dev
• Police IBM Plex Mono / IBM Plex Sans
• Dark mode avec persistance localStorage
• Respect de prefers-color-scheme

Workflows recommandés

Nouveau projet

/ulk:agents:spec-writer → /ulk:agents:todo-generator → /ulk:agents:task-runner

Audit complet (automatisé)

/ulk:agents:blackemperor  # ou "audit-complet"
# mode=audit : spec-writer → [code-auditor + perf-auditor + a11y-auditor] (parallel) → todo-generator

Code legacy

/ulk:agents:blackemperor  # ou "legacy-revival"
# mode=legacy : spec-writer → code-auditor → [code-simplifier + perf-auditor] (parallel) → robocop → sync-local

Pre-release check

/ulk:agents:blackemperor  # ou "pre-release"
# mode=release : [audits parallèles] → robocop → tests → Verdict GO/NO-GO

Figma → Code pixel-perfect

# Setup (une fois par projet)
/figma:create-design-system-rules

# Conversion (95-100% fidélité)
/ulk:frontend:brique

API mobile + Apple native

/ulk:agents:steve
# Audit web → design API → docs/api/ + SwiftUI starter kit

Génération SVG de maquettes

/svg-analyzer
# Phase 1 : Analyse projet → ANALYSE_PAGES.md
# Phase 2 : Génération SVG → output/*.svg + index.html

Audit manuel (pas à pas)

/ulk:agents:code-auditor → /ulk:agents:perf-auditor → /ulk:agents:a11y-auditor

Nouveau serveur VPS

/ulk:vps:audit → /ulk:vps:securite → /ulk:vps:docker → /ulk:vps:reseau

Contribution

Les commandes sont définies dans site/data/commands.json.

Pour proposer un nouvel agent : Ouvrir une issue

Auteur

Réalisé par Mathieu Drouet pour regrets.app

Licence

MIT