@roomi-fields/grillhouse 0.0.0-stage → 0.23.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "grillhouse",
+  "description": "Roomi's Grillhouse : le tableau du projet sur trois niveaux — le projet, les agents, le chantier en cours",
+  "types": "./types/index.d.ts",
+  "author": {
+    "name": "Romain Peyrichou"
+  },
+  "version": "0.23.0"
+}

package/METACADRE.md

@@ -0,0 +1,41 @@
+# Le métacadre de Grillhouse
+
+Le métacadre dit ce que sert tout le cadre, et comment ses règles s'écrivent. La charte, les
+compétences et les documents de chaque projet s'y rattachent ; une règle qui ne sert aucune de ses
+intentions sort du cadre.
+
+## 1. Les intentions
+
+1. **Un produit mature et professionnel** : le projet construit une architecture robuste et
+   pérenne, qui atteint ses objectifs et tient les exigences de son domaine (la rapidité pour le
+   live coding). Il se base sur l'existant et sur ce que fait le produit mature du domaine. Les
+   cinq autres intentions servent celle-ci.
+2. **L'architecture décide, le code suit** : chaque décision s'écrit dans l'architecture avant
+   d'être codée. Un problème remonté commence par une revue de l'architecture spécifiée : où il
+   devrait se situer ; ensuite on implémente. Ainsi le produit reste cohérent dans le temps.
+3. **Du plus large vers le plus spécifique** : tout correctif passe par l'architecture. Un problème
+   identifié peut être la manifestation d'un problème plus large : on le traite toujours du plus
+   large vers le plus spécifique.
+4. **La preuve avant l'affirmation** : un résultat s'affirme sur une mesure, et un test prouve
+   qu'il sait échouer avant de compter comme vert. Ainsi ce qui est déclaré fini l'est vraiment.
+5. **Des agents cadrés** : chaque ticket part à un agent neuf, dans le cadre écrit, et un autre que
+   lui relit sa fermeture. Ainsi le travail des agents reste dans l'architecture ; sans cadre, ils
+   font systématiquement le contraire.
+6. **Le responsable tranche l'essentiel** : ce qu'une règle écrite tranche, le régulateur ou
+   le superviseur le tranche. Le responsable reçoit les décisions qu'aucune règle ne couvre, avec leur contexte et une
+   recommandation. Ainsi son temps va aux vraies décisions.
+
+## 2. Écrire une règle
+
+**Écrire une règle** : une règle part des mots de celui qui l'a décidée. Elle dit en positif ce
+qu'on fait, au présent, en deux ou trois phrases courtes. Elle nomme l'intention du cadre qu'elle
+sert, pour qu'on ne puisse pas l'appliquer contre elle. Elle nomme les objets qu'elle cadre, à leur
+échelle ; un exemple l'éclaire, jamais une liste de cas.
+
+**Une règle, une idée** : une règle dit une seule chose, qu'un lecteur comprend sans connaître son
+origine. Deux idées font deux règles ; une idée déjà écrite ailleurs se cite à son adresse. Ainsi
+un agent applique chaque règle sans la mal lire.
+
+Exemple : « Avant le code, tu nommes dans le ticket la règle du cadre et la règle d'architecture
+que tu appliques. Ainsi le code suit l'architecture ; quand aucune règle ne s'applique, la décision
+manque et remonte au superviseur. »

package/agents/developpeur.md

@@ -0,0 +1,10 @@
+---
+name: developpeur
+model: sonnet
+effort: medium
+description: Travaille le code d'un ticket dont les tests existent. N'écrit aucun test, ni la matière de test partagée, ni de code avant la section Architecture du ticket.
+skills:
+  - grillhouse:developpeur
+---
+
+Tu es le développeur. Au premier tour, charge ta compétence `developpeur` (outil Skill), puis suis-la : ta séance ne la reçoit pas chargée.

package/agents/explorateur.md

@@ -0,0 +1,9 @@
+---
+name: explorateur
+description: "Mène un ticket d'exploration : relève l'état réel, liste les décisions à prendre, propose les tickets de réalisation. N'écrit aucun fichier."
+skills:
+  - grillhouse:explorateur
+disallowedTools: Write, Edit, MultiEdit, NotebookEdit
+---
+
+Tu es l'explorateur. Ta compétence `explorateur` est chargée : suis-la.

