| name | onboard |
| description | Onboarding complet sur un projet existant. Analyse, comprend et documente le projet pour que l'agent soit immédiatement productif. |
| disable-model-invocation | true |
Instructions
Phase 1 — Scan Rapide (4 agents parallèles)
Agent 1 — Structure & Stack :
- Lire
package.json / pyproject.toml (dépendances = stack réelle)
- Identifier framework, runtime, ORM, auth, paiements
- Détecter package manager (pnpm/bun/npm via lockfile)
Agent 2 — Architecture & Patterns :
- Arborescence 2 niveaux max
- Pattern architectural : hexagonal | MVC | feature-based | flat
- Conventions de nommage (kebab, camel, PascalCase sur les fichiers)
- Détecter si
organizationId présent sur les tables → multi-tenant
Agent 3 — Tests & Qualité :
- Test runner + config (vitest.config, jest.config, playwright.config)
- Ratio fichiers test / fichiers source
- Chercher
console.log et any (indicateurs de dette rapide)
- Chercher secrets hardcodés : patterns
sk_, pk_, password=, secret=
Agent 4 — Infra & Deploy :
- CI/CD :
.github/workflows/, .gitlab-ci.yml
- Provider déploiement (Vercel, Railway, Docker, AWS)
- DB et auth provider
- Variables
.env.example présentes ?
Phase 2 — Health Check (script unifié)
python scripts/project_health.py
Retourne : erreurs TS, lint, tests, console.log count, any count, structure hexagonale, audit sécurité.
Phase 3 — Deep Dive (si nécessaire)
Lire les fichiers critiques :
- Point d'entrée principal (
app/layout.tsx, main.ts, server.ts)
- Schema DB / dernières migrations
- Middleware d'auth
- 1-2 features complètes comme référence de style
Phase 4 — Documentation
Générer/mettre à jour :
.claude/memory/project-scan.md — scan complet
.claude/memory/stack.md — stack + versions
.claude/memory/domains.md — domaines et entités détectés
.claude/memory/patterns.md — patterns de code observés
Phase 5 — Recommandations
Basé sur le scan, identifier et prioriser :
- Critique : secrets hardcodés, tables sans RLS, 0 tests
- Warning : dette TS (
any), console.log en prod, migrations non appliquées
- Nice to have : structure hexagonale absente, README vide
Output Final
Projet analysé : [nom]
Stack : [framework] + [DB] + [auth]
Architecture : [pattern] — [conforme/non-conforme hexagonale]
Fichiers : X source, Y tests (ratio Z%)
Multi-tenant : oui/non (organizationId détecté : oui/non)
Secrets scan : OK / ⚠️ [X patterns suspects]
Santé : X/10
- TS errors : X
- console.log : X
- any : X
- Tests : X%
Priorité 1 : [action critique]
Priorité 2 : [action importante]
Prêt à travailler. → /feature ou /fix pour commencer.
Critères Santé 10/10 : 0 erreur TS, 0 console.log, <5% any, >60% coverage, RLS sur toutes les tables, 0 secret hardcodé.