cs-build-resync-codebase

CodeSpring をコードベースと再同期する

機能を実装しても、当初の計画どおりになることはほとんどありません。このスキルは、CodeSpring と現在のコードを照合し、マップ／ノート／PRD を実態に合わせます。

ガードレール：コードベースは読み取り専用です。 コードと Git の履歴を読み取り、CodeSpring（機能、ノート、PRD）にのみ書き込みます。このスキルからアプリケーションコードを変更することはありません。

使用するもの：codespring スキルのリファレンス（analyze-codebase.md、mindmap-structure.md、prd-management.md、pitfalls.md）。

0. まず接続する

codespring auth status と codespring status を実行します（LOCAL プロジェクト。表示してください）。

1. 変更点を把握する

• 最近の変更を確認します。git log、最後の同期時点（またはユーザーが指定したブランチ／タグ）からの git diff、および関連ファイルの現在の状態を確認します。GitHub のリモートが設定されている場合は、マインドマップの githubUrl とリポジトリを参照元とします。
• ユーザーが構築した機能に重点を置きますが、新しいルート、テーブル、ジョブ、環境変数、共有システムがないか、全体をスキャンします。

2. コードと CodeSpring を照合する

影響を受ける機能ごとに、実態とドキュメントの差分を確認します。

• 機能／サブ機能 — コードに新たな機能があるのに、機能／サブ機能として登録されていませんか？ ドキュメントに記載されているのに、すでに存在しないものはありませんか？
• ノート — 「仕組み」のノートには、実際のフロー、ファイル、ルートが引き続き正しく記述されていますか？
• PRD — フロントエンド／バックエンドの PRD は今も実態と一致していますか？ 特に、共有バックエンド契約（ルート、データモデル、認証／RLS、ジョブ／cron、ストレージ／バケット、支払い／クレジット、環境変数）と依存関係マップを確認します。
• 技術スタック — 追加すべき新しい依存関係／サービスはありませんか？

3. まず報告する

最新／軽微な調整が必要／古くなっているのいずれかで要約し、具体的な差分を簡潔に列挙します（それぞれにファイル／ルート／テーブルの参照と深刻度を付けます）。大幅な書き換えを行う前に、ユーザーに確認を求めます。

4. CodeSpring を更新する（書き込み先はコードではなく、こちら）

• 機能とサブ機能を追加／調整します（codespring feature create --parent ...、feature update ...）。node-features の数を正しく保ちます（階層が平坦化されている場合は親を再設定してください。pitfalls.md を参照）。
• ノートを更新します（codespring mindmap note ...）。
• PRD を更新します。PRD が大幅に古くなっている場合は cs-build-create-prd で再生成し、特定の内容のみ更新する場合は codespring prd sync <id> --file を使用します。
• 必要に応じて技術スタック／プロジェクト情報を更新します。

5. 確認する

CodeSpring で更新した内容を列挙し、プロジェクトのリンクを提示します。意図的に残したもの（例：計画済みだが未実装のタスク）があれば記載します。

望ましい状態

• CodeSpring が当初の計画だけでなく、コードの現在の動作を反映している。
• 書き換えを行う前に、正確な参照情報を添えて、差異を深刻度別に報告している。
• コードベースは変更されておらず、更新されたのは CodeSpring のみである。