package/agents/questionneur.md

@@ -0,0 +1,11 @@
+---
+name: questionneur
+description: Questionne une proposition qu'il n'a pas écrite (le plan d'un ticket, une décision du régulateur, un plan du superviseur) là où elle lui paraît floue, à la lumière du cadre ; ne décide rien, ne propose pas sa solution, n'écrit aucun fichier ni rien au ticket.
+skills:
+  - grillhouse:questionneur
+model: sonnet
+effort: medium
+disallowedTools: Write, Edit, MultiEdit, NotebookEdit
+---
+
+Tu es le questionneur. Au premier tour, charge ta compétence `questionneur` (outil Skill), puis suis-la : ta séance ne la reçoit pas chargée.

package/agents/referent-technique.md

@@ -0,0 +1,9 @@
+---
+name: referent-technique
+description: Tranche une question de conception née d'un ticket, ou la fait monter au responsable ; dans le circuit, répond pour le plan d'un ticket aux questions du questionneur. N'écrit aucun fichier.
+skills:
+  - grillhouse:referent-technique
+disallowedTools: Write, Edit, MultiEdit, NotebookEdit
+---
+
+Tu es le référent technique. Au premier tour, charge ta compétence `referent-technique` (outil Skill) si elle n'est pas déjà chargée, puis suis-la : une séance que le circuit lance ne la reçoit pas chargée.

package/agents/regulateur.md

@@ -0,0 +1,11 @@
+---
+name: regulateur
+description: Tranche un arrêt du circuit d'un ticket — lit son état et sa raison, tranche ce que les règles tranchent, rend sa décision dans sa fiche (RELANCE, que le circuit applique, ou MONTE, la question au superviseur). Lancé neuf par le circuit sur chaque arrêt. N'écrit ni code ni test.
+skills:
+  - grillhouse:regulateur
+model: sonnet
+effort: medium
+disallowedTools: Write, Edit, MultiEdit, NotebookEdit
+---
+
+Tu es le régulateur. Au premier tour, charge ta compétence `regulateur` (outil Skill), puis suis-la : ta séance ne la reçoit pas chargée.

package/agents/relecteur.md

@@ -0,0 +1,9 @@
+---
+name: relecteur
+description: Relit en adversaire le lot d'un ticket (tests et code) et rend son verdict, que le circuit écrit au ticket. N'écrit rien dans le code.
+skills:
+  - grillhouse:relecteur
+disallowedTools: Write, Edit, MultiEdit, NotebookEdit
+---
+
+Tu es le relecteur. Au premier tour, charge ta compétence `relecteur` (outil Skill), puis suis-la : ta séance ne la reçoit pas chargée.

package/agents/testwriter.md

@@ -0,0 +1,10 @@
+---
+name: testwriter
+model: sonnet
+effort: medium
+description: Écrit les tests d'un ticket depuis la spécification, avant le code. N'écrit que des fichiers de test et la matière de test partagée.
+skills:
+  - grillhouse:testwriter
+---
+
+Tu es le testwriter. Au premier tour, charge ta compétence `testwriter` (outil Skill), puis suis-la : ta séance ne la reçoit pas chargée.

package/bin/grillhouse.mjs

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+// The frame's one command: `grillhouse <sous-commande> [arguments…]`, as `turbo run` or
+// `changeset version` are one executable with subcommands. A project calls `npx grillhouse
+// <sous-commande>` (`grillhouse <sous-commande>` in its npm scripts), never a path of the frame.
+//
+// - Each subcommand is a script of the package (`scripts/`), run with the arguments that follow
+//   it, in the working directory of the call, which is the project's. A `.mjs` runs in this
+//   process, as if Node had been given its path (`process.argv[1]` is the script's, the arguments
+//   after it): no second Node starts, which a hook of Claude Code called at each tool pays. A `.sh`
+//   runs by bash, its standard streams this process's, its exit code this command's, and a script
+//   ended by a signal gives 128 plus the signal's number, as a shell gives it.
+// - A subcommand is named after its script, without directory nor extension (`verifier`,
+//   `circuit`, `tableau`); `maj` runs `grillhouse-maj.mjs`, whose name already says the frame's;
+//   `hooks` (`crochets.mjs`, which places the git hooks) and `hook` (`crochet.mjs`, which runs one)
+//   take Husky's names, which a project's `prepare` and its git hooks call.
+// - A subcommand missing or unknown writes the usage and the list of the subcommands on the error
+//   stream, and the exit code is 2.
+// - A script finds its neighbours by its own directory, and the project by the working directory
+//   (`CLAUDE_PROJECT_DIR` for a hook of Claude Code): the package works wherever it is installed.
+import { spawn } from 'node:child_process';
+import { realpathSync } from 'node:fs';
+import { constants } from 'node:os';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const SCRIPTS = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'scripts');
+
+// Each subcommand and its script, under `scripts/`.
+export const SOUS_COMMANDES = {
+  bilan: 'bilan.mjs',
+  circuit: 'circuit.mjs',
+  'code-mort': 'code-mort.mjs',
+  commande: 'verrous/commande.mjs',
+  'composants-affectes': 'composants-affectes.mjs',
+  consommateurs: 'consommateurs.mjs',
+  'consommateurs-arbitres': 'consommateurs-arbitres.mjs',
+  droits: 'droits.mjs',
+  enveloppe: 'enveloppe/enveloppe.mjs',
+  'etat-du-circuit': 'etat-du-circuit.mjs',
+  file: 'integration/file.mjs',
+  frontieres: 'frontieres.mjs',
+  'gardes-du-cadre': 'gardes-du-cadre.mjs',
+  greffons: 'greffons.mjs',
+  hook: 'crochet.mjs',
+  hooks: 'crochets.mjs',
+  'index-interfaces': 'index-interfaces.mjs',
+  init: 'init.mjs',
+  integrer: 'integration/integrer.mjs',
+  'interfaces-contre-code': 'interfaces-contre-code.mjs',
+  lancer: 'enveloppe/lancer.sh',
+  'ligne-etat': 'ligne-etat/ligne-etat.mjs',
+  maj: 'grillhouse-maj.mjs',
+  nuit: 'nuit.sh',
+  pression: 'vitest-config/pression.mjs',
+  registre: 'registre.mjs',
+  resultats: 'resultats.mjs',
+  resumes: 'resumes.mjs',
+  'retirer-copie': 'retirer-copie.sh',
+  'session-start': 'session-start.sh',
+  sortie: 'sortie.mjs',
+  'sous-modules': 'sous-modules.sh',
+  'structure-guard': 'structure-guard.sh',
+  superviseur: 'superviseur.mjs',
+  tableau: 'tableau.mjs',
+  tests: 'tests.mjs',
+  ticket: 'ticket.sh',
+  'ticket-du-sous-agent': 'verrous/ticket-du-sous-agent.mjs',
+  'turbo-des-paquets': 'turbo-des-paquets.mjs',
+  verifier: 'verifier.mjs',
+  verrou: 'verrous/verrou.mjs',
+};
+
+// The absolute path of the script of the subcommand <nom>; null for a name the table lacks.
+export function scriptDe(nom) {
+  return Object.hasOwn(SOUS_COMMANDES, nom) ? path.join(SCRIPTS, SOUS_COMMANDES[nom]) : null;
+}
+
+// The usage and the list of the subcommands, as the error stream receives them.
+const usage = () =>
+  'Usage : grillhouse <sous-commande> [arguments…]\n' +
+  `Sous-commandes : ${Object.keys(SOUS_COMMANDES).join(', ')}\n`;
+
+// The command is run by its link (`node_modules/.bin/grillhouse`), which Node resolves for the
+// module, not for `process.argv[1]`.
+const lance = () => {
+  try {
+    return pathToFileURL(realpathSync(process.argv[1] ?? '')).href;
+  } catch {
+    return null;
+  }
+};
+
+// The script of the subcommand, run (see the header); the exit code is set, never forced
+// (`process.exitCode`), so that what the command wrote on a pipe reaches its reader.
+async function lancer([nom, ...args]) {
+  const script = nom === undefined ? null : scriptDe(nom);
+  if (script === null) {
+    process.stderr.write(
+      nom === undefined ? usage() : `⛔ sous-commande inconnue : ${nom}\n${usage()}`
+    );
+    process.exitCode = 2;
+    return;
+  }
+  if (script.endsWith('.mjs')) {
+    process.argv = [process.argv[0], script, ...args];
+    await import(pathToFileURL(script).href);
+    return;
+  }
+  const enfant = spawn('bash', [script, ...args], { stdio: 'inherit' });
+  // A signal this process receives goes to the script, which decides how it ends.
+  const relais = s => enfant.kill(s);
+  for (const s of ['SIGINT', 'SIGTERM', 'SIGHUP']) process.on(s, relais);
+  enfant.on('error', e => {
+    process.stderr.write(`⛔ grillhouse ${nom} : ${e.message}\n`);
+    process.exitCode = 1;
+  });
+  enfant.on('exit', (code, signal) => {
+    process.exitCode = code ?? 128 + (constants.signals[signal] ?? 0);
+    for (const s of ['SIGINT', 'SIGTERM', 'SIGHUP']) process.off(s, relais);
+  });
+}
+
+if (import.meta.url === lance()) {
+  await lancer(process.argv.slice(2));
+}

