Un dépôt existant

Kodrudder (README.md, package.json v0.8.0) est un studio « Ready-to-Dev » : à partir d'une idée ou d'un dépôt GitHub existant, une équipe de 66 agents IA produit 10 dossiers de cadrage, relus et approuvés par l'utilisateur. Le dossier est exporté en bundle ZIP (src/bundle.mjs) pour Claude Code ou Codex ; Cursor n'est pas accepté (src/domain.mjs).

Trois premières actions

1. Résoudre le ZIP manquant (S-01) : versionner le fichier ou scripter sa génération, puis lancer npm test pour obtenir un état de référence.
2. Ajouter une CI exécutant npm test sous Node 24 (S-08).
3. Découper missions.mjs et nacrel-studio.js (S-02), en s'appuyant sur les tests existants. Ne pas renommer les NACREL_* (S-10).

Limites de cette analyse

• Elle repose sur un condensé tronqué : server.mjs, missions.mjs, nacrel-studio.js et bundle.mjs ne sont vus que partiellement.
• Rien n'a été exécuté : aucun test lancé, aucun démarrage.
• Authentification des routes, CSRF et contrat de /api/v1/* ne sont pas jugeables H.

Le produit

• Kodrudder (README.md, usine-agentique/cockpit/package.json : nom kodrudder, v0.8.0) est un « studio Ready-to-Dev » : l'utilisateur part d'une idée ou d'un projet existant (dépôt GitHub) et obtient un dossier de cadrage structuré, produit avec une équipe d'agents IA.
• Le cadrage couvre 10 dossiers documentaires (src/framing.mjs : besoins, analyse, périmètre, marché, UX, fonctionnel, trajectoire, technique, exploitation, gouvernance) et un maillage de 24 sujets / 66 agents (equipe-agentique/library/maillage/map.json).
• Une fois approuvé, le dossier est exporté en bundle ZIP (src/bundle.mjs) pour Claude Code ou Codex ; le développement continue ensuite en local, le studio importe l'état publié (src/domain.mjs → importSnapshot).

Modules

Stack et outillage réels

Points d'attention :

• Le README exige ../../equipe-agentique-0.5.0-complete.zip (référencé par tests/domain.test.mjs et bundle.mjs), absent de l'arborescence fournie : à vérifier (H : généré ou omis du dépôt ; les tests de bundle en dépendent).
• Le nom public est Kodrudder, mais variables NACREL_*, cookies et formats historiques sont conservés volontairement (cockpit/README.md) : ne pas renommer.

Points d'entrée et commandes

Flux principal de bout en bout

1. Création : l'UI (public/nacrel-app.js, nacrel-model.js → creationInput) envoie POST /api/workspace/create ; server.mjs appelle src/onboarding.mjs → createProject, qui initialise le cadrage (framing.mjs → initializeFraming) à partir de maillage/map.json et stocke le projet (workspace.mjs → sqlite-store.mjs).
2. Contexte (reprise) : pour un dépôt existant, github-context.mjs (scanContext/applyContext) lit un échantillon borné via github.mjs ; l'objectif de reprise (reprise.mjs) restreint le parcours.
3. Mission IA : l'action start (/api/workspace/action → workbench.mjs → missions.mjs) construit le contexte (knowledge.mjs, context-pack.mjs), choisit le modèle (routing.mjs, connections.mjs), appelle le fournisseur (llm.mjs, provider-runtime.mjs, provider-stream.mjs), et peut déclencher une recherche web (web-research.mjs → web-reader.mjs → web-evidence.mjs).
4. Revue et propositions : les résultats sont validés (llm.mjs → validateResult) ; un reviewer distinct vérifie ; les propositions (besoins, tâches, documents) attendent l'acceptation de l'utilisateur (workbench.mjs, knowledge.mjs → newItem).
5. Rédaction et approbation : dossiers et maillage sont édités/approuvés (framing.mjs → saveDocument, approveMesh, approveFraming) ; la qualité est contrôlée (quality.mjs, objectiveQuality).
6. Export : GET /api/bundle → bundle.mjs → makeBundle (exige assertReady) assemble BRIEF, dossiers, 07-memoire/*, nacrel/project-package.json (project-package.mjs), rapport (delivery-report.mjs) et le kit EA ; optionnellement publié sur une branche GitHub dédiée (github-publish.mjs).
7. Transmission et suivi : /api/workspace/handoff (domain.mjs → handoff, bundle exporté et à jour requis) passe le projet en phase local (consultation seule) ; /api/workspace/snapshot importe ETAT-PUBLIE.json depuis GitHub (github.mjs → snapshot, importSnapshot).

Limite : seul un condensé tronqué de server.mjs, missions.mjs et nacrel-studio.js a été vu ; les détails de routage interne sont H.

Reconstitution à partir d'un condensé tronqué (server.mjs, missions.mjs, nacrel-studio.js et framing.mjs vus partiellement). Tout ce qui n'est pas vu est marqué H.

Utilisateurs et besoins couverts

Règles métier réellement codées

Modèle de données observé

API et routes observées

Les méthodes HTTP et les sous-chemins ne sont pas visibles (condensé tronqué) : colonne Méthode en H.

Annoncé mais non visible (ou non vérifiable)

Revue sur condensé tronqué : server.mjs, missions.mjs, nacrel-studio.js, nacrel-app.js, workbench.mjs et bundle.mjs ne sont vus que partiellement. Aucune exécution de test n'a été faite : un test « défini » n'est pas un test « réussi ».

Constats

À conserver tel quel

Non jugeable avec le condensé

# AGENTS.md — Kodrudder (Studio Ready-to-Dev)

## But
Studio local qui transforme une idée ou un dépôt GitHub existant en dossier de cadrage (10 dossiers, maillage de 24 sujets / 66 agents), exporté en bundle ZIP pour Claude Code ou Codex (`usine-agentique/cockpit/README.md`, `src/bundle.mjs`).

## Commandes (depuis `usine-agentique/cockpit/`)
| Action | Commande |
|---|---|
| Installer | Rien : aucune dépendance npm. Node.js >= 24 requis (`package.json`) |
| Lancer | `npm start` puis http://127.0.0.1:4317/app (port via `PORT`) |
| Lancer (Windows) | `Ouvrir-Kodrudder.cmd` ou `node ouvrir-nacrel.mjs` |
| Mode comptes | `node start-saas.mjs --open-signup [--port=4335]` (sans l'option, inscriptions fermées) |
| Tester | `npm test` (= `node --test --test-isolation=none tests/*.test.mjs`) |
| Sauvegarder | `node scripts/backup-storage.mjs SOURCE DEST --server-stopped` (serveur arrêté) |

## Carte des dossiers
| Chemin | Contenu |
|---|---|
| `usine-agentique/cockpit/server.mjs` | Serveur `node:http` unique : API `/api/*`, statique, auth |
| `usine-agentique/cockpit/src/` | Logique métier (cadrage, missions, IA, GitHub, stockage, bundle) |
| `usine-agentique/cockpit/public/` | Frontend ES modules vanilla, sans build |
| `usine-agentique/cockpit/tests/` | Tests `node:test` ; `fixtures.mjs` lit `maillage/map.json` |
| `usine-agentique/cockpit/scripts/` | Sauvegarde du stockage |
| `equipe-agentique/library/` | 66 profils (`agents.json`), `catalogue.json`, `maillage/`, `policy.md`, `skills/ea-*/` |

## Conventions observées
- JavaScript ESM, extensions `.mjs` côté serveur, style compact, messages d'erreur en français.
- Stockage SQLite par défaut (`NACREL_STORAGE=sqlite`), données dans `.private/` ou `.private-saas/` (ou `NACREL_DATA_DIR`).
- Écritures via transactions et contrôle de révision (`src/workspace.mjs`, `src/sqlite-store.mjs`).
- Un test par module dans `tests/*.test.mjs`, données de test sous `.qa/`.

## Règles à ne pas enfreindre
- **Ne pas renommer** `NACREL_*`, cookies, clés du navigateur, formats d'export, dossiers de données : compatibilité (`cockpit/README.md`).
- **Aucune dépendance npm** : tout repose sur Node natif (`package.json`).
- `public/*` importe `src/framing.mjs` et `src/reprise.mjs` : ces deux fichiers ne doivent jamais importer `node:*` (`public/nacrel-model.js`, `public/nacrel-app.js`).
- Ne jamais publier ni committer `.private/`, `.private-saas/`, clés IA ou GitHub (`cockpit/README.md`) ; secrets via environnement ou interface.
- Toute modification de brief/document passe par `invalidate` (`src/framing.mjs`) : elle invalide les approbations et l'export.
- Projet en phase `local` : consultation seule (`src/domain.mjs`).
- Reviewer distinct du producteur dans le maillage (`validateMesh`, `src/framing.mjs`).
- Recherche web : HTTPS public uniquement ; ne pas affaiblir l'anti-SSRF de `src/web-reader.mjs`.
- Export du bundle uniquement après `assertReady` (`src/bundle.mjs`) ; ne pas prétendre que le démarrage de Claude Code/Codex est testé (`src/delivery-report.mjs` : `not_executed`).
- Ne rien écrire hors `.qa/` pendant les tests.

## Pièges connus
- `equipe-agentique-0.5.0-complete.zip` (racine du dépôt) est requis par `src/bundle.mjs`, `tests/domain.test.mjs`, `cockpit/README.md` mais absent de l'arborescence : les tests de bundle échouent probablement sans lui (H : exclu par `.gitignore`, non lu).
- Garder l'organisation du dépôt : le serveur lit `../../equipe-agentique/library/` (`server.mjs`).
- `src/missions.mjs` (44 Ko), `public/nacrel-studio.js` (99 Ko), `public/nacrel-app.js` (53 Ko) sont monolithiques : modifier par petites zones, tests ciblés.
- `agents.json` (409 Ko) et `catalogue.json` (500 Ko) : ne jamais les charger entiers ; lire par extraits.
- `src/accounts.mjs` et `src/connections.mjs` (mode json) écrivent avec `rename` direct ; `src/atomic-replace.mjs` gère les verrous Windows (`EPERM`).
- Sauvegarde à chaud non prévue par le script : arrêter le serveur.
- Mode comptes local : pas un déploiement public (`cockpit/README.md`).