Skip to content

README.md

Latest commit

 

History

History
207 lines (152 loc) · 11.7 KB

README.md

File metadata and controls

207 lines (152 loc) · 11.7 KB

ulk

AI Development Toolkit pour Claude Code.

Live Demo GitHub Version

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.

Le nom "ulk" signifie "loup" en vieux norrois.

Installation

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

Ou depuis le dépôt cloné :

./install.sh                          # Installation de base (Figma + Swift + Flutter + 5 skills Obsidian/kepano)

# Skills additionnelles (opt-in)
./install.sh --with-figma-mcp                # + configurer le serveur MCP Figma
./install.sh --with-addy-skills              # + skills addyosmani
./install.sh --with-a11y-skills              # + skills accessibilité (RAWeb/RAAM)
./install.sh --with-nothing-design           # + Nothing design system (dominikmartn)
./install.sh --with-hue-skill                # + Hue design language generator (dominikmartn, MIT)
./install.sh --with-logo-generator-skill     # + logo generator (SVG+PNG, Gemini API)
./install.sh --with-cwb-app-icon             # + AppIcon natif iOS/macOS (SnapAI, OpenAI key)
./install.sh --with-caveman-skill            # + /caveman-compress (compression CLAUDE.md, -46%)
./install.sh --with-caveman-output-skill     # + /caveman output mode (-79% tokens rapports agents)
./install.sh --with-kami-skill               # + kami (documents pro IA — One-Pager, Letter, Slides…)
./install.sh --without-obsidian-skills       # opt-out 5 skills kepano (bundlées par défaut)

# Hooks et modes
./install.sh --with-vps                      # + agents VPS
./install.sh --with-teams                    # + Agent Teams (expérimental)
./install.sh --with-memory-loop              # + hooks Knowledge Vault Loop
./install.sh --with-xavier-hook              # + SessionStart Xavier (carte contexte, 0 tokens)
./install.sh --with-cli-telemetry            # + suivi usage CLI → ./tools/cli-report.sh
./install.sh --with-accountability           # + audit trail mutations → .ulk-reports/accountability.jsonl
./install.sh --with-context-mode             # + Context Mode (économie -$8 à -$24/mois output tokens)
./install.sh --with-statusline               # + statusline ulk (cwd · modèle · ctx% · P0 · git hash)
./install.sh --with-managed-agents           # + Managed Agents Anthropic (sessions cloud, 5 agents portés)
./install.sh --with-faru                     # + mode faru (kanban git-natif agent-first)
./install.sh --with-sentinel                 # + hook Sentinel (cascade pre-push/pre-deploy)
./install.sh --with-code-graph               # + Code Review Graph MCP (gain -8.2× audits monorepo)

# Bundles CLIs (opt-in)
./install.sh --with-container-clis           # docker · kubectl · helm · k9s · lazydocker
./install.sh --with-monitoring-clis          # vegeta · hyperfine · gping · mtr
./install.sh --with-ai-clis                  # ollama · apfel · aider · llm
./install.sh --with-doc-clis                 # mdbook · vale · markdownlint-cli2
./install.sh --with-data-clis                # jq · yq · csvkit · duckdb · visidata
./install.sh --with-design-clis              # imagemagick · ffmpeg · svgo · sharp-cli
./install.sh --with-devops-clis              # terraform · ansible · pulumi · act
./install.sh --with-mobile-clis              # xcrun · bundler · fastlane · expo · eas-cli

# Diagnostic
./install.sh --install-deps                  # Installer les CLIs manquants (sélecteur interactif)
./install.sh --check                         # Diagnostic CLI + Skills
./install.sh --verify                        # Vérifier l'installation
./install.sh --dry-run                       # Simuler sans modifier

# Optionnel (macOS 26+ Apple Silicon)
brew install Arthur-Ficial/tap/apfel         # LLM local Apple Intelligence

Mise à jour : git pull && ./install.sh — Désinstallation : ./install.sh --uninstall

CLI Go (v5+)

À partir de v5, ulk est distribué comme un binaire Go unique (ulk) qui remplace progressivement install.sh. Le bash reste en wrapper de compatibilité.

ulk install [--with-*]    # installation avec TUI wizard au premier run
ulk update [--check]      # diff checksums + rollback auto sur erreur
ulk uninstall [--module]  # désinstalle un module ou tout (--all)
ulk status                # modules ✓/○ + version
ulk verify                # chemins + prérequis + LLM locaux
ulk check                 # CLIs + skills installés

État persistant dans ~/.ulk/state.json (écriture atomique). Backup/rollback automatique. 14 modules opt-in (Figma, Swift, Flutter, VPS, Agent Teams…).

Architecture, flux et build local : docs/guides/cli-go.md

Par où commencer

Commande Ce que ça fait
/ulk:bruce Point d'entrée principal — détecte l'état du projet et orchestre tout
/ulk:godspeed Diagnostic rapide : stack, état, prochaine action suggérée
/ulk:shuri Pipeline doc : spec → todo Kanban → sync
/ulk:sargeras Audit omniscient 10 axes avec score et verdict
/ulk:2b3 Checkpoint fin de session : lint → docs → commit
/ulk:strange Reverse doc (code → docs) · mode=prompt : reverse-engineering de prompt (output IA → prompt probable)

Mobile Natif

Pipeline complet web-vers-mobile en 3 agents :

happy (49)  →  docs/api/  →  steve (27) + fluke (48)
   API architect      OpenAPI 3.1      iOS/macOS    Android/Flutter
  • Happy audite le projet web, conçoit l'API REST/GraphQL complète (auth, push, offline sync)
  • Steve lit docs/api/ et génère un starter kit SwiftUI compilable (+ 7 Swift skills bundlés)
  • Fluke lit docs/api/ et génère un starter kit Kotlin/Compose ou Flutter (+ 2 Flutter skills bundlés)