package/cadre/templates/projet/.claude/settings.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://raw.githubusercontent.com/anthropics/claude-code/main/schemas/settings.schema.json",
+  "permissions": {
+    "allow": [
+      "Bash(npm run *)",
+      "Bash(npm test*)",
+      "Bash(npm install*)",
+      "Bash(git *)",
+      "Bash(gh *)",
+      "Bash(bd *)",
+      "mcp__codegraph__*",
+      "mcp__plugin_rtfm_rtfm__*"
+    ],
+    "deny": []
+  },
+  "enabledPlugins": {
+    "mattpocock-skills@claude-plugins-official": true,
+    "rtfm@roomi-fields": true,
+    "grillhouse@roomi-fields": true
+  },
+  "extraKnownMarketplaces": {
+    "roomi-fields": {
+      "source": {
+        "source": "github",
+        "repo": "roomi-fields/claude-plugins"
+      }
+    }
+  },
+  "enabledMcpjsonServers": ["codegraph"]
+}

package/cadre/templates/projet/.editorconfig

@@ -0,0 +1,47 @@
+# EditorConfig helps maintain consistent coding styles across different editors
+# https://editorconfig.org
+
+root = true
+
+# Default settings for all files
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# TypeScript/JavaScript files
+[*.{ts,tsx,js,jsx,mjs,cjs}]
+indent_size = 2
+
+# JSON files
+[*.json]
+indent_size = 2
+
+# YAML files
+[*.{yml,yaml}]
+indent_size = 2
+
+# Markdown files
+[*.md]
+trim_trailing_whitespace = false
+max_line_length = off
+
+# Shell scripts
+[*.{sh,bash}]
+indent_size = 2
+
+# PowerShell scripts
+[*.{ps1,psm1,psd1}]
+indent_size = 4
+end_of_line = crlf
+
+# Makefiles
+[Makefile]
+indent_style = tab
+
+# Git configuration
+[.git*]
+indent_size = 4

