| name | collidoscope-repository-context |
| description | Open Collidoscope Web リポジトリの構造、技術スタック、参照ドキュメントを提示する。リポジトリ全体の把握、オンボーディング、どこを編集すべきかの判断が必要なときに使う。 |
Open Collidoscope Web Repository Context
When to use
- リポジトリ全体像（構造、技術スタック）を短時間で把握したいとき
- 変更対象の配置先を判断したいとき
- 参照すべき主要ドキュメントを確認したいとき
Quick context
- プロダクト: Open Collidoscope の Web ブラウザ移植版
- 主な技術: React 19 / TypeScript 6 / Vite 8 / MUI 9 / Zustand / Web Audio API / Biome 2.5 / Vitest 4 / pnpm 11
- Vite の
root は src/（テストも src/ 配下の *.test.ts(x) を想定）
- オリジナル C++ コード:
opencollidoscope/（参照用、Mercurial クローン）
- 未整備・意図的な選択:
docs/web-spec.md の「開発環境の意図的な選択と未整備」
- テスト:
src/**/*.test.{ts,tsx} をコロケーション。セットアップは src/test/setup.ts、UI は renderWithTheme
ディレクトリ構成
src/
├── features/ # 機能ディレクトリ（synth-engine 等）
│ └── synth-engine/
├── components/ # 汎用 UI コンポーネント
├── stores/ # グローバル Zustand ストア（AudioStore, ConfigStore 等）
├── consts/ # ドメイン定数
├── domain/ # ドメインロジック
├── utils/ # ユーティリティ
├── App.tsx
├── main.tsx
└── index.html
opencollidoscope/ # オリジナル C++ ソース（参照用）
.serena/memories/ # 長期知識（Serena MCP）
.cursor/rules/ # Cursor ルール
.cursor/skills/ # Cursor Skills
主要ドキュメント
索引（管轄・正本の一覧）: docs/README.md
docs/ui-mapping.md — 電子的対応・物理形状・Web 実装ギャップ（正本）docs/layout-specs/ — 画面上の配置正本（<variant>/layout.html、kebab-case + -a/-b ゾーン接尾辞。SLOT_* は Web 層）docs/hardware-layout.md — 座標系・資料索引・配置暫定図docs/original-analysis.md — オリジナル C++ 実装の分析（処理式・Teensy）docs/web-spec.md — Web版実装仕様（マイルストーン・機能要件）docs/web-design.md — Web版設計書（アーキテクチャ、Mermaid 図）Scratchpad.md — 短期タスクログ.serena/memories/ — 長期知識（アーキテクチャ分析、コーディング規約等）
実装フェーズ
- Phase 1: マイルストーン M1 → M4（
docs/web-spec.md）
- Phase 2: 第2音声処理システム（
NUM_WAVES=2）
ディレクトリ構成（実装時）
src/
├── features/synth-engine/ # メイン機能（worklets, components）
├── stores/ # audio, wave, config, ui（M1）, synth（M2）
├── domain/config/ # 実装済み
├── domain/audio/ # M1〜
└── components/ # 汎用 UI のみ
