docs: 仕様書5本追加 + .claude/→docs/移行 + バグ修正4件

- docs/: overview, features, user-guide, platforms, roadmap 新規 + todo, wasm-progress を.claude/から移行
- fix: 異名同音判定(C#=Db), aug7の#5二重追加, getInterval未定義ルート, scaleText undefined

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

Author: kako-jun

docs/features.md

@@ -0,0 +1,71 @@
+# 機能一覧
+
+## 運指記譜
+
+音符ごとに左手（押弦）と右手（ピッキング）の情報を記録できる。
+
+**左手の記録項目:**
+- 指番号（1〜4）
+- 弦番号（1〜4弦）
+- フレット番号（0〜24フレット）
+- 種別（通常押弦 / ミュート / ゴーストノート / コード一括）
+- ピッチ（例: A2, C＃3）
+- 音程（例: 1, ♭3, 5, ♭7）
+
+**右手の記録項目:**
+- 弦番号
+- ストロークの向き（ダウン / アップ / サムピック）
+- ミュートする弦の一覧
+
+## コード分解
+
+コード名（例: Cmaj7, Am, G7）を入力すると、4弦ベース上のすべての弦・フレットの組み合わせを自動計算して表示する。
+
+ルート音から半音インデックスを使って各構成音のフレット位置を求め、弦ごとのポジションに変換する。
+
+**対応するコードタイプ:**
+- メジャー / マイナー / ディミニッシュ / オーギュメント
+- sus4
+- メジャー7 / ドミナント7 / マイナー7 / オーギュメント7
+- パワーコード（5th）
+- オクターブユニゾン（8）
+- ALL_KEYS（全12半音）/ WHITE_KEYS（白鍵のみ）
+
+## スケール表示
+
+キー（調）を指定すると以下の情報を表示する：
+
+- スケール構成音（全24キー対応：メジャー12キー＋マイナー12キー）
+- ダイアトニックコード（トライアド）
+- ダイアトニックコード（7th）
+- 五度圏上の位置（外円＝メジャーキー、内円＝マイナーキー）
+
+## 和声分析
+
+コードとキーを指定すると以下を表示する：
+
+- 機能和声のディグリー（Ⅰ〜Ⅶ）
+- 各ディグリーの説明（例: Ⅴ Dominant — 緊張・推進）
+- ローマ数字表記（トライアド：Ⅰ / Ⅱm / Ⅶdim など）
+- 7thコードのローマ数字表記（ⅠM7 / Ⅱm7 / Ⅶm7♭5 など）
+- カデンツの種類（完全終止 / 変格終止 / 偽終止 / 半終止 / フリジアン終止）
+- 各音のコードトーンラベル（例: Tonic Note, Dominant Note）
+
+## 異名同音の正規化
+
+C＃ と D♭ のように表記は異なるが音高が同じ音を正しく同一視する。
+
+Rust 実装では半音インデックスで比較するため、正確に判定できる。
+TypeScript 実装は文字列比較のため、この判定に既知のバグがある（詳細は `docs/todo.md` 参照）。
+
+## WASM 高速化（準備中）
+
+音楽理論計算のロジックを Rust で実装し、WebAssembly としてビルドする準備が整っている。
+
+Phase 3 時点で Rust 側のすべての関数（26関数）の実装とテストが完了している。
+Phase 4（Next.js からの WASM 呼び出し）は保留中。
+
+Rust 実装の主な利点：
+- 半音インデックスによる正確な異名同音判定
+- コンパイル時の型検証
+- 将来的な npm パッケージとしての切り出し

docs/overview.md

@@ -0,0 +1,43 @@
+# sid-note とは何か
+
+## 動機
+
+ベースを弾くとき、楽譜やTAB譜だけでは「どの指でどの弦を押さえるか」が直感的に伝わらない。
+
+TAB譜は弦番号とフレット番号を示せるが、音楽理論との接点がない。
+五線譜は音の高さと長さを正確に表せるが、指板上の位置は奏者に委ねられる。
+
+sid-note はこの溝を埋めるために作られた。**「ベースの運指を直感的に記譜したい」**という一点から出発している。
+
+## 何ができるのか
+
+1 音符ごとに、以下の情報をまとめて扱う：
+
+- 音高（ピッチ）と音価（全音符・四分音符・八分音符など）
+- 弦番号とフレット番号（左手の指板位置）
+- ピッキングの向きと弦（右手の動き）
+- そのコードにおける音程（ルート・3度・5度・7度）
+- 機能和声（Ⅰ・Ⅱ・Ⅲ・Ⅳ・Ⅴ・Ⅵ・Ⅶ）とカデンツ
+
+## TAB譜との違い
+
+| 観点 | TAB譜 | sid-note |
+|------|-------|----------|
+| 指板位置 | あり | あり |
+| 音楽理論との結びつき | なし | あり（コード・スケール・機能和声） |
+| 音高の明示 | なし（フレットから推定） | あり |
+| ピッキング情報 | なし | あり |
+| 複数のポジション候補 | 手動で選択 | 自動計算で提示 |
+
+## アーキテクチャの方針
+
+- UI は Next.js / React で構成する
+- 音楽理論の計算ロジックは TypeScript で実装済み。将来的に Rust/WASM へ移行して高速化する
+- データはトラック単位の YAML ファイルで管理する（Zod でスキーマ検証）
+- Cloudflare Pages または Docker でホスティングできる
+
+## 現在の状態
+
+Phase 3（TypeScript 実装 + Rust への移植 + テスト）まで完了。
+Phase 4（WASM 統合）は保留中。
+TypeScript 実装で動作するアプリとして公開済み。

docs/platforms.md

@@ -0,0 +1,59 @@
+# 動作環境とデプロイ
+
+## ブラウザ
+
+モダンブラウザであれば動作する。
+Canvas API を使用しているため、IE などのレガシーブラウザは非対応。
+
+Windows 環境では線の太さを自動調整する処理が含まれている（`navigator.userAgent` で判定）。
+
+## ローカル開発
+
+```bash
+npm install
+npm run dev
+```
+
+`http://localhost:3000` で開発サーバーが起動する。
+
+テストの実行：
+
+```bash
+# TypeScript テスト（Jest）
+npm test
+
+# Rust テスト
+cd rust-music && cargo test
+```
+
+## Cloudflare Pages
+
+Next.js の静的エクスポートまたは Edge Runtime を使って Cloudflare Pages にデプロイできる。
+
+`next.config.ts` で設定を確認すること。
+
+## Docker
+
+`Dockerfile` と `compose.yaml` が同梱されている。
+
+```bash
+# イメージのビルドと起動
+docker compose up --build
+```
+
+コンテナ内で Next.js の本番ビルドが実行される。
+
+## WASM ビルド（Phase 4 以降）
+
+Rust 製の音楽理論ライブラリを WASM としてビルドするには `wasm-pack` が必要：
+
+```bash
+# wasm-pack のインストール
+curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
+
+# WASM ビルド
+cd rust-music
+wasm-pack build --target web --out-dir pkg
+```
+
+ビルド後の `pkg/` ディレクトリを Next.js から参照する形で統合する予定。

docs/roadmap.md

@@ -0,0 +1,79 @@
+# ロードマップ
+
+## 現在の状態
+
+Phase 3 完了（2025-11-16 時点）。
+
+| フェーズ | 内容 | 状態 |
+|---------|------|------|
+| Phase 1 | Rust プロジェクト基盤構築 | 完了 |
+| Phase 2 | 音楽理論 26 関数を Rust に移植 | 完了 |
+| Phase 3 | TypeScript テスト 34 個・Rust テスト 21 個の作成とデグレチェック | 完了 |
+| Phase 4 | WASM 統合（Next.js から Rust 関数を呼び出す） | 保留中 |
+| Phase 5 | WASM バンドルサイズ最適化・並列処理 | 未着手 |
+| Phase 6 | 音楽理論ライブラリの独立 npm パッケージ化 | 未着手 |
+
+---
+
+## Phase 4: WASM 統合
+
+**優先度: 高**
+
+1. `wasm-pack` でビルドして `pkg/` ディレクトリを生成する
+2. `src/lib/wasm-init.ts` を作成して初期化処理を一元管理する
+3. まず `Keyboard.tsx` など 1 コンポーネントで試験統合する
+4. TypeScript 実装から段階的に置き換えていく
+5. 置き換え前後でパフォーマンス測定を行う
+
+---
+
+## 6 弦対応・ギター対応
+
+現在は 4 弦ベース（標準チューニング E1-A1-D2-G2）のみ対応。
+
+**拡張候補:**
+- 5 弦ベース（B0 弦を追加）
+- 6 弦ギター（E2-A2-D3-G3-B3-E4）
+- ウクレレ（G4-C4-E4-A4）
+- カスタムチューニング（ユーザー定義）
+
+`convertFretsToPositions()` の弦判定ロジックを楽器定義として抽象化することで対応できる。
+
+---
+
+## npm パッケージとしての切り出し
+
+Rust 製音楽理論ライブラリ（`rust-music/`）を独立した npm パッケージとして公開する。
+
+**想定する手順:**
+1. `git subtree split` で `rust-music/` を独立リポジトリに分離
+2. WASM ビルドの CI/CD を構築（GitHub Actions）
+3. `kordweb` のように npm レジストリに公開
+4. sid-note 本体はこのパッケージに依存する形に変更
+
+**意義:**
+- ベースやギターの音楽理論アプリを作る他の開発者が利用できる
+- 日本語表記（全角 ＃・♭）や機能和声・カデンツ判定など、sid-note 固有の要件が汎用ライブラリとして活用できる
+
+---
+
+## モードスケール対応
+
+現在はメジャー・ナチュラルマイナーのみ対応。
+
+追加候補：
+- ドリアン / フリジアン / リディアン / ミクソリディアン / エオリアン / ロクリアン
+- メロディックマイナー / ハーモニックマイナー
+- テンションノート（9th, 11th, 13th）の表示
+- 代理コードの提案
+
+---
+
+## UI/UX 改善
+
+- レスポンシブデザインの改善（モバイル対応）
+- ダークモード
+- キーボードショートカット
+- コード進行の音声再生（Web Audio API）
+- MIDI ファイルのインポート
+- Progressive Web App（オフライン対応）

.claude/TODO.md docs/todo.md.claude/TODO.md renamed to docs/todo.md

@@ -0,0 +1,104 @@
+# 使い方ガイド
+
+## トラックの作成
+
+トラックは YAML ファイルとして `public/` 以下に配置する。
+`track.schema.json` に従ってデータを記述する。
+
+**基本構造:**
+```yaml
+title: "曲名"
+artist: "アーティスト名"
+album: "アルバム名"
+year: 2024
+key: "Am"
+timeSignature: "4/4"
+bpm: 120
+sections:
+  - name: "イントロ"
+    chordSegments:
+      - chord: "Am"
+        notes:
+          - ...
+```
+
+**必須フィールド:**
+- `title`, `artist`, `album`, `year` — 楽曲の基本情報
+- `key` — 調（例: `C`, `Am`, `G＃`, `B♭m`）
+- `timeSignature` — 拍子（`2/4` / `3/4` / `4/4`）
+- `bpm` — テンポ
+- `sections` — セクション（イントロ・Aメロ・サビなど）の配列
+
+## ノート入力
+
+各ノートは `NoteSchema` に従って記述する。
+
+**音符の記述例:**
+```yaml
+notes:
+  - pitch: "A2"
+    value: "quarter"
+    lefts:
+      - finger: 2
+        string: 1
+        fret: 5
+        type: "press"
+        pitch: "A2"
+        interval: "1"
+    right:
+      string: 1
+      stroke: "down"
+      muteStrings: []
+```
+
+**音価の種類:**
+| 値 | 意味 |
+|----|------|
+| `whole` | 全音符 |
+| `half` | 二分音符 |
+| `quarter` | 四分音符 |
+| `8th` | 八分音符 |
+| `16th` | 十六分音符 |
+| `dotted_*` | 付点（例: `dotted_quarter`） |
+| `triplet_*` | 三連符（例: `triplet_8th`） |
+
+**ピッチの書き方:**
+- アルファベット + 臨時記号 + オクターブ番号（例: `C＃3`, `B♭2`）
+- シャープは全角 `＃`、フラットは半角 `♭` を使う
+- 対応範囲: E1〜G4
+
+## 表示の見方
+
+**鍵盤ビュー（Keyboard）:**
+- 横軸がピッチ（E1 左端〜G4 右端）
+- 現在の音符を白い円で表示
+- 次の音符をシアンの発光円で表示
+
+**五線譜ビュー（Staff）:**
+- 縦軸がピッチ（下から上に音が高くなる）
+- ベース音域（低音部譜表相当）を3段に分けて表示
+- 臨時記号（＃・♭）は円の左側に表示
+
+**五度圏ビュー（CircleOfFifths）:**
+- 外円がメジャーキー、内円がマイナーキー
+- 現在のキーを白い円でハイライト
+
+**ダイアトニックコード表（DiatonicChordTable）:**
+- 現在のキーに対するⅠ〜Ⅶのコードを一覧表示
+- 現在演奏中のコードがハイライトされる
+
+## 再生
+
+開発サーバーを起動してブラウザで確認する：
+
+```bash
+npm run dev
+```
+
+`http://localhost:3000` を開くと楽曲一覧が表示される。
+楽曲を選択するとセクション・コード・ノートを順に表示できる。
+
+## エクスポート
+
+現時点では明示的なエクスポート機能はない。
+五度圏の画像は `getCircleOfFifthsImage(scale)` を呼ぶことでデータ URL（PNG）として取得できる。

docs/user-guide.md

@@ -222,6 +222,7 @@ export const getChordPositions = (chord: string) => {
       }
 
       if (f.interval === "5") {
+        if (isAug7) return { ...f, interval: "＃5", fret: 8 };
         if (isAug) return { ...f, interval: "＃5", fret: 8 };
         if (isDim) return { ...f, interval: "♭5", fret: 6 };
         return f;
@@ -232,7 +233,6 @@ export const getChordPositions = (chord: string) => {
 
     // 7th
     if (isAug7) {
-      baseFrets.push({ interval: "＃5", fret: 8 });
       baseFrets.push({ interval: "♭7", fret: 10 });
     } else if (isMaj7) {
       baseFrets.push({ interval: "7", fret: 11 });
@@ -288,10 +288,13 @@ export const getInterval = (chord: string, targetPitch: string) => {
   const targetName = targetPitch.replace(/\d+$/, "");
   const root = getRootNote(chord);
   const pitches = pitchMap[root];
+  // ルート音がpitchMapにない場合はフォールバック
+  if (!pitches) return "";
   const index = pitches.findIndex((pitch) => {
     const names = pitch.split("/").map((p) => p.replace(/\d+$/, ""));
     return names.includes(targetName);
   });
+  if (index === -1) return "";
   const intervalMap: { [key: number]: string } = {
     0: "1",
     1: "♭2",
@@ -306,6 +309,5 @@ export const getInterval = (chord: string, targetPitch: string) => {
     10: "♭7",
     11: "7",
   };
-  const interval = intervalMap[index] || "";
-  return interval;
+  return intervalMap[index] ?? "";
 };