Initial project scaffold - Phase 1 MVP structure

Core modules:
- cli.py: Command-line interface with Click
- pipeline.py: Main orchestrator
- video_processor.py: Frame extraction with ffmpeg
- audio_analyzer.py: Whisper transcription
- vision_analyzer.py: Component detection (placeholder)
- doc_generator.py: Markdown + PDF output

Also includes:
- pyproject.toml with uv/hatch config
- Prompts for AI analysis
- Basic tests
- ROADMAP.md with 4-week plan

README.md

@@ -1,3 +1,93 @@
 # CAD-Documenter
 
-Video walkthrough → Complete engineering documentation
+**One video → Complete engineering documentation.**
+
+Transform video walkthroughs of CAD models into comprehensive, structured documentation — ready for CDRs, FEA setups, and integration with the Atomaste engineering ecosystem.
+
+## The Problem
+
+- Documentation is tedious — Engineers spend hours documenting CAD models manually
+- Knowledge lives in heads — Verbal explanations during reviews aren't captured
+- CDR prep is painful — Gathering images, writing descriptions, creating BOMs
+- FEA setup requires context — Atomizer needs model understanding that's often verbal
+
+## The Solution
+
+### Input
+- 📹 Video of engineer explaining a CAD model
+- Optional: CAD file references, existing P/N databases
+
+### Output
+- 📄 **Markdown documentation** — Structured, version-controlled
+- 📊 **Bill of Materials** — With standardized P/N
+- 🔧 **Component registry** — Parts, functions, materials, specs
+- 🎯 **Atomizer hints** — Parameters, constraints, objectives for FEA
+- 📑 **CDR-ready PDF** — Via Atomaste Report Standard
+
+## Installation
+
+```bash
+# Clone the repo
+git clone http://100.80.199.40:3000/Antoine/CAD-Documenter.git
+cd CAD-Documenter
+
+# Install dependencies (using uv)
+uv sync
+```
+
+### Requirements
+- Python 3.12+
+- ffmpeg (for video/audio processing)
+- Whisper (for transcription)
+
+## Usage
+
+```bash
+# Basic documentation
+cad-doc video.mp4
+
+# Full pipeline with all integrations
+cad-doc video.mp4 \
+  --output docs/my_assembly/ \
+  --atomizer-hints \
+  --bom \
+  --pdf
+
+# Just extract frames
+cad-doc video.mp4 --frames-only --output frames/
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                         CAD-DOCUMENTER                              │
+│                                                                     │
+│  ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐     │
+│  │  Video   │───►│  Frame   │───►│  Vision  │───►│  Struct  │     │
+│  │  Input   │    │  Extract │    │ Analysis │    │  Output  │     │
+│  └──────────┘    └──────────┘    └──────────┘    └──────────┘     │
+│       │              │                │               │            │
+│       ▼              ▼                ▼               ▼            │
+│  ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐     │
+│  │  Audio   │───►│ Whisper  │───►│ Correlate│───►│ Generate │     │
+│  │  Track   │    │Transcribe│    │ Timeline │    │   Docs   │     │
+│  └──────────┘    └──────────┘    └──────────┘    └──────────┘     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+## Integrations
+
+- **Atomizer** → FEA setup instructions from verbal explanations
+- **Part Manager** → Standardized P/N lookup
+- **Atomaste Report Standard** → Professional PDF generation
+
+## Project Status
+
+🚧 **Phase 1: Core Pipeline (MVP)** — In Progress
+
+See [ROADMAP.md](ROADMAP.md) for full implementation plan.
+
+## License
+
+MIT