Apple Intelligence (optionnel)

Sur macOS 26+, ulk delegue les micro-taches (extraction, classification, resume) a Apfel — Apple Intelligence en local, gratuit, 0 tokens Claude.

brew install Arthur-Ficial/tap/apfel   # installer
./install.sh --check                   # verifier la detection

2 agents l'utilisent actuellement (godspeed, 2b3) — fallback Claude si absent. Protocole unifié : framework/agents/_shared/local-llm-protocol.md. Roadmap : task-runner (commit msg), ci-guard (classification erreur CI), shuri (frontmatter YAML).

Multiplateforme : ollama gemma3:1b couvre les mêmes micro-tâches sur Linux/Windows (128K ctx, diffs longs) :

brew install ollama && ollama pull gemma3:1b   # multiplateforme

Community Skills (bundlés)

Collection Skills Source
Figma (7) figma-use, figma-implement-design, figma-code-connect, figma-generate-library, figma-generate-design, figma-create-design-system-rules, figma-create-new-file Figma Inc.
Swift (7) SwiftUI Pro, SwiftData Pro, Concurrency, Testing, A11y, Architecture, Security twostraws + communauté
Flutter (2) Flutter Tester, OWASP Mobile Security Harishwarrior
Obsidian / kepano (5) obsidian-markdown, obsidian-bases, obsidian-cli, json-canvas, defuddle Steph Ango (kepano), MIT
context-audit (1) /context-audit — health score 0-100 : MCP servers, CLAUDE.md bloat, skills, settings Vesely/skills
symbols (1) /symbols list|view|refs — navigation LSP TS/JS, -40 à -74% tokens sur fichiers > 150L ulk, MIT
architecture-diagram (1) diagrammes HTML+SVG self-contained, 100% local Cocoon-AI, MIT

Bundlés par défaut : Figma, Swift, Flutter, Obsidian/kepano, context-audit, symbols, architecture-diagram.
Config MCP Figma : ./install.sh --with-figma-mcp · Opt-out kepano : --without-obsidian-skills
Opt-in : --with-nothing-design · --with-a11y-skills · --with-hue-skill · --with-logo-generator-skill · --with-cwb-app-icon · --with-caveman-output-skill · --with-kami-skill.

Plugins Marketplace

Skills installées via le marketplace Claude Code intégré (pas via install.sh) :

  • ui-ux-pro-max-skill (nextlevelbuilder, 72.8k★) — lookup design contextuel : 161 palettes industry-specific, 57 font pairings, 99 UX guidelines, 25 chart types × 15 stacks. Complémentaire à /hue (génération vs lookup). Install : /plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
  • pomodoro (jakedahn) — timer + mémoire SQLite (sessions, analytics, patterns). Install : /plugin marketplace add jakedahn/pomodoro

Managed Agents (Anthropic beta)

Sessions Claude Code cloud — pas besoin de machine locale. Activation : ./install.sh --with-managed-agents.

5 agents portés : ed209 · sargeras · 2b3 · ci-guard · lovecraft-memory-capture. Invocation : ulk ma <agent> "<prompt>".

Accountability (Audit Trail)

./install.sh --with-accountability active un PostToolUse hook qui trace toutes les mutations Edit/Write/MultiEdit/NotebookEdit/Bash dans <projet>/.ulk-reports/accountability.jsonl (gitignored). Lecture : ./framework/tools/accountability-report.sh.

Prérequis

  • Claude Code 2.1+ — claude.ai/code (Desktop, Web, ou CLI ; native binary recommandé depuis 2.1.113)
  • git — cloner et mettre à jour ulk
  • Node.js 18+ — pour les générateurs (cheatheet/)
  • macOS, Linux, ou Windows — install.sh (bash/Git Bash) ; PowerShell tool natif sur Windows depuis CC 2.1.84
  • curl — pour l'installation distante (déjà présent sur macOS/Linux)

Compatibilité Claude Code 2.1

ulk tire parti des features récentes de Claude Code :

Feature CC Version Usage ulk
Skills hot-reload 2.1.0 Agents et skills disponibles immédiatement après ajout, sans redémarrage
Auto-memory natif 2.1.32+ Coexiste avec lovecraft (47) et le memory loop opt-in (--with-memory-loop)
Hooks SessionEnd/PreCompact 2.1.85, 2.1.105 Alternative aux routines cron pour 2b3 (checkpoint automatique)
/loop natif 2.1.71 Recommandé en remplacement progressif des cron-based routines (Routine 53)
/branch (ex /fork) 2.1.71 Forks de conversation pour explorer plusieurs pistes
isolation: "worktree" 2.1.49 Audits propres (Sargeras, ED-209) — voir docs/todo.md ULK-207
Subagent forké 2.1.117 CLAUDE_CODE_FORK_SUBAGENT=1 réduit la pollution contexte des orchestrateurs
Sonnet 4.6 / Opus 4.6 2.1.45, 2.1.68 Modèles par défaut ; agents critiques pinned sur Opus

Agents (85)

Liste complète par catégorie : framework/agents/registry.md

Catégories : orchestrators/ · docs/ · audit/ · session/ · mobile/ · sync/ · routines/ · frontend/ · analyze/ · deploy/ · test/ · vps/

Derniers ajouts (56-62) : Killbill (cost killer + killswitch) · Xavier (vérif contexte) · Stark (designer en chef) · Alex (musitech) · Agathe (DA garante du goût) · mdr (Senior Product Strategist) · Frodo (audit générationnel).

Documentation

  • Guide — Démarrage, workflows, FAQ
  • ADR — Décisions d'architecture et leurs raisons
  • Glossaire — Terminologie ulk
  • Spec projet — État et roadmap du projet