Zig

# プロジェクト名

Zig で構築されたシステムプログラミングプロジェクト。

## 技術スタック

- **言語**: Zig 0.13+
- **ビルド**: zig build (build.zig)
- **Cインターフェース**: シームレスなC ABI互換
- **テスト**: zig test（組み込みテストランナー）

## コマンド

| コマンド | 用途 |
|---------|------|
| `zig build run` | ビルド・実行 |
| `zig build test` | テスト実行 |
| `zig build` | ビルドのみ |
| `zig fmt src/` | フォーマット |

## ディレクトリ構造

| パス | 役割 |
|-----|------|
| `src/main.zig` | エントリーポイント |
| `src/lib/` | ライブラリコード |
| `build.zig` | ビルド設定 |
| `build.zig.zon` | パッケージ依存関係 |
| `tests/` | テストコード |

## コーディング規約

- Zigスタイルガイドに準拠
- `comptime` でコンパイル時計算を活用
- エラーユニオンでエラー処理（`try` / `catch`）
- アロケータを明示的に渡す（暗黙のアロケーション禁止）
- `defer` / `errdefer` でリソース管理
- C interop時はラッパー関数でZig型に変換

## Git規約

- ブランチ: `feature/`, `fix/`, `chore/`
- コミットメッセージ: Conventional Commits形式