Implements features, fixes bugs, and refactors code following TDD workflow. Triggers: implement, create, fix, modify, add, refactor, build, develop, change functionality. Covers: components, stores, schemas, utilities, styling, docs/ and project-config.md synchronization. Takes optional argument: /implementing-features <task-file or instruction>
プロジェクトの開発標準に従い、TDDで機能実装・バグ修正・リファクタリングを行う。
CLAUDE.md の方針を厳守すること。プロジェクト固有のコードパターンは docs/development-patterns.md を参照。
| 参照ファイル | 用途 | スタブ時のフォールバック |
|---|---|---|
docs/project.md | コマンド・技術スタック | project-config.md §1〜§3 を直接参照 |
docs/architecture.md | ディレクトリ構成・テスト配置 | project-config.md §4 を直接参照 |
docs/data-model.md | スキーマ定義 | コードベースの Zod スキーマを直接読み取る |
docs/development-patterns.md | コード規約・落とし穴 | project-config.md §2, §11 を直接参照 |
このスキルは docs/ ファイルの生成・更新も担う。スタブの場合は実行後に自動生成する。
/implementing-features <タスクファイル or 実装指示>
引数は省略可能。省略した場合はユーザーに対話的に確認する。 タスクファイルを指定した場合はその内容を読み取り、要件と受け入れ基準を把握する。
/implementing-features ユーザー認証機能を追加する
/implementing-features output/tasks/TASK_auth.md
/implementing-features .claude/tasks/TASK_001.md
src/ 配下(プロジェクトのディレクトリ構成に従う)__tests__/ ディレクトリtestreport/coverage/| 前工程 | 本スキル | 後工程 |
|---|---|---|
/plan /architecture | /implementing-features | /code-review /e2e-testing |
以下の原則に従う。プロジェクト固有の適用については docs/development-patterns.md を参照。
docs/project.md 参照)で正常系・異常系・境界値を書くdocs/project.md 参照)を実行docs/ と project-config.md を更新| フィールド | 型 | 必須 | 制約 |
|---|---|---|---|
| 要件解釈 | 箇条書き | ✅ | 受け入れ基準を1件1行で列挙 |
| 影響ファイル | テーブル(ファイル, 変更種別) | ✅ | 変更種別 ∈ {追加, 変更, 削除} |
| テスト方針 | 箇条書き | ✅ | テスト対象と期待動作を明記 |
| 【仮定】事項 | 箇条書き | 条件付き | 仕様が曖昧な場合のみ |
| フィールド | 型 | 必須 | 制約 |
|---|---|---|---|
| テスト結果 | X pass / Y fail | ✅ | 数値のみ。失敗時は原因を1行で付記 |
| カバレッジ | 行: X% / 分岐: Y% | ✅ | 目標との差分を明記 |
| 静的解析 | エラー: X件 / 警告: Y件 | ✅ | 0件でも明記 |
| 依存方向 | 違反: X件 | 条件付き | 依存方向チェックが有効な場合 |
| 変更ファイル数 | 整数 | ✅ |
実装チェックリスト(CLAUDE.md定義)の全項目を [x] / [ ] で提示する。
| 用語 | 定義 |
|---|---|
| 【仮定】 | 仕様に明記されていない前提条件 |
| pass / fail | テスト結果の状態 |
| 違反 | 依存方向ルールへの抵触 |
| 後方互換 | 既存データの読み込みが壊れないこと |
describe / it の説明文を日本語で記述docs/architecture.md 参照)に従うdocs/development-patterns.md 参照)に従うproject-config.md の定義に従う実装変更後、影響を受ける docs/ ファイルと project-config.md を更新する。
ドキュメントの正確性は実装と同等の品質基準で扱う。
| 変更内容 | 更新対象 |
|---|---|
| ルート追加・変更・削除 | docs/project.md |
| ストア追加・変更・削除 | docs/project.md |
| npmスクリプト追加・変更 | docs/project.md |
| 依存パッケージ追加・バージョン変更 | docs/project.md |
| feature追加・削除・リネーム | docs/architecture.md |
| コンポーネント追加・削除 | docs/architecture.md |
| テストファイル追加・削除 | docs/architecture.md |
| 共有レイヤー変更 | docs/architecture.md |
| コードパターン・落とし穴の発見/変更 | docs/development-patterns.md |
| スキーマのフィールド追加・変更 | docs/data-model.md |
| バリデーションルール変更 | docs/data-model.md |
| フォームスキーマ追加・変更 | docs/data-model.md |
| 変更内容 | 更新対象セクション |
|---|---|
| 新しい落とし穴・アンチパターンの発見 | §11(既知の落とし穴) |
| 依存パッケージの追加・バージョン変更 | §2(技術スタック) |
| npmスクリプトの追加・変更 | §3(コマンド) |
project-config.md セクション6 に定義describe / it の説明文は振る舞いを明記testreport/coverage/ に出力し、結果を提示するテスト実行時はカバレッジレポートを testreport/coverage/ に出力する。
出力先の設定例(project-config.md §3 のテストフレームワークに合わせて設定):
# Vitest の場合
# vite.config.ts の test.coverage に以下を設定:
# reportsDirectory: 'testreport/coverage'
# Jest の場合
# jest.config.ts に以下を設定:
# coverageDirectory: 'testreport/coverage'
実装完了時に依存方向チェックコマンド(project-config.md セクション4.4 に記載)を実行し、
依存方向ルールに違反していないことを確認する。
--no-verify は使用禁止(pre-commit / pre-pushフックを迂回しない)--force は原則禁止--no-verify によるフック迂回docs/development-patterns.md に記載されたアンチパターンの使用