Initial commit: VoIdeaAI - voice-first AI idea assistant

docs/instructions/01-developer.md

@@ -0,0 +1,105 @@
+# Developer Instructions - VoIdea
+
+**Date:** 2026-05-10
+
+---
+
+## Prerequisites
+
+1. Python 3.12+
+2. PostgreSQL (local)
+3. Redis (optional for local dev)
+
+---
+
+## Setup
+
+`ash
+# 1. Clone repository
+git clone <repo>
+cd voidea
+
+# 2. Create venv
+python -m venv venv
+source venv/Scripts/activate  # Windows
+
+# 3. Install dependencies
+pip install -r requirements.txt
+
+# 4. Configure environment
+cp .env.example .env
+# Edit .env with your values
+
+# 5. Database setup
+alembic upgrade head
+
+# 6. Run application
+uvicorn app.main:app --reload --port 8020
+`
+
+---
+
+## Key Commands
+
+`ash
+# Lint
+ruff check .
+
+# Format
+ruff format .
+
+# Type check
+mypy .
+
+# Tests
+pytest
+
+# With coverage
+pytest --cov=app tests/
+
+# Run specific test
+pytest tests/unit/test_core.py -v
+`
+
+---
+
+## Project Structure
+
+- pp/ - Application code
+- docs/ - Documentation
+- 	ests/ - Tests
+
+---
+
+## Naming Conventions
+
+- Variables/Functions: snake_case
+- Classes: PascalCase
+- Constants: UPPER_SNAKE_CASE
+- Files: snake_case.py
+
+---
+
+## Adding New Feature
+
+1. Create feature branch: git checkout -b feature/description
+2. Implement code
+3. Write tests
+4. Update documentation
+5. Create PR
+6. After approval: merge to develop, then main
+
+---
+
+## Rules
+
+1. Always read 00-rules.md first
+2. Follow code style (ruff, mypy)
+3. Write docstrings
+4. Update docs on changes
+5. Tests required
+6. No secrets in code
+
+---
+
+*Updated: 2026-05-10*