Agents Md

Overview

AGENTS.md を「汎用的に再利用できる作業ルール」へ整理する。必ず提案→合意→編集の順で進める。

Workflow

1. 目的の確認
2. 学びの抽出
3. 提案の作成
4. 合意後に編集

1. 目的の確認

• 対象ファイルを確認し、既存の方針と重複しないかを把握する。
• 目的は「プロジェクト全体で汎用的に有用なルールのみを残す」こと。

2. 学びの抽出

• セッション内の決定事項から、以下に該当するものだけを候補とする。
  • 今後も繰り返し使うルール・手順
  • 仕様や方針の合意事項（例: 常に提案から始める、テストの流儀など）
  • 複数ファイルに影響する設計原則
• 次は除外する。
  • 今回限りの実装詳細
  • 単一ファイルのローカル最適
  • 既存ドキュメント（guidelines/ など）にある内容の重複

3. 提案の作成（必須）

• 追加・変更・削除の候補を短い箇条書きで示す。
• 各候補に「理由」を付ける。
• 変更を確定させず、必ず確認を求める。

提案例:

• 追加: 「〜〜」
  • 理由: 〜〜
• 削除: 「〜〜」
  • 理由: 〜〜

4. 合意後に編集

• ユーザーの合意を得てから AGENTS.md を編集する。
• 変更は簡潔にし、冗長な説明は避ける。
• 既存のガイドラインへの参照がある場合は重複を避ける。