agentleFS
BriGadjaBriGadja/iapreneurs-claude-code-kit/.claude/skills/close/SKILL.md

close

Skill6 starsChanged 6 months agoMITView on GitHub

Utiliser à la fin d'une phase (après /validate ✅) pour clôturer proprement. Marque la phase ✅ Terminée dans le PRD, propose un commit conventionnel, fait le harvest mémoire si triggers détectés. Skill mandatory post /validate ✅. Ne PAS utiliser sans /validate ✅ préalable, ni au milieu d'une phase en cours.

  • Commits and pushes

26 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use open, reconcile and 4 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • BlockSkill

    open

    Open markdown documents in Penpal for collaborative review. Use when you want a human to review a document, plan, or research artifact.

    Also in 5 projects that use this

  • howellsSkill

    reconcile

    Audit a project against current plugin conventions and offer to update structure.

    Also in 3 projects that use this

  • OpenAISkill

    bootstrap

    Project bootstrapping orchestrator for repos that depend on Vercel-linked resources (databases, auth, and managed integrations). Use when setting up or repairing a repository so linking, environment provisioning, env pulls, and first-run db/dev commands happen in the correct safe order.

    Also in 3 projects that use this

  • genomewalkerSkill

    resume

    Resume a thread by loading its ~800-token context capsule

    Also in 3 projects that use this

  • AnthropicSkill

    brief

    Generate contextual briefings for legal work — daily summary, topic research, or incident response. Use when starting your day and need a scan of legal-relevant items across email, calendar, and contracts, when researching a specific legal question across internal sources, or when a developing situation (data breach, litigation threat, regulatory inquiry) needs rapid context.

    Also in 3 projects that use this

  • SentrySkill

    review

    Fixture review skill.

    Also in 5 projects that use this

The file

Files
SKILL.md

Skill /close — clôturer proprement une phase

Invocation : /close (rien à passer, le skill détecte la phase depuis le PRD + git status).

Mandatory post-/validate ✅ depuis v2.0 — sans /close, le commit n'est jamais fait et le PRD reste non-à-jour. Le handoff de /validate ne propose plus le skip.

Pour quoi faire

Après /validate ✅, faire la sortie propre :

  1. Marquer la phase ✅ Terminée le YYYY-MM-DD dans le PRD parent — source unique depuis v2.0 (avant, /execute Étape 3 marquait aussi → doublon résolu).
  2. Proposer un message de commit conventionnel à partir du diff git réel.
  3. Demander confirmation avant git commit. Pas de git push automatique.
  4. Suggérer la prochaine étape :
    • Si ce n'est pas la dernière phase → /plan Phase {N+1}
    • Si c'est la dernière phase ET projet jamais shipped (pas d'<!-- ship:url --> rempli dans CLAUDE.md) → /livrer
    • Sinon → pause projet (et /prime pour reprendre plus tard)

C'est court. C'est un rituel, pas un skill de production.

Règle stricte

Pas de commit sans validation utilisateur explicite. Tu écris le message, tu l'affiches, l'utilisateur dit "oui" → tu commits. Pas avant.

Comment procéder

Étape 0 — Détection du scope (no-op / planning / full)

Lis references/mode-detection.md et applique sa procédure (lecture trace.jsonl + calcul diff git + planning_paths + décision 3 modes + annonce).

À la sortie : tu sais si tu es en mode no-op (fin du skill direct), planning (rapide), ou full (cérémonie complète).

Étape 0.5 — Update STATUS.md (modes planning ET full)

Cette étape tourne en mode planning et full (skippée en no-op).

0.5.1 — Créer STATUS.md si absent (projet pré-v2.2 migré manuellement) : écrire le template canonique (voir A1 du plan v2.1) avec {Nom du projet} laissé tel quel — /start le résoudra à la prochaine session si pas déjà fait.

0.5.2 — Lire trace.jsonl : la dernière ligne = dernier skill exécuté avant /close. C'est la base de "Dernière étape" et "Prochaine étape recommandée".

0.5.3 — Lire STATUS.md actuel pour récupérer l'historique récent (5 dernières lignes max).

0.5.4 — Réécrire la zone entre <!-- close:active --> et <!-- /close:active --> avec :

  • **Dernière étape** = dernier skill du trace + son artifact + date du jour
  • **Prochaine étape recommandée** = next du dernier trace, ou suggestion contextuelle
  • **Dernier commit reflété** = git rev-parse --short HEAD (sera ensuite mis à jour post-commit avec le nouveau SHA — voir 0.5.6)
  • ## Historique récent = jusqu'à 5 lignes, la plus récente en haut (drop la plus ancienne si > 5)

