init claude

Author: patryk4815

CLAUDE.md

@@ -0,0 +1,32 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+This repo packages Capstone 6.0.0-Alpha6 as a Python package named `capstone6pwndbg` (renamed from the upstream `capstone` to avoid conflicts), intended for use by the [pwndbg](https://github.com/pwndbg/pwndbg) debugger.
+
+The actual Capstone source lives in the `capstone/` git submodule — do not modify it directly. The only root-level files that matter here are:
+- `python-rename.patch` — renames the Python package from `capstone` to `capstone6pwndbg` in the submodule's `setup.py`
+- `.github/workflows/publish.yml` — builds and publishes wheels to PyPI
+
+## Build
+
+```bash
+git submodule update --init --recursive
+cd ./capstone && git apply ../python-rename.patch && cd ..
+uv build --out-dir dist ./capstone/bindings/python
+```
+
+## CI / Release
+
+Releases are triggered by pushing a `v*` tag. The workflow (`.github/workflows/publish.yml`) uses `cibuildwheel 3.3.1` to build binary wheels for Linux (x86_64, aarch64), macOS (x86_64, arm64), and publishes via `twine` with PyPI trusted publishing (OIDC). A separate `sdist` job builds and publishes a source distribution.
+
+## Architecture
+
+This repo has no source code of its own. Its only purpose is:
+1. Pin the `capstone` submodule to a specific version.
+2. Apply `python-rename.patch` to rename the published package.
+3. Drive CI to build and publish wheels to PyPI.
+
+When updating the pinned Capstone version: update the submodule ref, verify the patch still applies cleanly, then push a new `v*` tag to trigger the release workflow.