agent: decide/doc-lintを更新し、.agents と .claude を同期
codexが .agents 側で更新した内容を .claude へ取り込み、名前依存の箇所だけ 置換した。両ツリーの差分はCLAUDE.md/AGENTS.mdとパスの表記のみ。 - 非採用一覧の掲載基準をルール1の変更に合わせる - 本文の「未決」はリンク・課題追加・言及削除のいずれかを判断する(ルール4) - 責務を外へ移したあと、担当範囲が分かる一文と参照が残っているか確認する - doc-lintに未確認事項リンクの参照先・ラベル整合の検査(ERROR)と、 リンクのない課題番号・参照なしの「未決」「未定」の検出(WARN)を追加 - load() のコードフェンス処理が ~~~ や長さ違いを扱えていなかったのを修正 - .Codex という実在しないパスの参照を .agents に修正 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MtVk8W4yK6j3eCqQpEQBLS
This commit is contained in:
@@ -7,8 +7,9 @@ argument-hint: [決定の要旨]
|
||||
|
||||
# 決定を記録する
|
||||
|
||||
AGENTS.md のルール1〜4に従い、決定を4箇所に分散して記録する。
|
||||
どれか1つでも欠けると後から追えなくなるので、全部やる。
|
||||
共通の運用ルールは、AGENTS.mdの参照先であるCLAUDE.mdを正とする。
|
||||
現在の仕様はメインドキュメント、判断の経緯はjournal、変更の要旨はコミットに記録する。
|
||||
「検討済み・非採用」には、将来の再提案を防ぐために必要な案を選んで残す。
|
||||
|
||||
## 手順
|
||||
|
||||
@@ -30,17 +31,22 @@ AGENTS.md のルール1〜4に従い、決定を4箇所に分散して記録す
|
||||
- ✗ `B案はKLEパーサーが壊れるので却下した`
|
||||
- ○ `クラスター情報はKLE JSONに出力しない(KLE互換性の制約)`
|
||||
- 比較表・検討過程・ベンチマーク結果をここに書かない。
|
||||
- 他の担当の詳細を外へ移したあとも、この文書だけで担当範囲が分かるか確認する。
|
||||
境界の理解に必要な一文と参照は残す。参照先の仕様は複製しない。
|
||||
|
||||
### 2. 落とした案を1行残す
|
||||
### 2. 非採用一覧に残す案を選ぶ
|
||||
|
||||
メインドキュメント末尾の `## 検討済み・非採用` に追記する。
|
||||
各案について、この記録が将来のどんな再提案を防ぐかを判断する。
|
||||
本文の制約だけで十分なら一覧へ重複記載しない。実際に検討した別方針で、
|
||||
再提案されうるものは、経緯への入口として末尾の `## 検討済み・非採用` に1案1行で残す。
|
||||
|
||||
```
|
||||
- labels[9] へのID埋め込み (journal/2026-09-16-cluster-metadata.md)
|
||||
```
|
||||
|
||||
- 理由は書かない。journalファイル名だけ。
|
||||
- セクションが5行を超えたら、古いものから落とす。長くなるのは書きすぎのサイン。
|
||||
- 目安は5行まで。件数や古さだけで機械的に削除せず、再提案を防ぐ必要性で掲載を見直す。
|
||||
- 掲載する案がなければセクションを設けない。一覧から外しても経緯はjournalに残す。
|
||||
|
||||
### 3. journal を書く
|
||||
|
||||
@@ -55,7 +61,7 @@ AGENTS.md のルール1〜4に従い、決定を4箇所に分散して記録す
|
||||
冒頭20行で結論と選択肢が分かること。整形は最低限でよい。
|
||||
他ファイルへのリンクも、他ファイルからのリンクも張らない。
|
||||
|
||||
### 4. 推測を扱う
|
||||
### 4. 推測と未決の問いを扱う
|
||||
|
||||
この決定が未確認の推測に依存する場合:
|
||||
|
||||
@@ -65,6 +71,11 @@ AGENTS.md のルール1〜4に従い、決定を4箇所に分散して記録す
|
||||
逆に、この決定で検証が済んだ推測があれば、タグを外して `## 未確認事項` から削除する。
|
||||
本文タグと末尾項目は必ず対で操作する(片方だけ残さない)。
|
||||
|
||||
本文の未決記述は、読者が現在の対応範囲を理解するために必要かを判断する。
|
||||
対応する問いがあればCLAUDE.mdのルール4に従ってリンクし、問いの詳細は複製しない。
|
||||
必要な問いが未登録なら未確認事項を追加し、実装にも現在の説明にも不要な言及なら本文から外す。
|
||||
今は答えに依存せず進められる課題はルール5に従う。「未決」という単語だけで分類しない。
|
||||
|
||||
### 5. コミットする
|
||||
|
||||
メインドキュメントと journal を**同じコミット**に入れる。1コミット1決定。
|
||||
|
||||
Reference in New Issue
Block a user