Aximande/agent-skills / skills/spec-lite
spec-lite
VerifiedUne page de critères d'acceptation avant de vibecoder — spec-kit compressé à la seule étape « specify », moteur grilling. Chaque critère est observable et formulé pour que proof-run l'exécute tel quel ; la spec est vérifiée par un agent frais qui ne voit qu'elle, puis vit dans le repo (table d'état remplie au proof-run, relue par ship-check). Use when: « fais une spec », « qu'est-ce qu'on construit exactement ? », avant de démarrer un projet ou une feature vibecodée, ou /spec-lite. Uniquement sur demande explicite.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.7 KB |
SKILL.md
View on GitHub---
name: spec-lite
description: >
Une page de critères d'acceptation avant de vibecoder — spec-kit
compressé à la seule étape « specify », moteur grilling. Chaque critère
est observable et formulé pour que proof-run l'exécute tel quel ; la
spec est vérifiée par un agent frais qui ne voit qu'elle, puis vit dans
le repo (table d'état remplie au proof-run, relue par ship-check).
Use when: « fais une spec », « qu'est-ce qu'on construit exactement ? »,
avant de démarrer un projet ou une feature vibecodée, ou /spec-lite.
Uniquement sur demande explicite.
license: MIT
---
# Spec Lite
Dire **quoi et pourquoi** avant de laisser l'agent décider **comment** —
sans réveiller la bureaucratie qui tue le spec-driven development.
Trois principes :
- **Une page, c'est dur.** Une spec qu'on ne relit pas est pire que pas
de spec. Budget : 1 page, ≤ 10 critères (≤ 5 pour une exploration).
Refuser de gonfler, même si on sait remplir.
- **Un critère est observable ou il n'est pas.** Chaque critère est écrit
pour qu'un vérificateur qui ne voit que la spec puisse le *jouer* dans
l'app — c'est le format d'entrée de proof-run.
- **Une ambiguïté se résout par grilling, jamais par du remplissage.**
Pas de « [à clarifier] » laissé en trou, pas de prose qui meuble.
## 0. Cadrage
- Projet neuf ou feature sur un existant ? Échelle : produit, outil
interne, exploration — l'exploration a droit à 5 critères et zéro
cérémonie.
- Ce que l'utilisateur a déjà dit est acquis. Ne demander que ce qui
change les critères.
## 1. Grilling — verrouiller les décisions
- Rounds de questions serrées, uniquement sur ce qui change le
livrable : l'utilisateur cible, le job en une phrase, le **hors
périmètre**, les arbitrages (plateformes, données, qualité vs
vitesse).
- « on continue » = trancher soi-même, et consigner chaque choix en
**Assomptions** — jamais en silence.
- C'est l'équivalent des marqueurs `[NEEDS CLARIFICATION]` de
spec-kit — résolus séance tenante au lieu d'être laissés dans le
document.
## 2. La page — `SPEC.md`
Committée à la racine du repo cible (c'est un artefact du projet,
contrairement aux rapports des autres skills). Projet neuf → `SPEC.md` ;
feature sur un existant → `SPEC-<feature>.md` (un repo accumule des
specs, payé au rodage) :
```markdown
# SPEC — <nom> (<date>)
**Job** : <une phrase — pour qui, quoi, pourquoi maintenant>
**Hors périmètre** : <la liste qui protège le focus>
## Critères d'acceptation (P1 = MVP viable à lui seul)
- **C1 (P1)** — Étant donné <état>, quand <action>, alors <résultat observable>.
- **C2 (P1)** — …
- **C5 (P2)** — …
## Cas limites
- <ce qui casse : entrée vide, gros fichier, offline, double-clic…>
## Assomptions (tranchées au grilling, ou par l'agent sur « on continue »)
- <choix> — <pourquoi>
## État (rempli par proof-run, relu par ship-check)
| Critère | État | Preuve / raison |
|---|---|---|
| C1 | — | |
```
- Priorisation héritée de spec-kit : **les critères P1 forment seuls un
produit viable** ; chaque priorité est démontrable indépendamment.
- Critères tech-agnostiques — le « comment » appartient au vibecode.
Mais **tech-agnostique ne veut pas dire vague** : la surface observable
se nomme exactement (l'URL, la commande, l'écran) — c'est le *où* du
test, pas un choix d'implémentation. Un vérificateur qui ne sait pas
quelle URL appeler ne peut pas jouer le critère (payé au rodage).
- Chiffrés quand c'est du perf/volume (« en moins de 2 s »), jamais
d'adjectif (« rapide », « clair », « agréable » = à reformuler).
- Un critère négatif (« rien ne se passe », « aucune écriture ») dit
**où l'absence s'observe** (la table, le log, l'inbox) — sinon il est
injouable.
## 3. Vérification — la spec passe l'agent frais
Un agent qui ne voit **que** `SPEC.md` répond : (a) trois cas piège
« est-ce dans le périmètre ? » ; (b) pour chaque critère, « peux-tu le
jouer dans l'app sans autre contexte ? ». Un périmètre raté ou un
critère injouable = reformuler avant livraison. Cap 2 rounds.
## 4. La spec vit — la dérive tracée, pas subie
- Au **proof-run**, chaque critère passe ✅ prouvé / ⚠️ modifié (avec le
pourquoi) / ❌ abandonné — c'est le « converge » de spec-kit, ramené à
une table. Un critère de la spec est un check de proof-run tel quel.
- **ship-check** relit la table : un ❌ ou un « — » sans raison au moment
de publier est un flag.
- Commit de `SPEC.md` seul, sans Co-Authored-By ni mention d'IA.
Place au pipeline : tête de pipeline, avant vibecode. Aval : proof-run
exécute les critères, ship-check audite la table d'état.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |