ECdison6227/project-guardian-cheap-code-delegate

Project Guardian

このスキルは以下のプロジェクト境界で使用します。

• プロジェクトの開始時
• コンテキスト損失後や新しいスレッドの再開時
• 主要な編集前
• ファイル変更後
• 低コストワーカーがパッチを生成した後
• 作業セッションの終了時
• 最後のメモリチェックポイントから30分以上経過した場合

主要な責任

• プロジェクトの記憶を.ai/memory/に維持する。
• 機械可読な状態を.ai/state.jsonに維持する。
• gitの規律を強制する：自動的に初期化、ステージング、コミットを実行する。gitについて言及するだけでなく、実際に実行する。
• ブランチの安全性を保持する。
• 変更されたファイルを要約する。
• push、reset、clean、デプロイ、または破壊的なコマンドを自動的に実行しない。

開始または再開

1. .ai/state.jsonが存在するか確認する。
2. .ai/memory/ファイルが存在すれば読み込む。
3. git status --short --branchを確認する。
4. gitリポジトリでない場合、自動的にgit initを実行する。
5. mainまたはmasterブランチにいる場合、ユーザーにai/<task>ブランチを提案するが、確認なしに作成しない。
6. 新しい作業を行う前に簡潔な再開サマリーを生成する。

ヘルパー：

$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh resume

メモリの初期化

プロジェクトにメモリがない場合、ヘルパーを使用します：

$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh init --task "..."

ヘルパーは以下を作成します：

• .ai/state.json
• .ai/memory/PROJECT_MEMORY.md
• .ai/memory/SESSION_LOG.md
• .ai/memory/CHECKPOINTS.md
• .ai/memory/DECISIONS.md
• .ai/memory/TODO.md
• .ai/memory/PAPER_CONTEXT.md

また、ディレクトリがまだgitリポジトリでない場合、git initも実行します。

編集後

1. gitのステータスと差分サマリーを実行する。
2. 変更されたファイルを要約する。
3. 有用であれば、cheap-code-delegateを使用して低コストのチェックポイントドラフトを作成する。
4. 自動的にメモリチェックポイントを書き込む。
5. 自動的にgit add -Aとgit commit -m "checkpoint: <summary>"を実行する。
6. ユーザーが明示的に要求するか、--pushを渡さない限り、pushしない。

ヘルパー：

# ローカルに自動コミット
$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh checkpoint --summary "..."

# 自動コミットしてプッシュ（明示的な意図が必要）
$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh checkpoint --summary "..." --push

論文プロジェクト

プロジェクトが論文または学位論文の場合：

• .ai/memory/PAPER_CONTEXT.mdを維持する。
• 要旨、導入、関連研究、手法、実験、制限、結論、参考文献、図、表、数式を追跡する。
• 編集後、セクション間の一貫性、引用、番号付けを確認するようユーザーに促す。

自動実行アクション

以下を自動的に実行する：

• ディレクトリがgitリポジトリでない場合のgit init
• チェックポイント時のgit add -A
• チェックポイント時のgit commit
• .ai/memoryチェックポイントの書き込み

明示的なユーザー確認が必要

以下は自動的に実行しない：

• git push
• git reset
• git clean
• 破壊的なチェックアウト
• rm -rf
• デプロイ
• 本番コマンド
• 自動提案されたai/<task>ブランチ以外のブランチ作成

参考文献

必要な場合のみこれらを読み込む：

• references/memory-schema.md：.ai/ファイルの責任
• references/git-safety.md：安全なgitワークフロー
• references/paper-projects.md：論文メモリガイダンス