package/cadre/templates/projet/.env.example

@@ -0,0 +1,57 @@
+# =============================================================================
+# Environment Configuration Template
+# =============================================================================
+# Copy this file to .env and fill in your values
+# NEVER commit .env to version control
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Application Settings
+# -----------------------------------------------------------------------------
+
+# Environment mode (development, production, test)
+NODE_ENV=development
+
+# Server port
+PORT=3000
+
+# Log level (debug, info, warn, error)
+LOG_LEVEL=info
+
+# -----------------------------------------------------------------------------
+# API Keys & Secrets
+# -----------------------------------------------------------------------------
+
+# Example API key (replace with your actual keys)
+# API_KEY=your_api_key_here
+
+# Example secret (use strong random values in production)
+# SECRET_KEY=your_secret_key_here
+
+# -----------------------------------------------------------------------------
+# Database Configuration
+# -----------------------------------------------------------------------------
+
+# Database URL
+# DATABASE_URL=postgresql://user:password@localhost:5432/dbname
+
+# Redis URL
+# REDIS_URL=redis://localhost:6379
+
+# -----------------------------------------------------------------------------
+# External Services
+# -----------------------------------------------------------------------------
+
+# Example third-party service configuration
+# SERVICE_API_URL=https://api.example.com
+# SERVICE_API_KEY=your_service_key
+
+# -----------------------------------------------------------------------------
+# Feature Flags
+# -----------------------------------------------------------------------------
+
+# Enable debug mode
+# DEBUG=false
+
+# Enable feature X
+# FEATURE_X_ENABLED=false

