Beitragen¶

Voraussetzungen¶

Python 3.11+
uv-Paketmanager
Git

Lokale Entwicklung¶

# Clone the repository
git clone https://github.com/Zts0hg/codexspec.git
cd codexspec

# Install development dependencies
uv sync --extra dev

# Run locally
uv run codexspec --help

# Run tests
uv run pytest

# Lint code
uv run ruff check src/

Dokumentation¶

# Install docs dependencies
uv sync --extra dev --extra docs

# Preview documentation locally
uv run mkdocs serve

# Build documentation
uv run mkdocs build --strict

Bauen¶

uv build

Pull-Request-Prozess¶

Repository forken
Feature-Branch anlegen
Änderungen vornehmen
Tests und Linting ausführen
Pull-Request einreichen

Code-Stil¶

Zeilenlänge: maximal 120 Zeichen
PEP 8 befolgen
Type-Hints für öffentliche Funktionen verwenden

Lesen Sie CLAUDE.md, AGENTS.md und Repository-Struktur, bevor Sie Vorlagen, Paketierung oder Initialisierung ändern. Ausgelieferte Kopien von Befehlen und Skills sind generierte Installationsartefakte. Bearbeiten Sie ihre maßgeblichen Quellen und erzeugen Sie die Kopien erneut.