# Projects Index
Cross-linked project docs. Each project gets its own file in `projects/`.
## Active Projects
| Project | Status | File | Key Tags |
|---------|--------|------|----------|
| [AI Rig Upgrade](ai-rig-upgrade.md) | Active — GPU Shopping | `ai-rig-upgrade.md` | `gpu`, `ollama`, `local-ai`, `upgrade` |
| [Brewery PID Replacement](brewery-pid-replacement.md) | Research | `brewery-pid-replacement.md` | `brewery`, `esp32-s3`, `esphome`, `pid`, `pt100` |
| [ComBadge](com-badge.md) | Research | `com-badge.md` | `esp32-s3`, `wearable`, `voice`, `pico-claw` |
| [Tricorder](tricorder.md) | Design | `tricorder.md` | `esp32-s3`, `unihiker`, `voice`, `pico-claw`, `sensors` |
| [Pi-hole Blocker](pihole-blocker.md) | Planning → Full Router | `pihole-blocker.md` | `networking`, `cm4`, `dns`, `ad-blocking`, `firewall`, `vpn`, `router` |
| [Fermentation Dashboard](fermentation-dashboard.md) | Planning | `fermentation-dashboard.md` | `brewery`, `home-assistant`, `tilt`, `grafana` |
| [Robotics Lab Pi Replacement](ROBOTICS-LAB-PI-REPLACEMENT.md) | Research | `ROBOTICS-LAB-PI-REPLACEMENT.md` | `x86`, `classroom`, `arduino`, `lattepanda` |
| [AI Desktop Companion](ai-desktop-companion.md) | Research | `ai-desktop-companion.md` | `esp32-s3`, `m5stack`, `stackchan`, `voice`, `robot` |
| [Android Head Unit OpenClaw](android-head-unit-openclaw.md) | Planning | `android-head-unit-openclaw.md` | `android`, `voice`, `car`, `head-unit`, `openclaw` |
| [Robotics Team Agent](robotics-team-agent.md) | ✅ Complete | `robotics-team-agent.md` | `openclaw`, `gitea`, `java`, `wpilib` |
## Hardware Catalog
| File | Scope |
|------|-------|
| [`../DEVICES.md`](../DEVICES.md) | Detailed hardware specs for all evaluated devices |
| [`../HARDWARE-WISHLIST.md`](../HARDWARE-WISHLIST.md) | Future / "someday" hardware finds |
## Shared Components Map
```
┌─────────────────────────────┐
│ ESP32-S3 │
│ (M5StickS3 + K10 + AtomS3 │
│ + StackChan CoreS3) │
└──────────┬──────────────────┘
│
┌────────────────┼────────────────┐─────────────────┐
▼ ▼ ▼ ▼
┌──────────┐ ┌───────────┐ ┌──────────┐ ┌────────────┐
│ ComBadge │ │ Tricorder │ │ AtomS3 │ │ StackChan │
│(M5StickS3)│ │ (K10+M10) │ │ (aux) │ │ (CoreS3) │
└──────────┘ └───────────┘ └──────────┘ └────────────┘
│ │ │ │
└────────────────┼────────────────┘ │
│ │
┌─────▼─────┐ ┌─────▼─────┐
│ PicoClaw │ │ XiaoZhi │
│(MicroPython│ │ AI Agent │
│ OpenClaw) │ │ + PicoClaw│
└───────────┘ └───────────┘
```
**Key shared pieces:**
- **ESP32-S3** — ComBadge (M5StickS3) + Tricorder (K10) + AtomS3 (aux component)
- **PicoClaw/PycoClaw** — ComBadge + Tricorder (both target MicroPython agent on ESP32-S3)
- **Voice pipeline** — ComBadge + Tricorder (same flow: wake word → STT → LLM → TTS)
- **M5Stack ecosystem** — ComBadge (M5StickS3) + AtomS3 (component) + StackChan (CoreS3, desktop companion)
- **DFRobot ecosystem** — Tricorder (UNIHIKER M10+K10)
- **x86 computing** — Robotics Lab Pi Replacement (LattePanda IOTA, mini PCs)
## How to Use This System
### Adding a new project
1. Create `projects/your-project.md` using the [template](#project-template) below
2. Add it to the [Active Projects table](#active-projects)
3. Link hardware to [`DEVICES.md`](../DEVICES.md) and add tags
4. Link related projects with `[[project-name.md]]` syntax
### Cross-referencing between projects
Use markdown links:
```markdown
See [[com-badge.md]] for the wearable voice badge.
```
### Tag-based lookup
Tags are listed in project frontmatter and in the Active Projects table. Search by tag to find related projects.
### Hardware overlap
Check [`DEVICES.md`](../DEVICES.md) — it tracks all evaluated hardware with specs. Project files link to the relevant sections.
## Project Template
```markdown
# Project Name
**Status:** Research / Planning / In Progress / Complete / On Hold
**Created:** YYYY-MM-DD
**Updated:** YYYY-MM-DD
**Tags:** `tag1`, `tag2`
## Summary
One-paragraph what and why.
## Hardware
- Device name — role — link to DEVICES.md section
## Software / Stack
- Framework, language, platform
## Architecture
How the pieces connect.
## Progress
- [ ] Step 1
- [ ] Step 2
## Open Questions
- Question?
## Related Projects
- [[other-project.md]] — why it's related
## Decision Log
### YYYY-MM-DD — Decision
Why and what was decided.
```
---
_Maintained by Crash-bot. Last updated: 2026-04-15_