# Kill_LIFE 🚀 — Control Plane IA-native, cockpit opĂ©rateur et lot pilote extensions [![CI](https://img.shields.io/github/actions/workflow/status/electron-rare/Kill_LIFE/ci.yml?branch=main&label=CI)](https://github.com/electron-rare/Kill_LIFE/actions) [![Licence MIT](https://img.shields.io/badge/license-MIT-blue)](licenses/MIT.txt) [![Compliance](https://img.shields.io/badge/compliance-passed-brightgreen)](docs/COMPLIANCE.md)
BanniĂšre Kill_LIFE
--- Bienvenue dans **Kill_LIFE**, le control plane public du programme agentique `Kill_LIFE`. Le repo concentre aujourd'hui le cockpit opérateur, la chaßne spec-first, les contrats runtime/MCP, les preuves d'exécution, et le lot pilote qui alimente les extensions VS Code soeurs `kill-life-studio`, `kill-life-mesh` et `kill-life-operator`. La regle de lecture 2026-03-22 est simple: - ce `README.md` décrit le produit/programme et les décisions de consolidation - `docs/index.md` est la navigation opérateur canonique - `tools/cockpit/README.md` est l'entrée outillage/TUI canonique - `specs/README.md` reste la source de vérité de la chaßne spec-first - `docs/KILL_LIFE_CONSOLIDATION_AUDIT_2026-03-22.md` porte l'audit structure, les risques, la matrice IA et la carte de fonctionnalites La boucle courte de gouvernance locale est désormais: `lot_chain -> intelligence_tui(memory) -> runtime_ai_gateway(status)` Le programme d'integration intelligence actuellement actif se suit dans: - `docs/plans/22_plan_integration_intelligence_agentique.md` - `docs/plans/22_todo_integration_intelligence_agentique.md` - `docs/plans/23_plan_yiacad_git_eda_platform.md` - `docs/plans/23_todo_yiacad_git_eda_platform.md` - `specs/04_tasks.md`
Don't Panic Playlist apocalypse
## EntrĂ©es canoniques | Surface | RĂŽle | EntrĂ©e recommandĂ©e | | --- | --- | --- | | Produit / programme | Vue d'ensemble, pĂ©rimĂštre, stratĂ©gie | `README.md` | | Navigation opĂ©rateur | Index docs, runbooks, preuves, routines | `docs/index.md` | | Cockpit / TUI | Commandes shell, contrats `cockpit-v1`, santĂ© runtime | `bash tools/cockpit/yiacad_operator_index.sh --action status` | | Gouvernance intelligence | owners, mĂ©moire et prochaines actions | `bash tools/cockpit/intelligence_tui.sh --action status --json` | | Gateway runtime/MCP/IA | synthĂšse consolidĂ©e runtime, mesh et Mascarade | `bash tools/cockpit/runtime_ai_gateway.sh --action status --refresh --json` | | ChaĂźne spec-first | Intake -> spec -> arch -> plan -> tasks | `specs/README.md` | | Audit consolidĂ© | forces, faiblesses, opportunitĂ©s, risques, IA | `docs/KILL_LIFE_CONSOLIDATION_AUDIT_2026-03-22.md` | | Veille OSS | benchmark MCP, orchestration, VS Code agents | `docs/WEB_RESEARCH_OPEN_SOURCE_2026-03-22.md` | ## đŸ§© PrĂ©sentation Kill_LIFE n'est plus seulement un squelette embarquĂ©. Le repo sert dĂ©sormais de source de vĂ©ritĂ© publique pour un programme plus large: opĂ©rations locales, gouvernance tri-repo, runtime MCP/IA, lot YiACAD, et spĂ©cialisation progressive des extensions VS Code. Le positionnement retenu pour cette passe de consolidation est: - `Kill_LIFE` = control plane, cockpit, contrats, preuves et rĂ©fĂ©rentiel documentaire - `kill-life-studio` = produit, specs, dĂ©cisions, pĂ©rimĂštre, roadmap - `kill-life-mesh` = orchestration multi-repo, handoffs, ownership, dĂ©pendances - `kill-life-operator` = exĂ©cution, checks, evidence, runbooks > « Bienvenue dans le meilleur des mondes : ici, chaque commit est validĂ©, chaque gate est passĂ©, et chaque agent sait que la vraie libertĂ©, c'est d'avoir un evidence pack bien rangĂ©. » > — Aldous Huxley, version CI/CD --- ## đŸ§© Architecture & Principes - **Spec-first** : Chaque Ă©volution commence par une dĂ©finition claire dans `specs/` ([Spec Generator FX](https://www.youtube.com/watch?v=9bZkp7q19f0)). > _Schaeffer : Les agents du pipeline Ă©coutent le bruit des specs comme une symphonie de sons trouvĂ©s._ - **Injection de standards** : Standards versionnĂ©s et profils injectĂ©s (Agent OS). - **Catalogue agents 2026** : 12 agents top-level pilotĂ©s par contrat avec write sets, rituels, gates, prompts et handoffs dĂ©finis ([agents/](agents/), [specs/contracts/kill_life_agent_catalog.json](specs/contracts/kill_life_agent_catalog.json)). - **Tool-first** : Scripts reproductibles ([tools/](tools/)), evidence pack canonique dans `docs/evidence/` et expose en artifact CI. - **Pipeline hardware/firmware** : Bulk edits, exports, tests, conformitĂ©, snapshots. - **CAD headless** : KiCad 10 first + FreeCAD + OpenSCAD via MCP, conteneurisĂ©s. - **YiACAD** : lot IA-native de fusion KiCad + FreeCAD (with logs dĂ©diĂ©s et smoke canari). - **Pilotage tri-repo** : contract `ready|degraded|blocked` pilotĂ© par `mesh_sync_preflight.sh` + `refonte_tui.sh`. - **SĂ©curitĂ© & conformitĂ©** : Sanitisation, sorties sĂ»res, sandboxing, scope guard, anti-prompt injection ([OpenClaw Sandbox](https://www.openclaw.io/)). - **Runtime agentique** : `ZeroClaw` en local on-demand, `LangGraph` et `AutoGen` comme patterns d'intĂ©gration optionnels.
Schéma des agents BMAD
> « La rĂ©ponse Ă  la question ultime de la vie, de l'univers et du dĂ©veloppement embarquĂ© IA : 42 specs, 12 agents, et un pipeline qui ne panique jamais. » > — Le README qui ne panique jamais > 42 ([Les particules font-elles l'amour ?](https://lelectron-fou.bandcamp.com/album/les-particules-font-elles-l-amour-la-physique)) --- ## ✹ FonctionnalitĂ©s principales - **DĂ©veloppement guidĂ© par la spec** : User stories, contraintes, architecture, plans, backlog. - **Automatisation** : Issue → PR avec tests unitaires, sanitisation, evidence pack. - **Multi-cibles** : ESP32, STM32, Linux, tests natifs. - **Pipeline matĂ©riel** : KiCad, exports SVG/ERC/DRC/BOM/netlist, bulk edits. - **ConformitĂ©** : Profils injectĂ©s, validation automatique. - **OpenClaw** : Labels & commentaires sanitisĂ©s, jamais de commit/push, sandbox obligatoire. - **Workflow catalog** : Workflows JSON Ă©ditables par `crazy_life`, validĂ©s contre un schĂ©ma JSON.
Pipeline hardware/firmware
--- ## đŸ–„ïž SchĂ©ma agentique (Mermaid)
```mermaid flowchart TD Issue[Issue label ai:*] --> PR[Pull Request] PR --> Gate[Gate tests + conformitĂ©] Gate --> Evidence[Evidence Pack] Evidence --> CI[22 workflows CI/CD] CI --> Deploy[DĂ©ploiement multi-cible] PR --> Agents[12 agents canoniques] Agents --> Specs[specs/ — 21 specs] Agents --> Firmware[firmware/ PlatformIO] Agents --> Hardware[hardware/ KiCad] Agents --> Docs[docs/] Agents --> Compliance[compliance/] Agents --> Tools[tools/] Agents --> OpenClaw[openclaw/] Specs --> Standards[standards/] Firmware --> Tests[test/] Hardware --> MCP{7 serveurs MCP} MCP --> KiCad[KiCad MCP] MCP --> FreeCAD[FreeCAD MCP] MCP --> OpenSCAD[OpenSCAD MCP] MCP --> YiACAD[YiACAD lot] MCP --> HF[HuggingFace MCP] Compliance --> Evidence OpenClaw --> Sandbox[Sandbox] Agents -.-> ZeroClaw[ZeroClaw runtime] ZeroClaw -.-> LangGraph[LangGraph] ZeroClaw -.-> AutoGen[AutoGen] ZeroClaw -.-> N8N[n8n] ```
> _Parmegiani : Un bulk edit, c'est une mĂ©tamorphose Ă©lectronique, un peu comme un pack d'Ă©vidence qui se transforme en nuage de sons._ --- ## đŸ—ș Structure du projet
Arborescence du projet Kill_LIFE
```text Kill_LIFE/ ├── firmware/ # Code PlatformIO (ESP32/STM32) ├── hardware/ # Assets hardware et blocs KiCad ├── specs/ # 21 specs et tĂąches canoniques (00_intake → 04_tasks + MCP/ZeroClaw/CAD) ├── workflows/ # Workflows JSON canoniques + templates + schĂ©ma ├── agents/ # 12 agents top-level backĂ©s par le catalogue ├── bmad/ # Gates (S0, S1), rituels (kickoff), templates (handoff, status) ├── compliance/ # Profils rĂ©glementaires, standards catalog, evidence ├── standards/ # Standards globaux versionnĂ©s ├── openclaw/ # Labels, sandbox, onboarding ├── tools/ │ ├── compliance/ # Validation compliance │ ├── hw/ # Stack CAD, MCP, exports, smoke, schops │ ├── ai/ # ZeroClaw launchers, intĂ©grations (langgraph, autogen, n8n) │ ├── mistral/ # Safe patch et outils Mistral │ └── ci/ # Audit CI ├── web/ # Frontend Next.js YiACAD (dashboard, editor, viewer, review) ├── deploy/cad/ # Dockerfiles et compose CAD/runtime ├── docs/ # Docs opĂ©rateur, bridge, plans, workflows ├── test/ # Tests Python (stable + MCP) ├── .github/ │ ├── agents/ # 12 dĂ©finitions agents GitHub │ ├── prompts/ # Prompts start/plan backĂ©s par le catalogue + prompts partagĂ©s │ └── workflows/ # 22 workflows CI/CD ├── KIKIFOU/ # Diagnostic, diagramme, mapping, recommandations ├── mcp.json # 7 serveurs MCP configurĂ©s └── mkdocs.yml # Site docs ``` ## Gouvernance refonte / IA-native - Audit de consolidation: [docs/KILL_LIFE_CONSOLIDATION_AUDIT_2026-03-22.md](docs/KILL_LIFE_CONSOLIDATION_AUDIT_2026-03-22.md) - Spec intelligence: [specs/agentic_intelligence_integration_spec.md](specs/agentic_intelligence_integration_spec.md) - Feature map intelligence: [docs/AGENTIC_INTELLIGENCE_FEATURE_MAP_2026-03-21.md](docs/AGENTIC_INTELLIGENCE_FEATURE_MAP_2026-03-21.md) - Manifeste: [docs/REFACTOR_MANIFEST_2026-03-20.md](docs/REFACTOR_MANIFEST_2026-03-20.md) - Contrat mesh: [docs/TRI_REPO_MESH_CONTRACT_2026-03-20.md](docs/TRI_REPO_MESH_CONTRACT_2026-03-20.md) - Plans lot: [specs/04_tasks.md](specs/04_tasks.md) - Gestion des agents: [docs/plans/12_plan_gestion_des_agents.md](docs/plans/12_plan_gestion_des_agents.md) - To-do mesh: [docs/plans/19_todo_mesh_tri_repo.md](docs/plans/19_todo_mesh_tri_repo.md) - CAD AI-native: [docs/CAD_AI_NATIVE_FORK_STRATEGY.md](docs/CAD_AI_NATIVE_FORK_STRATEGY.md) - Git EDA platform: [docs/YIACAD_GIT_EDA_PLATFORM_2026-03-22.md](docs/YIACAD_GIT_EDA_PLATFORM_2026-03-22.md) - Web stack spec: [specs/yiacad_git_eda_platform_spec.md](specs/yiacad_git_eda_platform_spec.md) - YiACAD lane: `bash tools/cockpit/refonte_tui.sh --action yiacad-fusion:prepare` et `tools/cad/yiacad_fusion_lot.sh` - Workflow IA: [docs/AI_WORKFLOWS.md](docs/AI_WORKFLOWS.md) - TUI intelligence: `bash tools/cockpit/intelligence_tui.sh --action status` - Memoire intelligence: `bash tools/cockpit/intelligence_tui.sh --action memory --json` - Scorecard intelligence: `bash tools/cockpit/intelligence_tui.sh --action scorecard --json` - Comparaison inter-repos: `bash tools/cockpit/intelligence_tui.sh --action comparison --json` - File recommandations IA: `bash tools/cockpit/intelligence_tui.sh --action recommendations --json` - Gateway runtime/MCP/IA: `bash tools/cockpit/runtime_ai_gateway.sh --action status --refresh --json` - Sync locale: `bash tools/cockpit/lot_chain.sh status` rafraichit la memoire `intelligence_tui` avant de mettre a jour le suivi `lots` - Commande d'entrĂ©e: `bash tools/cockpit/refonte_tui.sh --action status` - Index operateur YiACAD: `bash tools/cockpit/yiacad_operator_index.sh --action status` - Phase active 2026-03-21: alignement lot 22, durcissement cockpit/logs, veille officielle MCP/agentique/IA, politique racine/mirror explicite et priorisation firmware/CAD/MCP. ### Refonte UI/UX Apple-native 2026 - Audit UX: [docs/YIACAD_APPLE_UI_UX_AUDIT_2026-03-20.md](docs/YIACAD_APPLE_UI_UX_AUDIT_2026-03-20.md) - Audit exhaustif refonte: [docs/YIACAD_EXHAUSTIVE_REFOUNTE_AUDIT_2026-03-20.md](docs/YIACAD_EXHAUSTIVE_REFOUNTE_AUDIT_2026-03-20.md) - SpĂ©cification technique: [specs/yiacad_uiux_apple_native_spec.md](specs/yiacad_uiux_apple_native_spec.md) - SpĂ©cification lot suivant `T-UX-004`: [specs/yiacad_tux004_orchestration_spec.md](specs/yiacad_tux004_orchestration_spec.md) - Feature map UI/UX: [docs/YIACAD_APPLE_UI_UX_FEATURE_MAP_2026-03-20.md](docs/YIACAD_APPLE_UI_UX_FEATURE_MAP_2026-03-20.md) - Feature map lot suivant: [docs/YIACAD_TUX004_FEATURE_MAP_2026-03-20.md](docs/YIACAD_TUX004_FEATURE_MAP_2026-03-20.md) - Veille Apple + OSS: [docs/YIACAD_APPLE_UI_UX_OSS_RESEARCH_2026-03-20.md](docs/YIACAD_APPLE_UI_UX_OSS_RESEARCH_2026-03-20.md) - Plan dĂ©diĂ©: [docs/plans/20_plan_refonte_ui_ux_yiacad_apple_native.md](docs/plans/20_plan_refonte_ui_ux_yiacad_apple_native.md) - To-do dĂ©diĂ©: [docs/plans/20_todo_refonte_ui_ux_yiacad_apple_native.md](docs/plans/20_todo_refonte_ui_ux_yiacad_apple_native.md) - TUI dĂ©diĂ©e: `bash tools/cockpit/yiacad_uiux_tui.sh --action status|program-audit|next-spec|next-feature-map` ### Bundle global YiACAD 2026 - Audit global: [docs/YIACAD_GLOBAL_REFACTOR_AUDIT_2026-03-20.md](docs/YIACAD_GLOBAL_REFACTOR_AUDIT_2026-03-20.md) - Evaluation IA: [docs/YIACAD_GLOBAL_AI_INTEGRATION_ASSESSMENT_2026-03-20.md](docs/YIACAD_GLOBAL_AI_INTEGRATION_ASSESSMENT_2026-03-20.md) - Feature map globale: [docs/YIACAD_GLOBAL_FEATURE_MAP_2026-03-20.md](docs/YIACAD_GLOBAL_FEATURE_MAP_2026-03-20.md) - Recherche OSS globale: [docs/YIACAD_GLOBAL_OSS_RESEARCH_2026-03-20.md](docs/YIACAD_GLOBAL_OSS_RESEARCH_2026-03-20.md) - Architecture backend: [docs/YIACAD_BACKEND_ARCHITECTURE_2026-03-20.md](docs/YIACAD_BACKEND_ARCHITECTURE_2026-03-20.md) - Spec globale: [specs/yiacad_global_refonte_spec.md](specs/yiacad_global_refonte_spec.md) - Spec backend: [specs/yiacad_backend_architecture_spec.md](specs/yiacad_backend_architecture_spec.md) - Plan global: [docs/plans/21_plan_refonte_globale_yiacad.md](docs/plans/21_plan_refonte_globale_yiacad.md) - TODO globale: [docs/plans/21_todo_refonte_globale_yiacad.md](docs/plans/21_todo_refonte_globale_yiacad.md) - TUI globale: `bash tools/cockpit/yiacad_refonte_tui.sh --action status` - Prochain front canonique: - architecture: backend YiACAD derriere `tools/cad/yiacad_native_ops.py` - produit: `T-UX-004` (`command palette`, `review center`, `inspector` persistant) ### ChaĂźne de specs Le workflow spec-first suit une sĂ©quence canonique dans `specs/` : ```text 00_intake.md → 01_spec.md → 02_arch.md → 03_plan.md → 04_tasks.md ``` Specs spĂ©cialisĂ©es : `kicad_mcp_scope_spec.md`, `knowledge_base_mcp_spec.md`, `github_mcp_conversion_spec.md`, `cad_modeling_tasks.md`, `zeroclaw_dual_hw_orchestration_spec.md`, `mcp_agentics_target_backlog.md`. Contraintes : [`specs/constraints.yaml`](specs/constraints.yaml) — source de vĂ©ritĂ© pour cibles, toolchain, sĂ©curitĂ© IA et compliance. ### Agents & prompts Le catalogue canonique 2026 est dĂ©fini dans [`specs/contracts/kill_life_agent_catalog.json`](specs/contracts/kill_life_agent_catalog.json) puis reflĂ©tĂ© dans [`agents/`](agents/) et [`.github/agents/`](.github/agents/). | Agent | RĂŽle | |---|---| | `PM-Mesh` | intake, planification, priorisation, gouvernance mesh | | `Arch-Mesh` | architecture, ADR, frontiĂšres de contrat | | `Docs-Research` | docs canoniques, navigation, recherche, narration catalogue | | `Runtime-Companion` | runtime IA, alignement MCP, provider bridges | | `QA-Compliance` | tests, schĂ©mas, gates release, evidence | | `Embedded-CAD` | KiCad, FreeCAD, lanes CAD/fabrication | | `Web-CAD-Platform` | Next.js, GraphQL, realtime, workers, review | | `UX-Lead` | UX YiACAD, shell natif, recherche design | | `Firmware` | implĂ©mentation et validation PlatformIO | | `SyncOps` | cockpit, logs, SSH, incidents, opĂ©rations mesh | | `Schema-Guard` | schĂ©mas de contrat et validation structurelle | | `KillLife-Bridge` | workflows et evidence bridge tri-repo | Chaque agent canonique possĂšde maintenant un `start_.prompt.md` et un `plan_wizard_.prompt.md`, tandis que [`.github/prompts/plan_wizard_agents_management.prompt.md`](.github/prompts/plan_wizard_agents_management.prompt.md) et [`.github/prompts/plan_wizard_agents_coordination.prompt.md`](.github/prompts/plan_wizard_agents_coordination.prompt.md) restent partagĂ©s pour l'orchestration et la checklist globale. ### BMAD (gates & rituels) Le framework BMAD dans [`bmad/`](bmad/) structure la progression : - **Gates** : `gate_s0.md` (prĂ©-spec), `gate_s1.md` (prĂ©-implĂ©mentation) - **Rituels** : `kickoff.md` - **Templates** : `handoff.md`, `status_update.md` Voir [KIKIFOU/diagramme.md](KIKIFOU/diagramme.md) pour le diagramme complet et [KIKIFOU/mapping.md](KIKIFOU/mapping.md) pour la table de mapping. Plan d'analyse repo courant: - [docs/plans/REPO_DEEP_ANALYSIS_2026-03-11.md](docs/plans/REPO_DEEP_ANALYSIS_2026-03-11.md) - [docs/REFACTOR_MANIFEST_2026-03-20.md](docs/REFACTOR_MANIFEST_2026-03-20.md) - [docs/WEB_RESEARCH_OPEN_SOURCE_2026-03-20.md](docs/WEB_RESEARCH_OPEN_SOURCE_2026-03-20.md) - [docs/KILL_LIFE_FEATURE_MAP_2026-03-11.md](docs/KILL_LIFE_FEATURE_MAP_2026-03-11.md) - [docs/KILL_LIFE_WORKFLOW_LOCAL_SEQUENCE_2026-03-11.md](docs/KILL_LIFE_WORKFLOW_LOCAL_SEQUENCE_2026-03-11.md) - [docs/KILL_LIFE_WORKFLOW_GITHUB_SEQUENCE_2026-03-11.md](docs/KILL_LIFE_WORKFLOW_GITHUB_SEQUENCE_2026-03-11.md) - [docs/EVIDENCE_ALIGNMENT_2026-03-11.md](docs/EVIDENCE_ALIGNMENT_2026-03-11.md) - [docs/AGENTIC_LANDSCAPE.md](docs/AGENTIC_LANDSCAPE.md) - [docs/AI_WORKFLOWS.md](docs/AI_WORKFLOWS.md) - [tools/cockpit/refonte_tui.sh](tools/cockpit/refonte_tui.sh) - [docs/CAD_AI_NATIVE_FORK_STRATEGY.md](docs/CAD_AI_NATIVE_FORK_STRATEGY.md) - [docs/TRI_REPO_MESH_CONTRACT_2026-03-20.md](docs/TRI_REPO_MESH_CONTRACT_2026-03-20.md) Infrastructure opĂ©rationnelle: - Machines SSH opĂ©rateur (port SSH: `22`, prioritĂ© opĂ©rationnelle: Tower -> KXKM -> CILS -> local -> root): | Machine | Utilisateur | RĂŽle | Port | Script principal | |---|---|---|---:|---| | `clems@192.168.0.120` | `clems` | Machine de pilotage / orchestration locale | `22` | `run_alignment_daily.sh`, `ssh_healthcheck.sh` | | `kxkm@kxkm-ai` | `kxkm` | Mac opĂ©rateur | `22` | `run_alignment_daily.sh` | | `cils@100.126.225.111` | `cils` | Mac opĂ©rateur secondaire (`photon`, lockĂ©: pas de service essentiel) | `22` | `run_alignment_daily.sh` | | `root@192.168.0.119` | `root` | Serveur systĂšme / exĂ©cution matĂ©rielle (rĂ©serve) | `22` | `run_alignment_daily.sh` | - Politique de charge P2P: `mesh_sync_preflight.sh --load-profile tower-first` - ordre: `Tower -> KXKM -> CILS -> local -> root` - `cils` accepte uniquement le repo critique `Kill_LIFE` en mode verrouillĂ©. - Repos GitHub actifs: - `electron-rare/Kill_LIFE` - `electron-rare/mascarade` - `electron-rare/crazy-life` (privĂ©) - Snapshot machines/repos: - [docs/MACHINE_SYNC_STATUS_2026-03-20.md](docs/MACHINE_SYNC_STATUS_2026-03-20.md) - [docs/MACHINE_ALIGNMENT_CONTRACT_2026-03-20.md](docs/MACHINE_ALIGNMENT_CONTRACT_2026-03-20.md) ### Health-check SSH (vĂ©rification machine) ```bash bash tools/cockpit/ssh_healthcheck.sh --json ``` - VĂ©rification de connectivitĂ© par machine avec statut `OK`/`KO` par ligne. - Logs horodatĂ©s: `artifacts/cockpit/ssh_healthcheck__.log`. - Contrat d’alignement opĂ©rationnel: [docs/MACHINE_ALIGNMENT_CONTRACT_2026-03-20.md](docs/MACHINE_ALIGNMENT_CONTRACT_2026-03-20.md) Routine quotidienne: ```bash bash tools/cockpit/run_alignment_daily.sh --json bash tools/cockpit/run_alignment_daily.sh --skip-healthcheck --json ``` - Lance health-check SSH + `repo_refresh` en mode header-only. - IntĂšgre la mĂ©moire opĂ©rationnelle: [docs/MACHINE_SYNC_STATUS_2026-03-20.md](docs/MACHINE_SYNC_STATUS_2026-03-20.md) et [docs/MESH_SYNC_INCIDENT_REGISTER_2026-03-20.md](docs/MESH_SYNC_INCIDENT_REGISTER_2026-03-20.md). - En mode charge sensible, utiliser `--mesh-load-profile photon-safe`. - Écrit un log horodatĂ©: `artifacts/cockpit/machine_alignment_daily__.log`. - Purge auto configurable (`--purge-days `, dĂ©faut `14`). - Sur les machines non-pilotes, utiliser `--skip-healthcheck` si la clĂ© SSH n’est pas prĂ©vue pour l’auto-check mutuel. --- ## 🚀 Installation & dĂ©marrage rapide ### PrĂ©requis - OS : Linux, macOS, Windows (WSL) - Python ≄ 3.10 - Docker + `docker compose` - `gh` pour les opĂ©rations GitHub - PlatformIO en natif ou via la stack conteneurisĂ©e - KiCad (hardware) ### Installation rapide ```bash git clone https://github.com/electron-rare/Kill_LIFE.git cd Kill_LIFE bash install_kill_life.sh ``` Voir [INSTALL.md](INSTALL.md) pour les dĂ©tails. ### Bootstrap Python repo-local ```bash bash tools/bootstrap_python_env.sh ``` Options utiles : - `--venv-dir /tmp/kill-life-venv` pour vĂ©rifier le bootstrap sur un environnement vierge - `--reinstall` pour recrĂ©er proprement le venv cible Le chemin supportĂ© pour le Python du repo est `./.venv/bin/python`. ### Tests Python ```bash bash tools/test_python.sh ``` | Suite | Commande | Contenu | |---|---|---| | `stable` | `--suite stable` | Tests repo-locaux (specs, compliance, sanitizer, safe patch, schops) | | `mcp` | `--suite mcp` | Tests MCP locaux (knowledge-base, github-dispatch, nexar) | | `all` | `--suite all` | Les deux suites enchaĂźnĂ©es | Options : `--bootstrap` pour crĂ©er le venv avant, `--list` pour lister les commandes couvertes. ### VĂ©rifications utiles ```bash .venv/bin/python tools/compliance/validate.py --strict .venv/bin/python tools/validate_specs.py --json bash tools/hw/cad_stack.sh doctor KILL_LIFE_PIO_MODE=container .venv/bin/python tools/auto_check_ci_cd.py ``` `tools/validate_specs.py` inclut un preflight PyYAML avant d'appeler `tools/compliance/validate.py` et retourne un message d'installation explicite si la dependance manque. --- ## 🔧 Serveurs MCP Le projet expose **7 serveurs MCP** (Model Context Protocol) configurĂ©s dans [`mcp.json`](mcp.json) : | Serveur | Type | RĂŽle | |---|---|---| | `kicad` | local | Gestion de projet, schĂ©mas, PCB, bibliothĂšques, validation, exports, sourcing | | `validate-specs` | local | Validation specs, compliance, RFC2119 (CLI + MCP stdio) | | `knowledge-base` | local | Recherche, lecture, ajout de memos (docmost) | | `github-dispatch` | local | Dispatch de workflows GitHub allowlistĂ©s | | `freecad` | local | ModĂ©lisation 3D, rendu, export, validation | | `openscad` | local | ModĂ©lisation paramĂ©trique, export, validation | | `huggingface` | distant | AccĂšs au Hub HuggingFace (datasets, modĂšles, papers) | La stack CAD est documentĂ©e dans [`deploy/cad/README.md`](deploy/cad/README.md) et pilotĂ©e par [`tools/hw/cad_stack.sh`](tools/hw/cad_stack.sh). - Cible actuelle : **KiCad 10 first** + FreeCAD + OpenSCAD - Launcher MCP : [`tools/hw/run_kicad_mcp.sh`](tools/hw/run_kicad_mcp.sh) - Configuration MCP : [`docs/MCP_SETUP.md`](docs/MCP_SETUP.md) et [`mcp.json`](mcp.json) --- ## đŸ€– ZeroClaw & intĂ©grations agentiques (optionnel) Le runtime opĂ©rateur `ZeroClaw` peut tourner nativement sur la machine opĂ©rateur. Le launcher supportĂ© essaie d'abord le binaire repo-local `zeroclaw/target/release/zeroclaw`, puis retombe sur `command -v zeroclaw` (typiquement `~/.cargo/bin/zeroclaw`). ```bash bash tools/ai/zeroclaw_stack_up.sh # dĂ©marrer bash tools/ai/zeroclaw_stack_down.sh # arrĂȘter ``` Les runbooks et intĂ©grations vivent dans [`tools/ai/integrations/`](tools/ai/integrations/) : | IntĂ©gration | RĂŽle | |---|---| | `zeroclaw/` | Runtime opĂ©rateur local, boucles agentiques | | `langgraph/` | Pattern d'intĂ©gration LangGraph | | `autogen/` | Pattern d'intĂ©gration AutoGen | | `n8n/` | Orchestration no-code / workflows externes | Ces intĂ©grations restent consultables mĂȘme quand le runtime n'est pas dĂ©marrĂ©. --- ## 📩 Workflow catalog Les workflows Ă©ditables par `crazy_life` vivent dans [`workflows/`](workflows/) et sont validĂ©s contre [`workflows/workflow.schema.json`](workflows/workflow.schema.json). | Workflow | Fichier | |---|---| | Spec-first | `workflows/spec-first.json` | | Embedded CI local | `workflows/embedded-ci-local.json` | | Compliance release | `workflows/compliance-release.json` | - `workflows/templates/*.json` : templates de crĂ©ation - `.crazy-life/runs/` : Ă©tat des runs locaux gĂ©nĂ©rĂ© par `crazy_life` si l'Ă©diteur est utilisĂ© - `.crazy-life/backups/workflows/` : rĂ©visions/restores gĂ©nĂ©rĂ©s localement par `crazy_life` (non versionnĂ©s) --- ## đŸŠŸ Workflows agents dĂ©taillĂ©s ### 1. SpĂ©cification → ImplĂ©mentation Firmware 1. RĂ©dige la spec dans `specs/`. 2. Ouvre une issue avec le label `ai:spec`. 3. `PM-Mesh` et `Arch-Mesh` gĂ©nĂšrent le plan et l'architecture. 4. `Firmware` implĂ©mente le code dans `firmware/`. 5. `QA-Compliance` ajoute les tests Unity et la validation contractuelle. 6. Evidence pack gĂ©nĂ©rĂ© automatiquement.
Evidence Pack
### 2. Bulk Edit Hardware KiCad 1. Ouvre une issue `type:systems` + `scope:hardware`, puis ajoute `ai:plan` (ou `ai:impl` si le batch est déjà cadré). 2. `Embedded-CAD` effectue le bulk edit via `tools/hw/schops`. 3. Exporte ERC/DRC, BOM, netlist. 4. Snapshot avant/aprÚs dans `artifacts/hw//`.
Bulk Edit Party
### 3. Documentation & Conformité 1. Ouvre une issue avec `ai:plan` puis route le write set vers l'owner canonique du catalogue. 2. `Docs-Research` met à jour `docs/`, `README.md` et `README_FR.md`. 3. `QA-Compliance` valide le profil de conformité et génÚre le rapport, avec relais doc si nécessaire.
Gate Validation
--- ## đŸ›Ąïž SĂ©curitĂ© & conformitĂ© - OpenClaw : sandbox obligatoire, jamais d'accĂšs aux secrets ou au code source. - Workflows CI : validation, sanitisation, scope guard, anti-prompt injection. - Evidence packs : tous les rapports dans `artifacts///`. - Tests hardware reproductibles via scripts documentĂ©s.
OpenClaw Sandbox

CI Success CI Running CI Error CI Cancel CI Inactive
### ChaĂźne de compliance ```text compliance/ ├── active_profile.yaml # Profil actif (ex: "prototype") ├── profiles/ │ ├── prototype.yaml # Standards requis + evidence pour prototype │ └── iot_wifi_eu.yaml # Profil IoT WiFi marchĂ© EU ├── standards_catalog.yaml # Catalogue de standards versionnĂ©s ├── plan.yaml # Produit, marchĂ©, radio, alimentation └── evidence/ ├── risk_assessment.md # Évaluation des risques ├── security_architecture.md # Architecture de sĂ©curitĂ© ├── test_plan_radio_emc.md # Plan de test radio/EMC └── supply_chain_declarations.md ``` Contraintes projet (depuis [`specs/constraints.yaml`](specs/constraints.yaml)) : - **Orientation** : ESP-first (cibles : esp32s3, esp32, esp32dev) - **Firmware** : PlatformIO + Unity (tests requis) - **Hardware** : KiCad ≄ 9 minimum, chemin prĂ©fĂ©rĂ© KiCad 10-first, bulk edits autorisĂ©s, ERC green requis - **IA** : un label `ai:*` adapte a l'etape est requis, secrets interdits, pas d'hypothese reseau - **Compliance** : profil actif injectĂ©, validĂ© par `tools/compliance/validate.py` --- ## 🌐 ÉcosystĂšme | Repo | RĂŽle | AccĂšs | |---|---|---| | **Kill_LIFE** | Source de vĂ©ritĂ© : workflows, runtime, evidence packs, firmware, CAD, compliance | 🌍 public | | **ai-agentic-embedded-base** | Compagnon local : miroir exportĂ© des `specs/` + seed firmware minimal, jamais source de vĂ©ritĂ© primaire | local | | **crazy_life** | Surface web/devops et workflow editor | 🔒 privĂ© | | **mascarade** | Orchestration et bridge historique (sync uniquement) | 🔒 privĂ© | ### Datasets HuggingFace 8 datasets de fine-tuning publiĂ©s sur [HuggingFace](https://huggingface.co/clemsail) (JSON, 1K-10K entrĂ©es chacun) : `mascarade-stm32` · `mascarade-spice` · `mascarade-iot` · `mascarade-power` · `mascarade-dsp` · `mascarade-emc` · `mascarade-kicad` · `mascarade-embedded` Articulation dĂ©taillĂ©e : [`docs/MASCARADE_BRIDGE.md`](docs/MASCARADE_BRIDGE.md) --- ## ⚙ CI & release **22 workflows GitHub Actions** couvrent l'ensemble du cycle : | CatĂ©gorie | Workflows | |---|---| | **Gate principal** | `ci.yml` (bootstrap Python + suite stable) | | **Release** | `release_signing.yml` (tag `v*` ou `workflow_dispatch`) | | **QualitĂ©** | `badges.yml`, `evidence_pack.yml`, `repo_state.yml`, `repo_state_header_gate.yml` | | **SĂ©curitĂ©** | `secret_scan.yml`, `sbom_validation.yml`, `supply_chain.yml`, `incident_response.yml` | | **Tests avancĂ©s** | `api_contract.yml`, `model_validation.yml`, `performance_hil.yml` | | **Infra** | `dependency_update.yml`, `community_accessibility.yml` | | **Pages** | `jekyll-gh-pages.yml`, `static.yml` (surfaces secondaires docs/evidence) | | **Orchestration** | `zeroclaw_dual_orchestrator.yml` | --- ## đŸ€ Contribuer 1. Forke le dĂ©pĂŽt et clone-le localement. 2. Suis le guide d'onboarding ([docs/index.md](docs/index.md), [RUNBOOK.md](RUNBOOK.md)). 3. Ajoute des exemples minimalistes pour chaque agent (voir [agents/](agents/)). 4. Propose des blocks hardware, profils de conformitĂ©, tests. 5. Ouvre une PR, passe les gates, fournis un evidence pack. 6. Respecte les conventions de commit et de labelling (`ai:*`). > « Les particules rĂȘvent-elles d'Ă©lectron-ironique ? Peut-ĂȘtre font-elles l'amour dans le dossier hardware, pendant que les agents QA se demandent si la conformitĂ© est un rĂȘve ou une rĂ©alitĂ©. » > — InspirĂ© par Le RĂ©plicant de K. Dick & Les particules font-elles l'amour _« J'ai vu des evidence packs briller dans l'obscuritĂ© prĂšs des gates S1
 »_ --- ## 🔗 Liens utiles - [Documentation complĂšte](docs/index.md) - [RUNBOOK opĂ©rateur](RUNBOOK.md) - [Guide d'installation](INSTALL.md) - [Configuration MCP](docs/MCP_SETUP.md) - [SynthĂšse technique](KIKIFOU/synthese.md) - [Diagramme pipeline](KIKIFOU/diagramme.md) - [Mapping dossiers](KIKIFOU/mapping.md) --- ## ❓ FAQ **Q : Comment dĂ©marrer rapidement ?** R : `bash install_kill_life.sh` puis `bash tools/bootstrap_python_env.sh`. **Q : Comment lancer les tests ?** R : `bash tools/test_python.sh --suite stable` **Q : Comment sĂ©curiser OpenClaw ?** R : Sandbox obligatoire, jamais d'accĂšs aux secrets ou au code source. **Q : Comment contribuer ?** R : Forke, suis le RUNBOOK, ouvre une PR avec evidence pack, respecte les labels `ai:*`. **Q : OĂč trouver la documentation complĂšte ?** R : [docs/index.md](docs/index.md), [RUNBOOK.md](RUNBOOK.md), [INSTALL.md](INSTALL.md). --- ## 📜 Licence MIT. Voir [`licenses/MIT.txt`](licenses/MIT.txt). ## Audit & Execution Plan (2026-03-10) ### Snapshot - Priority: `P2` - Tech profile: `other` - Workflows: `yes` - Tests: `yes` - Debt markers: `6` - Source files: `156` ### Corrections Prioritaires - [ ] Optimisation ciblĂ©e perf/maintenabilitĂ© - [ ] Ajouter/fiabiliser les commandes de vĂ©rification automatiques. - [ ] Clore les points bloquants avant optimisation avancĂ©e. ### Optimisation - [ ] Identifier le hotspot principal et mesurer avant/aprĂšs. - [ ] RĂ©duire la complexitĂ© des modules les plus touchĂ©s. ### MĂ©moire chantier - Control plane: `/Users/electron/.codex/memories/electron_rare_chantier` - Repo card: `/Users/electron/.codex/memories/electron_rare_chantier/REPOS/Kill_LIFE.md` ## Delta mesh tri-repo 2026-03-20 Cette refonte opere desormais en mode maillĂ© entre `Kill_LIFE`, `mascarade` et `crazy_life`. - Contrat de gouvernance: [docs/TRI_REPO_MESH_CONTRACT_2026-03-20.md](docs/TRI_REPO_MESH_CONTRACT_2026-03-20.md) - Spec des contrats publics: [specs/mesh_contracts.md](specs/mesh_contracts.md) - Todo de transition: [docs/plans/19_todo_mesh_tri_repo.md](docs/plans/19_todo_mesh_tri_repo.md) - Preflight machines/repos: [tools/cockpit/mesh_sync_preflight.sh](tools/cockpit/mesh_sync_preflight.sh) - Operations logs: [tools/cockpit/log_ops.sh](tools/cockpit/log_ops.sh) Regles actives: - un lot doit declarer `owner_repo`, `owner_agent`, `write_set`, `preflight`, `validations`, `evidence`, `sync_targets` - aucun revert de changements externes - aucune propagation sans preflight de convergence - les MCP sont conformes en `ready` ou `degraded`; `blocked` doit etre justifie ## Full operator lane (2026-03-20) - Workflow source of truth: `workflows/embedded-operator-live.json` - Live provider bridge: - `tools/ops/operator_live_provider_smoke.js` - `tools/ops/operator_live_provider_smoke.py` - TUI runbook: `bash tools/cockpit/full_operator_lane.sh all` - Patchset sync: `bash tools/cockpit/full_operator_lane_sync.sh --json` - Evidence contract: `specs/contracts/operator_lane_evidence.schema.json` - Operator doc: `docs/FULL_OPERATOR_LANE_2026-03-20.md` - Provider/runtime note: `docs/PROVIDER_RUNTIME_COMPAT_2026-03-20.md` - Validated on `clems`: - dry-run `success` - live `success` - provider/model observed: `claude` / `claude-sonnet-4-6` ### Refonte globale YiACAD 2026 - Audit global: [docs/YIACAD_GLOBAL_REFACTOR_AUDIT_2026-03-20.md](docs/YIACAD_GLOBAL_REFACTOR_AUDIT_2026-03-20.md) - Evaluation IA: [docs/YIACAD_GLOBAL_AI_INTEGRATION_ASSESSMENT_2026-03-20.md](docs/YIACAD_GLOBAL_AI_INTEGRATION_ASSESSMENT_2026-03-20.md) - Feature map globale: [docs/YIACAD_GLOBAL_FEATURE_MAP_2026-03-20.md](docs/YIACAD_GLOBAL_FEATURE_MAP_2026-03-20.md) - Recherche OSS globale: [docs/YIACAD_GLOBAL_OSS_RESEARCH_2026-03-20.md](docs/YIACAD_GLOBAL_OSS_RESEARCH_2026-03-20.md) - Spec globale: [specs/yiacad_global_refonte_spec.md](specs/yiacad_global_refonte_spec.md) - Plan global: [docs/plans/21_plan_refonte_globale_yiacad.md](docs/plans/21_plan_refonte_globale_yiacad.md) - TODO globale: [docs/plans/21_todo_refonte_globale_yiacad.md](docs/plans/21_todo_refonte_globale_yiacad.md) - Index operateur: `bash tools/cockpit/yiacad_operator_index.sh --action status` - TUI globale: `bash tools/cockpit/yiacad_refonte_tui.sh --action status` - Facade backend locale: `python3 tools/cad/yiacad_backend_service.py status` ### Delta 2026-03-21 - backend service YiACAD - Service local: [docs/YIACAD_BACKEND_SERVICE_2026-03-21.md](docs/YIACAD_BACKEND_SERVICE_2026-03-21.md) - Client service-first: `python3 tools/cad/yiacad_backend_client.py --json-output health` - TUI backend: `bash tools/cockpit/yiacad_backend_service_tui.sh --action status` ## 2026-03-21 - Canonical operator entry - Entree publique recommandee: `bash tools/cockpit/yiacad_operator_index.sh --action status`. - Surface de preuves: `bash tools/cockpit/yiacad_proofs_tui.sh --action status`. - Surface de logs: `bash tools/cockpit/yiacad_logs_tui.sh --action status`. - Les routes directes historiques restent compatibles, mais ne sont plus l'entree publique recommandee.