feat: update project structure and docs

scripts/post-commit

@@ -0,0 +1,18 @@
+#!/bin/bash
+# Post-commit hook: Update README.md automatically
+
+set -e
+
+echo "Updating README.md..."
+
+# Run README update script
+uv run python scripts/update_readme.py
+
+# Check if README changed
+if ! git diff --quiet README.md; then
+    echo "✓ README.md was updated"
+    echo "  Review changes and commit if needed:"
+    echo "  git add README.md && git commit -m 'docs: update README [skip ci]'"
+else
+    echo "✓ README.md is up to date"
+fi