Files
L'électron rare a96780ba7e Add French documentation for standards, integrations, cockpit, evaluations, and hardware tools
- Created README_FR.md files for various standards and profiles in the `standards` directory, detailing conventions and usage.
- Added integration documentation for ZeroClaw, AutoGen, LangGraph, and n8n in the `tools/ai/integrations` directory, outlining their roles and usage.
- Introduced a comprehensive README_FR.md for the `tools/cockpit` directory, detailing operator commands and health-check routines.
- Added a README_FR.md for the `tools/evals` directory, providing a benchmark framework for electronic prompts.
- Created a README_FR.md for the `tools/hw/schops` directory, explaining CLI operations for schematic management.
- Added README_FR.md files for the `web` directory and its `project/pcb` subdirectory, outlining the web application structure and PCB viewer inputs.
2026-03-25 01:08:52 +01:00

2.5 KiB
Raw Permalink Blame History

ai-agentic-embedded-base

Repo “de base” qui combine le meilleur de :

  • Specdriven development (Spec Kit) : une spécification comme source de vérité.
  • Standards injection (Agent OS) : standards versionnés + profils.
  • BMAD / BMADMETHOD : agents par rôles + rituels + gates + handoffs.
  • Agent Zero : exécution transparente via outils locaux + logs + artifacts.

Ce dépôt est orienté embarqué (firmware + hardware KiCad) mais extensible multitarget.

TL;DR

  • Écris/itère la spec dans specs/
  • (optionnel) Génère un squelette de spec depuis .specify/ : python3 tools/ai/specify_init.py --name <feature>
  • Applique les standards dans standards/
  • Exécute le cockpit : python3 tools/cockpit/cockpit.py menu
  • Pour lautomatisation GitHub : label ai:codex → Issue → PR

Structure

  • specs/ : intake → spec → arch → plan → tasks + contraintes
  • standards/ : règles globales + profils (ESP / STM / multi)
  • bmad/ : rôles, rituels, gates, templates de handoff
  • agents/ : prompts agents (PM/Architect/FW/QA/Doc/HW)
  • tools/ : cockpit + outils AI + outils hardware (schops)
  • firmware/ : PlatformIO + Unity (tests)
  • hardware/ : KiCad + blocks + rules
  • .github/ : workflows (CI firmware/hardware/docs + Issue→PR Codex)

KiCad local + IA

Voir docs/KICAD_AI_LOCAL.md.

Démarrage rapide

# firmware
cd firmware
python -m pip install -U platformio
pio run -e esp32s3_arduino
pio test -e native

# cockpit
python3 tools/cockpit/cockpit.py menu

Conventions de sortie

Tous les scripts écrivent sous artifacts/<domain>/<timestamp>/ (logs + exports + reports).

V4 — KiCad agentique (bulk + previews + MCP)

  • bash tools/hw/hw_gate.sh hardware/kicad : exports SVG + ERC/DRC JSON + BOM/netlist
  • python3 tools/watch/watch_hw.py : watch mode (re-run gate on save)
  • docs/MCP_SETUP.md : configuration MCP (kicad-sch-api / kicad-sch-mcp) citeturn0search9

Compliance (2 options)

  • Prototype interne : profil prototype (pas de CE/RED)
  • Produit UE WiFi/BLE : profil iot_wifi_eu (RED + cyber + RoHS/REACH/WEEE + ETSI)

Changer de profil :

python3 tools/compliance/use_profile.py prototype
python3 tools/compliance/use_profile.py iot_wifi_eu
python3 tools/compliance/validate.py

Docs : docs/COMPLIANCE.md