Dépôt template¶

Un dépôt Git prêt à cloner qui condense installation, plugins, PROMPT, workflow et automatisation.

Vision¶

Les chapitres 1 à 6 montrent quoi installer, quoi écrire, comment enchaîner les skills. Un dépôt template condense tout cela en un point d'entrée unique : un git clone, une issue à déclencher, et le projet s'initialise tout seul via l'interview Socratique.

graph LR
    A["Clone<br/>le template"] --> B["Issue #1<br/>pré-remplie"]
    B --> C["/from-issue 1"]
    C --> D["Interview<br/>Socratique"]
    D --> E["Validation"]
    E --> F["PROMPT.md<br/>+ branche + plan"]
    F --> G["Exécution<br/>Phase 1"]

    style B fill:#2196f3,color:#fff
    style D fill:#4caf50,color:#fff
    style F fill:#4caf50,color:#fff

Contenu du template¶

mon-template-claude-code/
├── .claude/
│   ├── settings.json              # Hooks (Stop, PostToolUse, PreToolUse)
│   ├── commands/
│   │   ├── from-issue.md          # Issue → brainstorming → plan
│   │   ├── next-plan-step.md      # Exécute la tâche suivante du plan
│   │   ├── review.md              # Review enrichie par les rapports CI
│   │   └── ci-report.md           # Résumé des rapports CI
│   └── scripts/
│       └── branch-and-plan.sh     # Crée branche + worktree + commit plan
├── .gitea/
│   ├── workflows/
│   │   ├── trivy.yml              # Scan sécurité
│   │   ├── sonar.yml              # Quality gate
│   │   └── renovate.yml           # Mise à jour des dépendances
│   └── issue_template/
│       └── 01-bootstrap.md        # Issue pré-remplie pour lancer l'interview
├── superpowers/
│   ├── plans/                     # Plans versionnés (vide au départ)
│   └── specs/                     # Specs de design (vide au départ)
├── CLAUDE.md                      # Squelette minimal, complété par Phase 1
├── renovate.json5                 # Config Renovate self-hosted
├── .gitignore
└── README.md                      # Mode d'emploi du template

L'issue #1 — la première demande¶

C'est le point d'entrée narratif du template. Elle est pré-remplie dans .gitea/issue_template/01-bootstrap.md et déposée automatiquement dans la file d'issues lors du premier git push vers Gitea.

<!-- .gitea/issue_template/01-bootstrap.md -->
---
name: Bootstrap du projet
about: Lance l'interview Socratique et génère PROMPT.md + CLAUDE.md
labels: bootstrap
---

## Objectif

Initialiser ce projet à partir du template : interview Socratique,
génération du PROMPT.md, setup de la stack, premier commit.

## Procédure

1. Ouvrir Claude Code à la racine du dépôt
2. Lancer `/from-issue 1`
3. Répondre à l'interview (5-15 min)
4. Valider la synthèse du brainstorming
5. Laisser Claude créer la branche, committer le plan, ouvrir la PR
6. Piloter l'exécution par commentaires de PR ("étape N")

## Critères d'acceptation

- [ ] PROMPT.md à la racine, sections obligatoires présentes
- [ ] CLAUDE.md généré à partir du code posé
- [ ] Linting, formatting et tests configurés
- [ ] Premier commit propre sur `main`
- [ ] CI verte (Trivy, Sonar, tests)

Quand /from-issue 1 s'exécute, il lit cette issue, extrait l'objectif, et invoque /superpowers:brainstorming avec ce contexte. L'interview Socratique du chapitre 03 devient la conversation naturelle pilotée par ce skill.

Le parcours complet depuis le template¶

sequenceDiagram
    actor U as Vous
    participant T as Template
    participant G as Gitea
    participant C as Claude Code
    participant CI as CI

    U->>T: git clone
    U->>G: git push → repo créé
    G->>G: Issue #1 auto-créée depuis template
    U->>C: /from-issue 1
    C->>C: /superpowers:brainstorming<br/>(interview Socratique)
    C->>U: Synthèse (stack, features, conventions)
    U->>C: Validation
    C->>G: branch-and-plan.sh → branche + worktree + plan committé + PR
    loop Phase 1
        U->>G: Commentaire PR "étape N"
        G->>C: Webhook → /next-plan-step
        C->>G: Commit + push
        G->>CI: Trivy + Sonar + tests
    end
    C->>C: /review (lit les rapports CI)
    U->>G: Merge → PROMPT.md + CLAUDE.md sur main

Mode d'emploi (côté utilisateur)¶

# 1. Cloner le template
git clone https://projects.nuevolia.dev/templates/claude-code-starter mon-projet
cd mon-projet
rm -rf .git && git init && git checkout -b main

# 2. Pousser vers votre forge (crée l'issue #1 automatiquement)
git remote add origin https://projects.nuevolia.dev/moi/mon-projet
git add . && git commit -m "chore: import template"
git push -u origin main

# 3. Ouvrir Claude Code et déclencher l'interview
claude

Dans Claude Code :

/from-issue 1

C'est tout. Le reste du pipeline du chapitre Automatisation prend le relais.

Personnaliser le template¶

Pourquoi un template plutôt qu'une checklist¶

Le template est la cristallisation des chapitres 1 à 6 : ce qui était enseignement devient artefact exécutable.