feat: update project structure and docs

.gitignore

@@ -0,0 +1,51 @@
+# MkDocs output
+site/
+
+# Python cache (ignore all)
+__pycache__/
+*.py[cod]
+*$py.class
+*.pyc
+*.pyo
+
+# opencode skills (agent-only)
+.opencode/
+AGENTS.md
+
+# Scripts (except hooks)
+scripts/*
+!scripts/commit-msg
+!scripts/post-commit
+!scripts/update_readme.py
+!scripts/clean_cache.sh
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# mypy
+.mypy_cache/
+
+# ruff
+.ruff_cache/
+
+# Environment
+.env
+.env.example
+.venv/
+venv/
+
+# uv cache
+.uv/
+
+# Scripts cache
+scripts/__pycache__/
+