Parent : [[INDEX-DEV-GENERAL]]

Bootstrap projet web — checklist J0

Problème

Sans bootstrap standard, chaque projet repart avec des oublis (pas de DESIGN.md, pas de .env.example, build non testé) → retour « corrige mes erreurs » quelques jours plus tard.

Solution — Faire avant le premier composant

Fichiers racine obligatoires

Fichier	Contenu minimum
`DESIGN.md`	Template knowledge-core (PAT-144 ou DESIGN-tool.md)
`.env.example`	Toutes les vars sans secrets
`README.md`	Install, dev, build, deploy en 10 lignes
`.gitignore`	node_modules, .env, .next, dist

Config TypeScript

{
  "compilerOptions": {
    "strict": true,
    "noUncheckedIndexedAccess": true,
    "noImplicitReturns": true,
    "skipLibCheck": true
  }
}

Scripts package.json minimum

{
  "scripts": {
    "dev": "...",
    "build": "...",
    "lint": "...",
    "typecheck": "tsc --noEmit"
  }
}

Premier commit gate

npm install
npm run typecheck
npm run build
python path/to/knowledge-core/meta/validators/project-excellence.py .

Outil annotation (en plus)

Copier meta/templates/DESIGN-tool.md → DESIGN.md
Lire PAT-149, 150, 151, 152 avant code
Schema AnnotationDocument v1 défini (PAT-150)

Agent / IA

Sur nouveau projet web détecté (pas de DESIGN.md) :

Proposer bootstrap PAT-153 avant d'écrire UI
Ne pas générer 20 composants sans DESIGN.md

Source

ACT-ALW-005 — 2026-06-09

Liens connexes

[[KNOW-PAT-143|KNOW-PAT-143]]
[[KNOW-PAT-144|KNOW-PAT-144]]