Steering ドキュメント更新

プロジェクトの現状を確認し、steering ドキュメントを最新化します。

対象ドキュメント

手順

1. 現状把握

プロジェクトの実態を確認:

# パッケージ構成
ls packages/

# 各パッケージの src 構成
ls packages/*/src/

# package.json のスクリプト
cat package.json | jq '.scripts'

1.5. GitHub イシュー確認

GitHub イシューを確認し、未対応の課題や進行中のタスクを把握:

• •mcp__github__list_issues でオープンイシューを取得
• •機能追加・バグ修正・改善などのラベルで分類
• •plan.md のセグメントと関連するイシューを特定

確認ポイント:

• •オープンイシューに対応する plan.md のタスクがあるか
• •イシューがクローズ済みだが plan.md で完了としてマークされていないタスク
• •イシューで議論された仕様変更が product.md に反映されているか

2. ドキュメント読み込み

各ドキュメントを読み込み、現状と比較:

• •未作成と書かれているが作成済みのもの
• •存在すると書かれているが実際にないもの
• •完了状態が実態と異なるもの
• •コマンドが存在しない/変更されているもの

3. 陳腐化箇所の特定

ユーザーに以下の形式で報告:

## 陳腐化箇所

| ファイル | 箇所 | 現状 | ドキュメント記載 |
|---------|------|------|-----------------|
| tech.md | shared パッケージ | 作成済み | 「未作成」 |
| structure.md | client/shared/ | 存在しない | 記載あり |
| plan.md | 認証機能 | Issue #42 はクローズ済み | 「進行中」 |

4. ユーザー確認

修正内容を提示し、承認を得る:

• •修正する項目一覧
• •修正しない項目があればその理由

5. 修正実行

承認後、各ファイルを編集:

• •事実に基づく修正のみ行う
• •推測で情報を追加しない
• •将来の予定は現状のままにする

6. コミット

git add README.md .ai-agent/
git commit -m "Update steering documents to reflect current project state"

確認ポイント

README.md

• •プロダクトの概要・コンセプトが伝わりやすいものになっているか
• •技術スタックが最新か
• •セットアップ手順が動作するか

tech.md

• •パッケージ状態（セットアップ済み/未作成）
• •開発コマンドが存在するか
• •バージョン情報が正しいか

plan.md

• •セグメントの状態（完了/進行中/未着手）
• •実装順序が現状を反映しているか

structure.md

• •ディレクトリ構成が実態と一致するか
• •各ディレクトリの説明が正確か

GitHub イシューとの整合性

• •オープンイシューが plan.md に反映されているか
• •完了済みタスクに対応するイシューがクローズされているか
• •機能要求イシューが product.md の機能一覧と整合しているか

注意事項

• •product.md は機能仕様なので、実装状態ではなく設計意図として扱う
• •work.md は作業フローなので、変更は慎重に
• •将来実装予定の記載は削除しない（plan.md で状態管理）