# SPEC: Rewrite VRAM Detection as Python Script

## Goal
Replace the fragile `scripts/vram_detect.sh` with a testable Python script that produces the same JSON output.

## Requirements
1. Create `scripts/vram_detect.py` with the same CLI interface:
   - `--model` / `-m`
   - `--project` / `-p`
   - Optional positional model name
2. Preserve the human-readable output sections and the `=== JSON Output ===` block.
3. Fix known bugs:
   - Undefined `$headroom_pct` in manual mode.
   - Hardcoded `"headroom": 0.25` in JSON output.
   - GPU-counting/output ordering bug.
   - Enforce 10KB file-read limit for API config files.
4. Delete `scripts/vram_detect.sh`.
5. Update references in `prompts/orchestrate.md`, `prompts/decompose.md`, `prompts/onboarding.md`, `README.md`, and `config.md` to point to the Python script.

## Acceptance Criteria
- [ ] `python scripts/vram_detect.py` runs and emits valid JSON.
- [ ] Manual-mode headroom is read from `config.md`, not hardcoded.
- [ ] Large API config files are read with a 10KB limit.
- [ ] `scripts/vram_detect.sh` no longer exists.
- [ ] All prompts/docs reference the Python script.

## Non-Goals
- Changing the recommendation algorithm.
- Adding GPU vendor detection beyond Linux `nvidia-smi`, `lspci`, and `/proc/meminfo`.

## Stop Condition
When all acceptance criteria are met, output "CONTRACT_MET".