Initial commit 2026-05-03
This commit is contained in:
psb-gemma
81
knowledge/2890-Claw.md
Normal file
81
knowledge/2890-Claw.md
Normal file
@@ -0,0 +1,81 @@
|
||||
# Concepts — 2890 Claw (FRC Robotics Team)
|
||||
|
||||
Chris coaches FRC Team 2890 (Hawk Collective) at Hickory High School. Theme: The Borg. Agent: 2890-bot.
|
||||
|
||||
## Team Identity
|
||||
|
||||
- **FRC Team 2890** — Hickory High School
|
||||
- **Theme:** The Borg — "You will be assimilated!"
|
||||
- **Colors:** Teal (#03818a), Black (#050505), White (#ffffff), Hot Pink (#ec40f5)
|
||||
- **Mascot:** Mothman (stylized hawk head)
|
||||
- **Discord:** 266074632056995840
|
||||
|
||||
## Key People
|
||||
|
||||
- **Chris Slater** — Lead Coach
|
||||
- **Mr. Douglas** — Programming Mentor
|
||||
- **Alex C** — Mentor (21 years FRC)
|
||||
- **Walt McCorkill** — Head Mentor, Bumper King
|
||||
- **Riley Meyer** — Technician, former driver
|
||||
|
||||
## Core Systems
|
||||
|
||||
- **Gitea** — http://2890.duckdns.org:3002/Team2890
|
||||
- **OpenClaw / 2890-bot** — team Discord integration
|
||||
- **PhotonVision** — AprilTag vision processing
|
||||
- **YAGSL** — swerve drive control
|
||||
- **WPILib** — FRC robot framework (Java)
|
||||
|
||||
## Robot (2026: Mothman)
|
||||
|
||||
- Game: REBUILT
|
||||
- Vision: PhotonVision (AprilTags)
|
||||
- Drive: YAGSL swerve
|
||||
|
||||
## Core Skills
|
||||
|
||||
- **FRC programming** — Java, WPILib, command-based architecture
|
||||
- **Swerve drive** — YAGSL, odometry, path planning
|
||||
- **Vision processing** — PhotonVision, AprilTags, limelight-style targeting
|
||||
- **Robot mechanics** — gearboxes, bumpers, mechanisms
|
||||
- **Team coordination** — Git, code review, documentation
|
||||
- **Gitea** — Git hosting, code review, CI
|
||||
|
||||
## Knowledge Dependencies
|
||||
|
||||
```
|
||||
FRC Robot Programming (Java)
|
||||
├── WPILib basics
|
||||
├── Command-based architecture
|
||||
├── Swerve drive (YAGSL)
|
||||
├── Odometry / pose estimation
|
||||
└── NetworkTables
|
||||
|
||||
Vision Processing
|
||||
├── PhotonVision setup
|
||||
├── AprilTag detection
|
||||
├── 3D position estimation
|
||||
└── Integration with swerve
|
||||
|
||||
Team Operations
|
||||
├── Git workflow (Gitea)
|
||||
├── Code review practices
|
||||
├── Robot testing methodology
|
||||
└── Safety / inspections
|
||||
```
|
||||
|
||||
## Gap Analysis for Chris
|
||||
|
||||
Chris is strong on: coaching, mechanical, electronics
|
||||
Chris is weak on:
|
||||
- **Java / WPILib** — could go deeper on advanced command-based patterns
|
||||
- **Vision processing** — AprilTag + PhotonVision is new territory
|
||||
- **Git workflow** — team needs better code review practices
|
||||
|
||||
## Recurring Topics
|
||||
|
||||
1. **Swerve drive** — YAGSL, odometry, field constants
|
||||
2. **Vision targeting** — AprilTags, PhotonVision, pose estimation
|
||||
3. **Java programming** — WPILib, command structure
|
||||
4. **Team management** — student progress, meeting structure
|
||||
5. **Git/DevOps** — Gitea setup, code review workflow
|
||||
94
knowledge/HHS-Hackers.md
Normal file
94
knowledge/HHS-Hackers.md
Normal file
@@ -0,0 +1,94 @@
|
||||
# Concepts — HHS Hackers
|
||||
|
||||
Hardware/software hacking collective. Chris + former students (Matt, Kyle).
|
||||
|
||||
## Active Projects
|
||||
|
||||
| Project | Status | Key Concepts |
|
||||
|---------|--------|---------------|
|
||||
| ComBadge | Research | ESP32-S3, wearable, voice AI, PicoClaw, Wi-Fi |
|
||||
| Tricorder | Design | ESP32-S3, sensors, UniHiker, voice, PicoClaw |
|
||||
| Pi-hole Router | Planning | DNS, firewall, router, CM4, VLAN, network config |
|
||||
| AI Rig Upgrade | GPU Shopping | GPU Passthrough, Ollama, local AI inference |
|
||||
| Android Head Unit | Planning | CAN bus, car telemetry, voice AI, head unit |
|
||||
| AI Desktop Companion | Research | M5Stack, StackChan, voice robot |
|
||||
| Brewery PID Replacement | Prototyping | ESP32-S3, ESPHome, Home Assistant, PID, PT100 |
|
||||
|
||||
## Core Skills
|
||||
|
||||
- **ESP32-S3** — embedded development, low-level hardware
|
||||
- **Voice AI** — hotword detection, speech-to-text, local LLM
|
||||
- **Home networking** — DNS, DHCP, firewall, VLAN, router config
|
||||
- **Home Assistant** — home automation, dashboarding, integrations
|
||||
- **OpenClaw** — multi-agent systems, exec management
|
||||
- **Docker** — containerized services
|
||||
- **CAD/3D printing** — case design
|
||||
|
||||
## Knowledge Dependencies (Skills needed for projects)
|
||||
|
||||
```
|
||||
ESP32-S3 dev
|
||||
├── C/Arduino SDK
|
||||
├── esp-idf or Arduino framework
|
||||
├── I2C/SPI protocols
|
||||
├── Wi-Fi (station + AP modes)
|
||||
└── BLE (optional)
|
||||
|
||||
Voice AI
|
||||
├── Wake word / hotword detection
|
||||
├── Speech-to-text (on-device or API)
|
||||
├── Local LLM integration
|
||||
└── Text-to-speech
|
||||
|
||||
Home Networking
|
||||
├── DNS fundamentals ← Pi-hole requires this
|
||||
├── DHCP fundamentals
|
||||
├── Port forwarding / NAT
|
||||
├── Firewall rules (iptables/nftables)
|
||||
├── VLANs ← Natural next step after basic networking
|
||||
└── VPN basics
|
||||
|
||||
Home Assistant
|
||||
├── YAML configuration
|
||||
├── ESPHome integration
|
||||
├── Entities, automations
|
||||
└── Dashboard (HA Lovelace)
|
||||
|
||||
ComBadge / Tricorder
|
||||
├── ESP32-S3
|
||||
├── Sensor selection / I2C
|
||||
├── Battery management
|
||||
├── Enclosure design
|
||||
└── Voice AI pipeline
|
||||
|
||||
Pi-hole Router
|
||||
├── DNS ← FOUNDATION (needed first!)
|
||||
├── DHCP
|
||||
├── Network routing
|
||||
├── Firewall
|
||||
├── VLANs ← after basic networking
|
||||
└── VPN (optional, advanced)
|
||||
```
|
||||
|
||||
## Gap Analysis for Chris
|
||||
|
||||
Chris is strong on: hardware, ESP32, soldering, circuit design
|
||||
Chris is weak on:
|
||||
- **Networking fundamentals** — DNS, DHCP, VLANs, firewall rules. He keeps running into networking gaps when doing Pi-hole and router projects. This is the biggest gap.
|
||||
- **3D CAD** — designing cases/enclosures. Has printer but not using it effectively for project enclosures.
|
||||
- **Software architecture** — can build circuits but wiring multiple services together (Home Assistant, ESPHome, dashboards) takes too long.
|
||||
|
||||
## Gap Detection Map
|
||||
|
||||
When Chris works on:
|
||||
- **Pi-hole** → He needs DNS fundamentals first, then DHCP, then firewall, then VLANs
|
||||
- **ComBadge/Tricorder** → He knows ESP32 well, but voice AI pipeline is new. Needs hotword → STT → LLM → TTS understanding.
|
||||
- **Brewery PID** → He's learning ESPHome + Home Assistant integration, which is mostly YAML config.
|
||||
|
||||
## Recurring Topics
|
||||
|
||||
1. **ESP32-S3** — appears in ComBadge, Tricorder, PID controller, AI Desktop Companion
|
||||
2. **Voice AI** — ComBadge, Tricorder, Android Head Unit, AI Desktop Companion
|
||||
3. **Home networking** — Pi-hole, VLANs, router replacement
|
||||
4. **Local AI inference** — Ollama, GPU setup, ComBadge backend
|
||||
5. **Home Assistant** — fermentation dashboard, PID controllers, automation
|
||||
60
knowledge/PSB.md
Normal file
60
knowledge/PSB.md
Normal file
@@ -0,0 +1,60 @@
|
||||
# Concepts — PSB (Post Secondary Brewing)
|
||||
|
||||
Chris and Susan's craft brewery. Three agents: psb-thinking (planning), psb-gemma (brewhouse ops), psb-business (business side).
|
||||
|
||||
## Active Projects
|
||||
|
||||
| Project | Status | Key Concepts |
|
||||
|---------|--------|---------------|
|
||||
| Fermentation Dashboard | Planning | Home Assistant, TILT hydrometer, Grafana, dashboarding |
|
||||
| Brewery PID Replacement | Prototyping | ESP32-S3, ESPHome, Home Assistant, PID, PT100, custom PCB |
|
||||
| Toast POS | In use | Point of sale, product mix reports, email export |
|
||||
| Pi-hole (brewery) | Not started | DNS, ad-blocking (separate from home Pi-hole) |
|
||||
|
||||
## Core Skills
|
||||
|
||||
- **Brewing chemistry** — fermentation, yeast, malt, hops
|
||||
- **Home Assistant** — telemetry dashboards, TILT integration
|
||||
- **ESP32/ESPhome** — brewery sensor integration
|
||||
- **Toast POS** — sales reporting, product mix analysis
|
||||
- **PCB design** — custom PID controllers (Chris's growing skill)
|
||||
- **PID control** — temperature regulation for brewing vessels
|
||||
|
||||
## Knowledge Dependencies
|
||||
|
||||
```
|
||||
Brewery PID Control
|
||||
├── Temperature sensing (PT100, MAX31865)
|
||||
├── PID algorithm fundamentals
|
||||
├── ESP32-S3 + ESPHome
|
||||
├── Home Assistant integration
|
||||
└── Solid-state relay (SSR) control
|
||||
|
||||
Fermentation Dashboard
|
||||
├── Home Assistant ( Lovelace dashboards)
|
||||
├── TILT hydrometer / Bluetooth bridge
|
||||
├── Grafana (optional, for pretty charts)
|
||||
└── ESP32 bridge programming
|
||||
|
||||
Toast POS
|
||||
├── Report generation (product mix)
|
||||
├── CSV export
|
||||
├── Email automation
|
||||
└── Google Sheets integration
|
||||
```
|
||||
|
||||
## Gap Analysis for Chris (at brewery)
|
||||
|
||||
Chris is strong on: brewing, electronics, PCB design
|
||||
Chris is weak on:
|
||||
- **Home Assistant YAML** — configuration, automations, templating
|
||||
- **Dashboard design** — making data look good (Grafana, Lovelace)
|
||||
- **Software integration** — wiring multiple systems together
|
||||
|
||||
## Recurring Topics
|
||||
|
||||
1. **Temperature control** — PID for vessels (HLT, mash tun, boil kettle, fermenters)
|
||||
2. **Home Assistant** — telemetry dashboards, sensor integration
|
||||
3. **Custom hardware** — ESP32 + PT100 + SSR for temperature control
|
||||
4. **Data visualization** — making fermentation data readable
|
||||
5. **PCB design** — custom brewery controller boards
|
||||
152
knowledge/skill-graph.md
Normal file
152
knowledge/skill-graph.md
Normal file
@@ -0,0 +1,152 @@
|
||||
# Cross-Domain Skill Map
|
||||
|
||||
Skills that span multiple domains. These are the bridges worth surfacing.
|
||||
|
||||
## Skills Present in Multiple Domains
|
||||
|
||||
### Networking
|
||||
| Domain | Use |
|
||||
|--------|-----|
|
||||
| HHS Hackers | Pi-hole router, VLANs, firewall |
|
||||
| PSB | Brewery network, device connectivity |
|
||||
| 2890 Claw | Robot communication, field networking |
|
||||
|
||||
**Gap:** Chris is weak on networking fundamentals. Pi-hole project will expose this soon.
|
||||
|
||||
---
|
||||
|
||||
### Home Assistant
|
||||
| Domain | Use |
|
||||
|--------|-----|
|
||||
| HHS Hackers | PID dashboards, automation |
|
||||
| PSB | Fermentation dashboard, TILT integration |
|
||||
|
||||
**Bridge:** Both domains use HA differently — brewery for telemetry, hackers for home automation.
|
||||
|
||||
---
|
||||
|
||||
### ESP32-S3 / Embedded
|
||||
| Domain | Use |
|
||||
|--------|-----|
|
||||
| HHS Hackers | ComBadge, Tricorder, PID controllers |
|
||||
| PSB | Brewery PID controllers |
|
||||
|
||||
**Bridge:** Same hardware, different contexts. Chris can share learnings between brewery PID and ComBadge.
|
||||
|
||||
---
|
||||
|
||||
### Voice AI
|
||||
| Domain | Use |
|
||||
|--------|-----|
|
||||
| HHS Hackers | ComBadge, Tricorder, AI Desktop Companion |
|
||||
|
||||
**Note:** Not in PSB or 2890 yet, but Chris wants it everywhere.
|
||||
|
||||
---
|
||||
|
||||
### Git / Version Control
|
||||
| Domain | Use |
|
||||
|--------|-----|
|
||||
| HHS Hackers | Gitea for crash-lab |
|
||||
| 2890 Claw | Gitea for robotics team |
|
||||
|
||||
**Bridge:** Chris has two Gitea instances. Could consolidate. Also: Git workflow best practices transfer.
|
||||
|
||||
---
|
||||
|
||||
### OpenClaw / Multi-Agent
|
||||
| Domain | Use |
|
||||
|--------|-----|
|
||||
| HHS Hackers | crash-bot system |
|
||||
| PSB | 3-agent system (thinking/gemma/business) |
|
||||
| 2890 Claw | 2890-bot |
|
||||
|
||||
**Bridge:** Same platform, different configs. Lessons from one transfer to others.
|
||||
|
||||
---
|
||||
|
||||
## Skills Unique to Each Domain
|
||||
|
||||
**HHS Hackers only:**
|
||||
- 3D CAD / enclosure design
|
||||
- CAN bus / automotive
|
||||
- GPU passthrough / local AI inference
|
||||
|
||||
**PSB only:**
|
||||
- Brewing chemistry
|
||||
- Toast POS operation
|
||||
- Fermentation science
|
||||
|
||||
**2890 Claw only:**
|
||||
- FRC / WPILib / Java
|
||||
- Swerve drive mechanics
|
||||
- PhotonVision / AprilTags
|
||||
- Student coaching methodology
|
||||
|
||||
---
|
||||
|
||||
## Priority Learning Paths
|
||||
|
||||
Based on active projects and dependencies:
|
||||
|
||||
### Path 1: Networking Fundamentals (URGENT)
|
||||
**Why:** Pi-hole router project is blocked by DNS/DHCP/firewall knowledge gaps.
|
||||
|
||||
```
|
||||
Step 1: DNS fundamentals (what it is, how resolution works)
|
||||
Step 2: DHCP fundamentals (what it does, how addresses get assigned)
|
||||
Step 3: NAT and port forwarding (how routing works)
|
||||
Step 4: Firewall basics (iptables/nftables concepts)
|
||||
Step 5: VLANs (network segmentation)
|
||||
```
|
||||
|
||||
### Path 2: Home Assistant Mastery
|
||||
**Why:** Both brewery and home projects need HA dashboards and automation.
|
||||
|
||||
```
|
||||
Step 1: Lovelace dashboard basics
|
||||
Step 2: Entities and automations
|
||||
Step 3: ESPHome integration
|
||||
Step 4: Templating and YAML magic
|
||||
Step 5: Grafana integration (for pretty charts)
|
||||
```
|
||||
|
||||
### Path 3: Voice AI Pipeline
|
||||
**Why:** ComBadge and Tricorder both need this.
|
||||
|
||||
```
|
||||
Step 1: Wake word / hotword detection (why it's hard)
|
||||
Step 2: Speech-to-text options (on-device vs API)
|
||||
Step 3: Local LLM integration (Ollama + API)
|
||||
Step 4: Text-to-speech output
|
||||
Step 5: Latency optimization
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Chris's Skill Confidence (Self-Reported + Observed)
|
||||
|
||||
| Skill | Confidence | Source |
|
||||
|-------|------------|--------|
|
||||
| Electronics / PCB design | High | Observed |
|
||||
| ESP32 hardware | High | Observed |
|
||||
| Brewing | High | Observed |
|
||||
| Soldering / assembly | High | Observed |
|
||||
| FRC mechanics | High | Observed |
|
||||
| Home Assistant YAML | Low | Observed (keeps asking for help) |
|
||||
| Networking fundamentals | Low | Observed (Pi-hole blockers) |
|
||||
| Voice AI pipeline | Medium | Learning |
|
||||
| Grafana/dashboards | Low | Mentioned |
|
||||
| Git workflow | Medium | Inconsistent use |
|
||||
| Java/WPILib | Low | Coaching, not coding |
|
||||
| 3D CAD | Medium | Has printer, not using it |
|
||||
|
||||
---
|
||||
|
||||
## Top Gaps to Fill
|
||||
|
||||
1. **DNS + DHCP + networking basics** → unblock Pi-hole router project
|
||||
2. **Home Assistant YAML** → unblock brewery and home projects
|
||||
3. **Voice AI pipeline understanding** → ComBadge/Tricorder will hit this soon
|
||||
4. **Grafana** → fermentation dashboard needs this
|
||||
5. **Java/WPILib advanced** → better coaching when students code
|
||||
Reference in New Issue
Block a user