Coding Guideline
この skill は github-actions-search の実装判断に使う。構文レベルのルールはできるだけ oxlint.config.ts と tsconfig.json に寄せ、ここには設計判断を書く。
Project Shape
- Preact + Vite +
vite-plugin-web-extensionの Chrome extension。 - Runtime entrypoint は
src/content/index.ts。 - GitHub Actions tab の DOM に content script から UI を注入する。
- GitHub API / browser extension storage / DOM は外部境界として扱う。
Type-Driven Correctness
- 状態や分岐は discriminated union で表現し、不正状態を型で作れない形に寄せる。
- 外部データは
valibotschema などで validation してから使用する。 any、non-null assertion、根拠のない type assertion は避ける。- 設定 object は必要に応じて
as const satisfiesで literal type と構造制約を両立する。
Boundary Separation
src/content/repository/は GitHub からデータを取得する境界層。src/content/util/local-storage.tsxは browser extension storage の境界層。- UI component は repository / storage の詳細を直接知らない形にする。
- hook は UI state の composition を担当し、I/O の詳細は boundary module に閉じ込める。
Testing
- Unit tests は対象 source の近くに
*.test.ts/*.test.tsxとして置く。 - GitHub API response、storage data、URL / DOM 由来の値は正常系だけでなく不正・空・失敗ケースも検証する。
- Extension としての表示差分は
pnpm build後にpnpm vrtで確認する。
UI / Preact
- 既存 component style と shadcn-ui 由来の構造を尊重する。
- state は最小限にし、render 中に計算できる派生値は state にしない。
- effect は DOM / browser API / external system との同期に限定する。