Pattern d'écriture : read fresh + atomic (écrire tmp puis mv).

0.5.5 — Ordre absolu :

Mode planning (gain ~30-60s) — pas d'amend SHA :

  1. Update STATUS.md sans le champ Dernier commit reflété (ou laisser la valeur précédente — sera rafraîchie lazily au prochain /close full ou /prime)
  2. git add -A
  3. git commit -m "{message}"

Mode full — séquence complète avec amend SHA :

  1. Update STATUS.md (zone active, sans le SHA post-commit encore)
  2. git add -A (inclut STATUS.md modifié)
  3. git commit -m "{message}"
  4. Refresh STATUS.md : ré-écrire le champ Dernier commit reflété avec git rev-parse --short HEAD (le nouveau SHA), puis git commit --amend --no-edit (ou commit séparé chore: refresh STATUS sha si amend bloqué par l'utilisateur).

Cet ordre garantit que le commit inclut STATUS.md à jour. Si l'écriture STATUS.md échoue (disque plein, permissions) → NE PAS commit. Re-run /close est idempotent.

0.5.6 — Supprimer tmp/skill-trace.jsonl (consommation). À faire après la réussite de l'écriture STATUS.md. Si l'écriture a échoué, NE PAS supprimer (recover possible).

Étape 0.6 — Audit caps (CLAUDE.md, PRD.md)

Skip silencieux en mode planning (les artefacts planning — brief, SPEC, plan — ne touchent jamais les limites de CLAUDE.md/PRD.md aux endroits scrutés ici). Cette étape ne tourne qu'en mode full.

Lis references/audit-caps.md et applique (0.6.1 audit CLAUDE.md > 200L + 0.6.2 audit PRD.md > 100L + 0.6.3 ack flag anti-spam). Ne bloque jamais le commit — juste warn + propose.

Étape 1 — détecter la phase clôturée

Note mode planning : en mode planning, on skip Étapes 1, 2, 3 (pas de phase à marquer dans le PRD — la planning artifact est elle-même l'output). On garde Étapes 4-5 (commit). On skip Étapes 6.2-6.3 (3 questions harvest — déjà couvertes par les mining markers planning). On écrit un marker [plan-mining-done:{artifact-slug}] dans memory/daily/{today}.md (créé si absent — convention alignée avec workspace). Étape 7 = annonce + bloc handoff.

Note mode full : enchaînement actuel intact (Étapes 1-7), avec en plus les Étapes 0 + 0.5 ajoutées en amont.

Lis PRD.md. Cherche la dernière phase qui n'est PAS encore marquée ✅ Terminée. Confirme à l'utilisateur :

"Je vais clôturer Phase {N} — {nom}. C'est ça, ou tu veux clôturer une autre phase ?"

Si l'utilisateur dit "phase Y" → utilise celle-là. Sinon continue.

Étape 2 — vérifier que /validate a tourné

Lis le plan de la phase. Cherche d'abord dans docs/plans/phase-{N}-plan.md (convention v2.1.0+), puis fallback plans/phase-{N}.md, puis phase-{N}-plan.md à la racine (projets pré-v2.1.0). Le commit message guidé (Étape 4) référence le path complet docs/plans/phase-{N}-plan.md quand le plan est à cet emplacement.

Cherche un bloc ## Validation Phase {N} avec verdict ✅ OK. Si absent ou si verdict ❌ KO / ⚠️ Partiel non résolu :

"La Phase {N} n'a pas de verdict ✅ OK dans son plan. Tu veux lancer /validate d'abord, ou tu confirmes que la phase est vraiment finie ?"

Si l'utilisateur confirme malgré tout, continue. Si pas de réponse, stoppe.

Étape 3 — marquer la phase ✅ Terminée dans le PRD (adaptateur format)

Détecte le format via les 4 branches (identiques à /evoluer + /prime) :

has_new = grep -q "^## 7. Implementation Phases" PRD.md
has_old = grep -q "^## Phases" PRD.md

Branche 1 — Nouveau format v2.2 (## 7. Implementation Phases présent) :

  • Dans ## 3. Scope actuel (V_n) (sous-sections ### Core ou ### Technique) : cocher la checkbox correspondant à la feature livrée (- [ ] {feature} → - [x] {feature}).
  • Dans ## 7. Implementation Phases : remplacer **V_n (en cours)** — {nom} par **V_n (livré le {YYYY-MM-DD})** — {nom}.

Branche 2 — Ancien format v2.1.x legacy (## Phases présent) :

  • Section ## Phases, remplacer - **Phase {N}** — {nom} : {description} par - **Phase {N}** — {nom} : {description} ✅ Terminée le {YYYY-MM-DD} (comportement legacy intact).

Branche 3 — État mixte : warn "PRD en état mixte. Migration recommandée via docs/MIGRATION-v2.1-to-v2.2.md." Marquer dans le nouveau format en priorité.

Branche 4 — PRD malformé : warn et skip Étape 3 (commit Étape 5 quand même OK).

Étape 4 — composer le message de commit

Lis references/commit-message-builder.md et applique :

  • Mode planning : auto-commit sans dialogue à partir du dernier skill du trace.jsonl (template déterministe).
  • Mode full : dialogue de validation avec l'utilisateur ({type}({scope}): {what} — {why} itéré jusqu'à validation).

Étape 5 — commit (après validation explicite)

Lance :

git add -A
git commit -m "{message validé}"

Annonce le SHA résultant. Ne push pas automatiquement — c'est à l'utilisateur de décider quand pousser (et où).

Étape 6 — Harvest learnings (silencieux par défaut)

Post-commit, écris uniquement l'auto-récap session dans memory/learnings/{date}.md — pas de question à l'utilisateur, pas d'annonce.

Lis references/harvest-questions.md et applique : 6.1 auto-récap silencieux + 6.3 index conditionnel. Les questions ciblées par trigger (ancienne 6.2) et l'annonce (ancienne 6.4) sont supprimées depuis v2.8.1 — les gens veulent ship, pas répondre à des questions admin.

Étape 6.4 — SPEC frozen header (post-/evoluer + /execute)

Si /evoluer a été le dernier skill significatif avant cette session (présence d'un docs/specs/SPEC-*.md créé ou modifié dans le diff git de cette /close), ajouter en tête du SPEC un header informatif :

<!-- frozen: {YYYY-MM-DD} -->

Idempotent : si le header existe déjà, skip. Signal informatif uniquement (pas d'enforcement runtime — sert pour /prime + revue manuelle).

Étape 6.5 — Gate déploiement (conditionnelle, Vercel uniquement)

Insérée entre l'Étape 6 (harvest) et l'Étape 7 (suggestion). Cette étape propose un push contextuel quand le projet est lié à Vercel et qu'il reste des commits non-pushés. Sinon elle se skip silencieusement (zero friction).

6.5.1 — Conditions de déclenchement (TOUTES doivent être vraies, sinon skip direct vers Étape 7) :

# C1 — Vercel lié au projet ?
COND_VERCEL=0 ; test -f .vercel/project.json && COND_VERCEL=1

# C2 — commits non-pushés OU changements non-commités sur main ?
COND_UNPUSHED=0
if git rev-parse --abbrev-ref --symbolic-full-name @{u} >/dev/null 2>&1 ; then
  AHEAD=$(git rev-list --count @{u}..HEAD 2>/dev/null || echo 0)
  [ "$AHEAD" -gt 0 ] && COND_UNPUSHED=1
fi
# OU il n'y a pas encore d'upstream (cas premier deploy avec branche locale)
git rev-parse --abbrev-ref --symbolic-full-name @{u} >/dev/null 2>&1 || COND_UNPUSHED=1

# C3 — project_type ∈ {webapp, site} ?
PT=$(grep -oE 'project_type:\s*(webapp|site|automation)' CLAUDE.md 2>/dev/null | sed -E 's/.*:\s*//')
COND_TYPE=0
case "$PT" in webapp|site) COND_TYPE=1 ;; esac
# Fallback : si project_type non détectable (regex échoue, ancre absente) → skip 6.5 silencieusement, pas d'erreur
[ -z "$PT" ] && { echo "Étape 6.5 skipped (project_type non détectable)" ; SKIP_65=1 ; }

Si COND_VERCEL == 1 && COND_UNPUSHED == 1 && COND_TYPE == 1 && SKIP_65 != 1 → continue 6.5.2. Sinon → skip silencieux vers Étape 7.

6.5.2 — AskUserQuestion : 3 options

"Le projet est lié à Vercel et tu as des commits non-pushés. Tu veux quoi maintenant ?"

Options :

  1. Commit only — comportement actuel /close, pas de push (push différé à plus tard)
  2. Push main = deploy prod auto — git push origin main puis affichage URL prod (lue depuis <!-- ship:url -->) + délai 90s annoncé pour le build Vercel
  3. Push sur branche feature = preview Vercel — propose un nom de branche slugifié (ex : feat/{topic-court}), crée la branche, push, affiche l'URL preview attendue (pattern générique https://{slug}-git-{branche}-{team}.vercel.app)

6.5.3 — Exécution selon l'option choisie

  • Option 1 (commit only) : ne rien faire de plus, passe à 6.5.4.
  • Option 2 (push main) :
    git push origin main
    Affiche : "Push effectué sur main. Vercel build en cours, ~1-2 min. URL prod : {URL_PROD lue depuis ship:url}. Le smoke test n'est pas relancé ici — c'est /livrer qui s'en charge si tu veux vérifier."
  • Option 3 (push branche feature) :
    BRANCH_NAME="feat/{slug-suggéré}"
    git checkout -b "$BRANCH_NAME"
    git push -u origin "$BRANCH_NAME"
    Affiche : "Branche {BRANCH_NAME} créée et pushée. Vercel crée un déploiement preview. URL attendue (pattern générique) : https://{slug}-git-{branche-slugifiée}-{team}.vercel.app — visible dans le PR si tu en ouvres un, ou dans le dashboard Vercel onglet Deployments."

6.5.4 — Trace enrichie

Append à tmp/skill-trace.jsonl (en plus de la trace standard de close) :

{"skill":"close","deploy_action":"commit_only|push_main|push_feature","ts":"<ISO8601>"}

Si 6.5 a été skip (conditions non remplies ou fallback project_type indétectable) → deploy_action: null.

Étape 7 — suggestion suivante

Lis PRD.md ## Phases. Identifie la phase suivante (première sans ✅ Terminée).

  • Si une phase suivante existe :

    "Phase {N} clôturée. Tu veux enchaîner sur Phase {N+1} — {nom} maintenant avec /plan Phase {N+1}, ou tu fais une pause ?"

  • Si toutes les phases sont ✅ Terminées (Phase {N} était la dernière), vérifie si le projet a déjà été shipped : grep <!-- ship:url --> dans CLAUDE.md, regarde si le bloc contient une URL (pas juste le placeholder).
    • Pas encore shipped :

      "Phase {N} clôturée. Toutes les phases du PRD sont ✅ Terminées et le projet n'a jamais été déployé. Tu veux lancer /livrer pour passer en production ?"

    • Déjà shipped :

      "Phase {N} clôturée. Toutes les phases du PRD sont ✅ Terminées et le projet est déjà en production. Quand tu veux ajouter une feature → /evoluer (v2.0 GA). Sinon, projet bouclé. 🎉"

Risque #1 — commit silencieux

Si tu lances git commit sans avoir affiché le message et obtenu un "oui", tu peux écrire n'importe quoi dans l'historique du projet — et l'historique est public dès le push. Test du miroir : tu dois pouvoir citer le message que l'utilisateur a explicitement validé. Si tu ne te souviens pas l'avoir affiché, tu n'as pas le droit de commit.

Risque #2 — clôturer une phase pas finie

Si /validate n'a pas dit ✅ OK, la phase n'est pas finie. Marquer ✅ Terminée à ce stade pollue le PRD et casse le repère "où on en est". Test du miroir : tu dois pouvoir pointer le bloc ## Validation Phase {N} avec verdict OK avant d'écrire ✅ Terminée le ....

Quand ne PAS utiliser ce skill

  • Au milieu d'une phase (tâches encore [ ] non cochées) → /execute d'abord
  • Sans /validate préalable (sauf si l'utilisateur force) → /validate d'abord
  • Pour pousser vers GitHub → c'est git push, pas un skill (et c'est à l'utilisateur de décider)
  • Pour archiver le projet → c'est manuel (move vers archive/, mise à jour README)

Trace de fin

/close est le consommateur de tmp/skill-trace.jsonl — il lit puis supprime le fichier (voir Étape 0.5.6). Il n'append pas de ligne lui-même : /close est le dernier maillon de la chaîne avant /clear.

Handoff

Trois variantes selon le mode détecté en Étape 0 :

Trois variantes, 3-5 lignes max. Pas de paragraphe d'explication, pas de récap admin.

Mode no-op :

"Rien à clôturer. /clear quand tu veux."

Mode planning :

"✅ Commit {SHA} · STATUS à jour → /clear puis /{next-skill}"

Mode full (fin de phase) :

"✅ Phase {N} clôturée · commit {SHA} · STATUS à jour → /clear puis /{next-skill}"

next-skill selon l'état du PRD :

  • Phase suivante existe → /plan Phase {N+1}
  • Dernière phase + pas shipped → /livrer
  • Dernière phase + déjà shipped → fin de cycle (/evoluer quand tu auras une nouvelle feature)

Prochaine étape : /clear puis /{next-skill} (voir variante du mode ci-dessus).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.