fix(leadtech): résoudre les chemins Lead_tech selon la machine

- aliases.sh : détection par uname au lieu de tester l'existence du dossier
- _AI_INSTRUCTIONS.md : placeholder {{LEADTECH}} pour tous les chemins
- sync-ai-instructions.sh : substitution {{LEADTECH}} → REPO_ROOT à la génération
- .gitignore : exclure CLAUDE.md et AGENTS.md (fichiers générés, machine-spécifiques)
This commit is contained in:
MaksTinyWorkshop
2026-03-27 21:01:40 +01:00
parent 788e7e7a40
commit 824c38505f
6 changed files with 85 additions and 123 deletions

View File

@@ -8,7 +8,7 @@ Langue de travail : **français**.
## Base de connaissance à consulter en priorité
La base de connaissance est organisée dans `knowledge/` par domaine.
La base de connaissance est organisée dans `{{LEADTECH}}/knowledge/` par domaine.
Consulte-la avant de proposer une solution dans le domaine concerné.
### Procédure daccès
@@ -22,25 +22,25 @@ Consulte-la avant de proposer une solution dans le domaine concerné.
| Dossier | Contenu |
| ------- | ------- |
| `knowledge/backend/patterns/` | Patterns backend validés (auth, contracts, prisma, stripe, nestjs, multi-tenant, nextjs, async) |
| `knowledge/backend/risques/` | Risques backend (auth, contracts, prisma, stripe, nestjs, redis, nextjs, general) |
| `knowledge/frontend/patterns/` | Patterns frontend/mobile validés (state, forms, navigation, design-tokens, nextjs, tests) |
| `knowledge/frontend/risques/` | Risques frontend (auth, state, navigation, design-tokens, nextjs, tests, performance, general) |
| `knowledge/ux/patterns/` | Patterns UX/UI validés |
| `knowledge/ux/risques/` | Risques et anti-patterns UX/UI |
| `knowledge/n8n/patterns/` | Patterns n8n validés |
| `knowledge/n8n/risques/` | Risques et anti-patterns n8n |
| `knowledge/product/patterns/` | Patterns produit / métier validés |
| `knowledge/product/risques/` | Risques et anti-patterns produit |
| `knowledge/workflow/risques/` | Risques workflow agent (story-tracking) |
| `{{LEADTECH}}/knowledge/backend/patterns/` | Patterns backend validés (auth, contracts, prisma, stripe, nestjs, multi-tenant, nextjs, async) |
| `{{LEADTECH}}/knowledge/backend/risques/` | Risques backend (auth, contracts, prisma, stripe, nestjs, redis, nextjs, general) |
| `{{LEADTECH}}/knowledge/frontend/patterns/` | Patterns frontend/mobile validés (state, forms, navigation, design-tokens, nextjs, tests) |
| `{{LEADTECH}}/knowledge/frontend/risques/` | Risques frontend (auth, state, navigation, design-tokens, nextjs, tests, performance, general) |
| `{{LEADTECH}}/knowledge/ux/patterns/` | Patterns UX/UI validés |
| `{{LEADTECH}}/knowledge/ux/risques/` | Risques et anti-patterns UX/UI |
| `{{LEADTECH}}/knowledge/n8n/patterns/` | Patterns n8n validés |
| `{{LEADTECH}}/knowledge/n8n/risques/` | Risques et anti-patterns n8n |
| `{{LEADTECH}}/knowledge/product/patterns/` | Patterns produit / métier validés |
| `{{LEADTECH}}/knowledge/product/risques/` | Risques et anti-patterns produit |
| `{{LEADTECH}}/knowledge/workflow/risques/` | Risques workflow agent (story-tracking) |
### Fichiers globaux (hors knowledge/)
| Fichier | Contenu |
| ------- | ------- |
| `10_conventions_redaction.md` | Conventions de documentation technique |
| `40_decisions_et_archi.md` | Décisions techniques (mini-ADR) |
| `90_debug_et_postmortem.md` | Post-mortems et bugs capitalisés |
| `{{LEADTECH}}/10_conventions_redaction.md` | Conventions de documentation technique |
| `{{LEADTECH}}/40_decisions_et_archi.md` | Décisions techniques (mini-ADR) |
| `{{LEADTECH}}/90_debug_et_postmortem.md` | Post-mortems et bugs capitalisés |
## Capitalisation du savoir
@@ -65,19 +65,19 @@ Validation
Lead_tech
```
Les agents peuvent proposer librement des entrées dans `95_a_capitaliser.md`.
Les agents peuvent proposer librement des entrées dans `{{LEADTECH}}/95_a_capitaliser.md`.
Après validation, le contenu est déplacé vers le fichier approprié dans `knowledge/`.
Après validation, le contenu est déplacé vers le fichier approprié dans `{{LEADTECH}}/knowledge/`.
## Projets actifs
La liste des projets actifs est maintenue dans `_projects.conf`.
La liste des projets actifs est maintenue dans `{{LEADTECH}}/_projects.conf`.
## Patterns clés à appliquer systématiquement
- **Contracts-First / Zod-Infer / No-DTO** : voir `knowledge/backend/patterns/contracts.md`
- **Navigation réactive useEffect** : voir `knowledge/frontend/patterns/navigation.md`
- **Guard NestJS — ordre denregistrement** : voir `knowledge/backend/patterns/nestjs.md`
- **Contracts-First / Zod-Infer / No-DTO** : voir `{{LEADTECH}}/knowledge/backend/patterns/contracts.md`
- **Navigation réactive useEffect** : voir `{{LEADTECH}}/knowledge/frontend/patterns/navigation.md`
- **Guard NestJS — ordre denregistrement** : voir `{{LEADTECH}}/knowledge/backend/patterns/nestjs.md`
- **Format derreur API standardisé** : `{ error: { code, message, requestId } }`
- **Sessions avec TTL** : toujours un champ `expiresAt`, filtrer dans les queries
@@ -89,4 +89,4 @@ Convention de structure Docker sur le NUC (Proxmox) :
- `/srv/docker-data` — données persistantes (bind mounts explicites)
- `/srv/backups` — dumps et archives
Éviter SQL Server en LXC Proxmox → préférer PostgreSQL/MariaDB (voir `90_debug_et_postmortem.md`).
Éviter SQL Server en LXC Proxmox → préférer PostgreSQL/MariaDB (voir `{{LEADTECH}}/90_debug_et_postmortem.md`).