package/cadre/templates/projet/.eslintrc.cjs

@@ -0,0 +1,56 @@
+// Shared rules hold for TypeScript and JavaScript alike; the TypeScript
+// parser and its type-aware rules apply to .ts files only.
+const sharedRules = {
+  'no-console': ['warn', { allow: ['warn', 'error'] }],
+  'prefer-const': 'error',
+  'no-var': 'error',
+  eqeqeq: ['error', 'always'],
+  curly: ['error', 'all'],
+};
+
+module.exports = {
+  root: true,
+  env: {
+    node: true,
+    es2022: true,
+  },
+  parserOptions: {
+    ecmaVersion: 2022,
+    sourceType: 'module',
+  },
+  extends: ['eslint:recommended'],
+  rules: {
+    ...sharedRules,
+    'no-unused-vars': ['error', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }],
+  },
+  overrides: [
+    {
+      files: ['*.ts', '*.tsx'],
+      parser: '@typescript-eslint/parser',
+      parserOptions: {
+        project: './tsconfig.eslint.json',
+      },
+      plugins: ['@typescript-eslint'],
+      extends: [
+        'eslint:recommended',
+        'plugin:@typescript-eslint/recommended',
+        'plugin:@typescript-eslint/recommended-requiring-type-checking',
+      ],
+      rules: {
+        ...sharedRules,
+        'no-unused-vars': 'off',
+        '@typescript-eslint/explicit-function-return-type': 'off',
+        '@typescript-eslint/explicit-module-boundary-types': 'off',
+        '@typescript-eslint/no-explicit-any': 'warn',
+        '@typescript-eslint/no-unused-vars': [
+          'error',
+          { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
+        ],
+        '@typescript-eslint/no-floating-promises': 'error',
+        '@typescript-eslint/await-thenable': 'error',
+        '@typescript-eslint/no-misused-promises': 'error',
+      },
+    },
+  ],
+  ignorePatterns: ['dist/', 'node_modules/', 'coverage/', '*.cjs'],
+};

package/cadre/templates/projet/.github/workflows/ci.yml

@@ -0,0 +1,66 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [22.x, 24.x]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v5
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Check formatting
+        run: npm run format:check
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Build
+        run: npm run build --if-present
+
+      - name: Guards and tests
+        run: npm run verifier
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build --if-present
+
+      - name: Check package
+        run: npm pack --dry-run

package/cadre/templates/projet/.mcp.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "codegraph": {
+      "type": "stdio",
+      "command": "codegraph",
+      "args": [
+        "serve",
+        "--mcp"
+      ],
+      "env": {}
+    }
+  }
+}

package/cadre/templates/projet/.prettierrc

@@ -0,0 +1,11 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "useTabs": false,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "bracketSpacing": true,
+  "arrowParens": "avoid",
+  "endOfLine": "lf"
+}

package/cadre/templates/projet/CHANGELOG.md

@@ -0,0 +1,61 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- (Add new features here)
+
+### Changed
+- (Add changes to existing functionality here)
+
+### Deprecated
+- (Add soon-to-be removed features here)
+
+### Removed
+- (Add removed features here)
+
+### Fixed
+- (Add bug fixes here)
+
+### Security
+- (Add security fixes here)
+
+## [1.0.0] - YYYY-MM-DD
+
+### Added
+- Initial release
+- Core functionality
+- Documentation
+- CI/CD pipeline
+
+---
+
+## Versioning Guide
+
+### Version Format: MAJOR.MINOR.PATCH
+
+- **MAJOR**: Incompatible API changes
+- **MINOR**: New functionality (backward compatible)
+- **PATCH**: Bug fixes (backward compatible)
+
+### Commit Message Prefixes
+
+| Prefix | Description | Version Impact |
+|--------|-------------|----------------|
+| `feat:` | New feature | MINOR |
+| `fix:` | Bug fix | PATCH |
+| `docs:` | Documentation | PATCH |
+| `style:` | Code style | PATCH |
+| `refactor:` | Code refactoring | PATCH |
+| `perf:` | Performance | PATCH |
+| `test:` | Tests | PATCH |
+| `chore:` | Maintenance | PATCH |
+| `BREAKING CHANGE:` | Breaking change | MAJOR |
+
+[Unreleased]: https://github.com/your-username/project-name/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/your-username/project-name/releases/tag/v1.0.0

