# CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## Project Overview
**sabiql** is a fast, driver-less TUI for browsing and editing PostgreSQL databases.
- **Tech Stack**: Rust + Ratatui + Tokio
- **Target DB**: PostgreSQL (MVP), MySQL (future)
- **No DB Driver Required**: Uses `psql`/`mysql` CLI for queries (driver-less architecture)
## Setup
```bash
mise install # Install tools (Rust, lefthook, etc.)
mise exec -- lefthook install # Set up Git hooks (runs cargo fmt on commit)
```
## Build Commands
```bash
mise run build # Build
mise run clippy # Lint
mise run fmt # Format
mise run test # Run tests
```
## Configuration
- Connection config: `~/.config/sabiql/connections.toml`
- Cache directory: `~/.cache/sabiql/<project>/`
## Rules and Skills
Rules（`.claude/rules/`）は `paths` フロントマターのパターンに基づき**自動ロード**される。
Skills（`.claude/skills/`）は手動で `/skill-name` で呼び出す。
### Available Rules
**全体（`**/src/**/*.rs`）:**
| **architecture** | ヘキサゴナルアーキテクチャ、レイヤ依存、Ports & Adapters、副作用境界 |
| **rust-testing-style** | テスト命名、構造、given/when/then |
| **testing-obligations** | レイヤ別必須テスト、`#[ignore]` トラッキング |
**レイヤ・パス限定**（対象パスは概要。正確な glob は各ルールの frontmatter を参照）**:**
| **app-state** | `app/state.rs`, `app/reducers/**` | 派生状態パターン、State/View分離 |
| **postgres-adapter** | `infra/adapters/postgres/**` | Adapter内部構造、data flow、可視性 |
| **rendering-strategy** | `app/render_schedule.rs`, `main.rs` | イベント駆動レンダリング、トリガー表 |
| **ui-design** | `src/ui/**` | Atomic Design、フッター順序、テキスト入力 |
| **interaction-contract** | keybindings, handler, footer, help, palette | SSOT整合性、キー変換フロー、チェックリスト |
| **db-agnostic** | `app/ports/**`, `infra/adapters/**` | Port中立性、Adapter分離、MySQL準備 |
| **config-migration** | config_writer, connection_store | 後方互換スキーマ変更 |
| **rstest-patterns** | `domain/**`, `infra/**/parser*`, `infra/**/sql/**` | rstest凝集度、境界値パターン |
| **test-organization** | `app/**`, `ui/event/**` | mod構造、フィクスチャ抽出 |
| **visual-regression** | `tests/render_snapshots.rs`, `tests/snapshots/**` | instaスナップショット、モードカバレッジ |
| **effect-runner** | `app/effect_runner.rs`, `app/effect_handlers/**`, `app/effect.rs` | Dispatcher パターン、依存注入、新 Effect 追加手順 |
| **reducer-structure** | `app/reducer.rs`, `app/reducers/**` | Reducer feature 分割、Dispatcher パターン、passthrough、新 Action / ConfirmIntent 追加手順 |
| **rollback-policy** | `infra/**/parser.rs` | command tag 集約の rollback 近似方針、false-positive-over-missed |
| **command-tag-design** | `domain/command_tag.rs` | 単一 enum での display/refresh 兼用根拠、variant 追加チェックリスト |
### Available Skills
| **release** | Manual | バージョンバンプ、タグ作成、GitHub リリース |