# MicMap — Claude Context

Windows SteamVR addon that detects a trained noise pattern on a microphone (typically "covering the mic") and triggers the SteamVR system button. Hands-free dashboard toggling, no extra hardware.

## Where to look first

- **`.planning/PROJECT.md`** — current product definition, milestone scope, key decisions, in/out of scope
- **`.planning/ROADMAP.md`** — phase breakdown for the active milestone
- **`.planning/REQUIREMENTS.md`** — falsifiable v1 requirements with REQ-IDs
- **`.planning/STATE.md`** — current position in the milestone, recent decisions, blockers
- **`.planning/research/SUMMARY.md`** — synthesized research for the current milestone (stack versions, architecture, critical pitfalls)
- **`.planning/codebase/`** — snapshot of the existing architecture, stack, conventions, and known concerns

When a question touches the codebase architecture or the active milestone, read the relevant files above before doing open-ended search.

## Active milestone

**Seamless SteamVR Integration** — rip out the legacy virtual-controller driver, replace it with a pure sidecar that creates its own `/input/system/click` boolean component on the HMD property container (technique validated in sister project `D:\Documents\Projects\bey-closer-t1`; see `HMD Button Stub.md` there). Also: fix stubbed JSON config read-back, add SteamVR-native auto-launch via `app.vrmanifest`, ship a single-click Inno Setup installer.

Phase order is load-bearing: Driver Sidecar (1) → Config Read-Back (2, parallel with 1) → Auto-Start (3) → Installer (4) → Docs (5). Do not reorder.

## GSD workflow

This project uses the GSD (Get Shit Done) workflow. Phase lifecycle:

1. **Discuss** — `/gsd-discuss-phase N` gathers context and surfaces gray areas before planning
2. **Plan** — `/gsd-plan-phase N` produces detailed PLAN.md files with task breakdown and verification loop
3. **Execute** — `/gsd-execute-phase N` runs the plans with atomic commits per task
4. **Transition** — move to the next phase with `/gsd-next` or `/gsd-transition`

Current config (`.planning/config.json`): YOLO mode, standard granularity, parallel execution, research + plan-check + verifier all enabled, quality model profile (opus for research/roadmap).

Do not skip phase artifacts. They are the project's memory across context resets.

## Environment notes

- Windows-only: WASAPI for audio, OpenVR driver DLL, Inno Setup for installer. Non-Windows audio stubs remain.
- Bash is available via Git Bash; use Unix-style paths in shell commands (forward slashes, `/dev/null`).
- Stack is locked this milestone: C++17, CMake, ImGui + D3D11, WASAPI, KissFFT, cpp-httplib, nlohmann/json, OpenVR SDK. No framework changes.
- Installer runs elevated (admin); runtime does not require admin.

## Testing

- `mic_test.exe` — audio/detection testing without VR
- `hmd_button_test.exe` — VR input testing without audio (the exit-criterion harness for Phase 1)

Visual validation on a real HMD is mandatory for the "no laser beam" exit criterion of Phase 1 — type-checking and build-success do not substitute.