31c9baede3
- Add .aurelio/config.toml, mcp_config.json, sync.py, README.md - Seed .aurelio/realm/AGENTS.md and memory/index.md
57 lines
2.5 KiB
Markdown
57 lines
2.5 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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.
|