sistemas-cibernetico-fisicos/.aurelio/README.md
Fábio Cunha 31c9baede3 feat(aurelio): bootstrap flow-meter-pcb realm workspace
- Add .aurelio/config.toml, mcp_config.json, sync.py, README.md

- Seed .aurelio/realm/AGENTS.md and memory/index.md
2026-07-05 20:24:26 +01:00

2.5 KiB

Aurelio Workspace — savearth Flow Meter PCB

WHY

This hardware repository needs the same context, memory, and MCP tooling as the rest of the savearth engineering stack. Keeping a local .aurelio/ workspace inside the repo means agents and contributors can connect to the central savearth-workspace and savearth-mcp services, access electrical-analysis MCPs, and sync memory without relying on an external Git submodule.

HOW

The workspace is defined by .aurelio/config.toml and .aurelio/mcp_config.json. config.toml sets the realm (flow-meter-pcb), display name, sync endpoint, and default models. mcp_config.json declares the MCP servers the local IDE/agent should launch, scoped to hardware work: project/workspace servers, electrical EDA/sourcing servers, knowledge/memory servers, Atlassian, and sequential thinking. .aurelio/sync.py pushes and pulls the brain/ directory to/from the central Proxmox container (CT 208) that hosts the Aurelio brain.

WHAT

Realm

  • Name: savearth Flow Meter PCB
  • Realm: flow-meter-pcb
  • Version: 2.8.0

Tracked workspace files

These files are version-controlled and bootstrapped on clone:

File Purpose
.aurelio/config.toml Workspace identity, sync endpoint, model defaults
.aurelio/mcp_config.json MCP server declarations for this realm
.aurelio/sync.py Push/pull brain/ to the central Aurelio host
.aurelio/README.md This file
.aurelio/realm/AGENTS.md Realm-specific agent guide
.aurelio/realm/memory/index.md Starter memory index

MCP servers

Server Purpose
savearth-mcp Project-specific device and telemetry tools
savearth-workspace Workspace orchestration and realm lookup
electrical-eda-mcp Schematic parsing, ERC, power-rail analysis, SPICE
electrical-sourcing-mcp JLCPCB/LCSC component search, alternates, BOM optimization
knowledge-mcp General knowledge retrieval
codebase-memory-mcp Codebase-aware memory and search
atlassian-mcp-server Jira/Confluence integration
sequential-thinking Structured reasoning helper

Sync commands

# Pull the latest central brain into the local workspace
python3 .aurelio/sync.py --pull

# Push local brain changes to the central workspace
python3 .aurelio/sync.py --push

Ignored state

Runtime brain artifacts, session memory, and auto-generated logs live under .aurelio/brain/ and .aurelio/memory/ and are ignored by Git. Only the bootstrap files listed above are tracked.