package/cadre/templates/projet/CLAUDE.md

@@ -0,0 +1,46 @@
+# <Nom du projet>
+
+<Ce qu'est le projet et ce qu'il fait, en deux ou trois phrases.>
+
+**Responsable** : <nom>. Il valide <la spécification, les ARCHITECTURE.md, les CADRE.md, les
+INTERFACE.md> ; le superviseur valide les autres documents. Ainsi le responsable tranche
+l'essentiel.
+
+Les règles du cadre : @node_modules/@roomi-fields/grillhouse/charte.md
+
+## Ce qui décide
+
+Le métacadre (`node_modules/@roomi-fields/grillhouse/METACADRE.md` : les intentions du cadre et
+l'écriture des règles), puis
+<la spécification ou la cible>, puis le cadre de chaque composant (`docs/CADRE.md`,
+`docs/INTERFACE.md`, `docs/ARCHITECTURE.md`), puis le code. Ainsi l'architecture décide, et le
+code suit.
+
+## Comment on arbitre
+
+Dans cet ordre ; le projet ajoute ses propres forces à la liste, à leur rang (« le temps
+d'abord », « une personne maintient le projet »…).
+
+1. **Que fait la référence mature ?** <Les références du domaine : un compilateur mature, une
+   station audionumérique professionnelle…> Ce qu'elles font est la réponse par défaut ; un écart
+   porte sa raison écrite.
+2. **Qu'est-ce qui existe déjà ?** Un standard, un outil sur étagère, une bibliothèque éprouvée,
+   une convention des projets voisins se reprend tel quel.
+3. **Le domaine l'exige-t-il ?** <Les exigences du domaine : la rapidité pour le live coding…> Un
+   choix qui les dégrade se mesure et se dit.
+
+## Ce qui monte au superviseur
+
+Le fonctionnel que le régulateur ne tranche jamais seul : <le langage, le moteur audio, une
+interface publiée…>. Le cadre et l'architecture montent toujours (charte commune).
+
+## Commandes
+
+- `npm test` (Turborepo : construction, puis tests ; une tâche dont rien n'a bougé est relue de son cache, `npm run test:forcer` rejoue) · `npm test -- <chemins>` (un lancement ciblé : chaque chemin écrit depuis la racine, joué dans son paquet, avec les constructions dont ses tests dépendent, relues du cache ; ses tests rejouent dès que bouge ce qu'ils importent ; un lancement qui ne joue aucun test échoue ; un banc de temps ou un test de nuit se joue quand son propre fichier est nommé, au repos) · `npm run verifier` (après la construction, les gardes du cadre, celles du projet — son script `gardes` — et les tests, côte à côte, puis les témoins de temps seuls, sous le verrou de la machine : ce que jouent l'intégration, la file, la CI et la nuit ; mesuré contre le dernier vert, un paquet rejoué joue les tests que Vitest relie aux fichiers changés depuis, tous quand un changement sort de son graphe ; 0 vert, 1 rouge, 75 « à repasser ») · `npm run verifier -- --tout` (la passe complète, chaque test joué pour de vrai : ce que joue la nuit) · `npm run verifier -- --gardes` (les gardes seules, même verdict : ce que joue le relecteur) · `npm run typecheck` · `npm run lint` · `npm run format:check`.
+- Préfixe des tickets : `<prefixe>-`.
+- La politique de poussée : la clé `grillhouse.poussee` du `package.json` (`commit` : la branche où
+  part chaque commit, main par défaut ; `nuit` : la branche où la nuit pousse son commit vert ;
+  seule la nuit la pousse, le crochet pre-push refuse toute autre poussée vers elle).
+- Les sous-modules partagés : la clé `grillhouse.partage` du `package.json` (les chemins des
+  sous-modules qu'aucun ticket n'écrit ; chaque copie les lit dans le dépôt principal, en lecture
+  seule, au lieu d'en recevoir un exemplaire).