ci: complete release automation and development standards

- publish.yml: now runs full test suite before publishing, creates
  GitHub Release with auto-generated notes and build artifacts
- CLAUDE.md: comprehensive rewrite with 12 numbered sections covering
  all development practices from daily workflow to release process.
  This is the single source of truth for any developer or LLM.

Sections: project overview, architecture, git workflow, coding standards,
testing, commit convention, code review, versioning, release process,
one-time setup, commands reference, known limitations.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: quantbai

.github/workflows/publish.yml

@@ -1,15 +1,31 @@
-name: Publish to PyPI
+name: Release and Publish
 
 on:
   push:
     tags:
       - "v*"
 
 jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: ruff check elvers/
+      - run: pytest tests/ -v
+
   publish:
+    needs: test
     runs-on: ubuntu-latest
     permissions:
       id-token: write
+      contents: write
     steps:
       - uses: actions/checkout@v4
 
@@ -25,3 +41,9 @@ jobs:
 
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: dist/*