Imported from rummelonp/junkyard (AGENTS.md). Install upstream with npx skills add rummelonp/junkyard. Copyright stays with the author.

AGENTS.md

junkyard は、個人の作業から得た再利用可能な知見だけを蒸留して置く public repository である。 この repository で作業する agent は、次の指示に従う。

最初に読むもの

• 公開の可否、情報の分類、書き方の規則は PUBLICATION_POLICY.md が唯一の正本である。ノートを書く、直す、レビューする前に読む。
• この文書や skill がポリシーと食い違って見えるときは、ポリシーに従い、食い違いをユーザーに報告する。

構成

• notes/：公開するノート。ディレクトリを分けずに平らに置き、frontmatter の tags で知識の種類ごとに分類する。元の repository では分類しない。
• drafts/：公開前の生成物（gitignore 済み）。
• assets/：README などで使う画像。置けるのはメタデータのチャンクを含まない PNG だけで、ノートには画像を貼らない。
• templates/note.md：ノートの雛形。
• checklists/publication-safety.md：公開前レビューの確認項目。
• .agents/skills/：skill の正本。.claude/skills/ はここへの symlink である。
• scripts/check.py：静的 safety check。
• scripts/build_readme.py：README のノート一覧の生成。

作業の規則

• 他の repository から知見を集めるときは junkyard-harvest skill を、公開前の判定には junkyard-review skill を使う。
• 非公開の個人資料から抽出したノートは drafts/ に書く。別のコンテキストの junkyard-review で PASS し、ユーザーが承認するまで notes/ へ移さない。
• 公開情報だけを根拠にしたノートや、非公開資料から抽出せず直接書いたノートでは、独立したレビューを必須としない。静的チェックと自己点検を行い、ユーザーが承認してから公開する。
• ノートや meta 文書を変更したら python3 scripts/check.py を実行する。検出 0 件は安全の証明ではない。
• ノートを追加、変更、削除したら python3 scripts/build_readme.py で README の一覧を生成し直し、ノートと一緒に commit する。一覧を手で編集しない。
• scripts/ を変更したら python3 -m unittest discover -s scripts を実行する。
• commit は、ユーザーの明示的な指示があるときだけ行う。収集したセッションで行う場合も、対象の差分を確認し、ユーザーのレビューを終えてから行う。push はしない。
• commit で --no-verify や git add -f を使わない。フックや ignore の設定に止められたら、回避せずユーザーに報告する。
• commit message とブランチ名に、source を示す語（元の repository 名、元の文書名、作業の経緯）を書かない。
• drafts/、.claude/plans/、*.local.* を commit しない。

文章

• 日本語で書く。一文ごとに改行し、段落の区切りは空行で示す。
• 日本語の地の文に英数字を混ぜるときは、前後に半角スペースを入れる。