메뉴
ドキュメント・記録の運用の正本 (置き場判定・原則・ADR の作法)。 issue / ADR / docs / brain ノートに振り分けて保存まで実行する。 Claude Code で /doc、Codex で $doc と入力したとき、「これ残しておきたい」「どこに書くべき?」と言ったとき、 設計ドキュメント・仕様・README などドキュメントを書く・編集する前、 および実装が完了して PR を作る前の残し漏れ確認に使用する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
claude.ai の cloud 環境の init_script を内部 API で更新し、 環境スナップショットの再構築を発火させる。 Claude Code で /cloud-bump、Codex で $cloud-bump と入力したとき、または dotfiles の main にマージした変更が cloud 配信対象 (cloud-setup.yaml の paths) に触れていたときに使用する。 dotfiles を変更する PR を作成するときも、マージ後の bump の要否判定と予告のために使用する。
スキル (SKILL.md) の新規作成・編集の進め方の正本。 ユーザーが Claude Code で /skill、Codex で $skill と入力したとき、またはスキルの追加・変更を依頼したとき、 または home/.agents/skills/ 配下の SKILL.md を変更する前に使用する。
repo をまたぐタスクの切り出し方、セッションの作り直し方、git worktree を用意する手順。 Claude Code で /wt、Codex で $wt と入力したとき、セッション開始ディレクトリ以外の repo を変更するとき、 コンテキストが増えたセッションを作り直したいと言ったとき、 またはスキルや作業フローが作業用 worktree を必要とするときに使用する。
現在のブランチに紐づく PR の CI 失敗・レビュー指摘・main との conflict を修復し、 mergeable な状態まで持っていく。Claude Code で /pr、Codex で $pr と入力したときに使用する。
会話やプランの内容をもとに、ブランチ作成・コミット・プッシュ・PR 作成を一括実行する。 Claude Code で /tha、Codex で $tha と入力したときに使用する。
新しいリポジトリを作るフローの正本。 Claude Code で /new-repo、Codex で $new-repo と入力したとき、 または「新しいリポジトリを作りたい」「リポジトリを切り出したい」と言ったとき、 または nozomiishii 配下に新しいリポジトリを作る作業を始める前に使用する。
| name | doc |
| description | ドキュメント・記録の運用の正本 (置き場判定・原則・ADR の作法)。 issue / ADR / docs / brain ノートに振り分けて保存まで実行する。 Claude Code で /doc、Codex で $doc と入力したとき、「これ残しておきたい」「どこに書くべき?」と言ったとき、 設計ドキュメント・仕様・README などドキュメントを書く・編集する前、 および実装が完了して PR を作る前の残し漏れ確認に使用する。 |
記録の置き場を判定し、保存まで実行する。置き場判定の正本はこのスキル。設計の判断は ADR、経緯は nozomiishii/brain#268。
内容ごとに次で判定する。判定はこのスキルの内部ロジックで行い、ユーザーへの一問一答はしない。
docs/ (実装 PR で育てる)docs/decisions/ に ADRdocs/ (実装 PR に同梱)dotfiles/home/AGENTS.md、repo 固有は対象 repo の AGENTS.md)。Claude Code に読ませる repo では CLAUDE.md から AGENTS.md を参照できる構成が必須。既存の CLAUDE.md が無ければ同じ内容を参照する symlink、既存内容があれば上書きせず @AGENTS.md import を使うClaude Code の auto memory は無効化している (autoMemoryEnabled: false)。Codex の memory 状態は別設定なので、この値から推測しない。memory に永続化したくなる内容はこのフローで AGENTS.md / issue / brain に振り分ける。
design doc の置き場は着手で切り替わる。着手したら issue の内容を docs/ のファイルへ移し、実装 PR で実装と一緒に育てる。issue には移した先のリンクだけ残し、実装 PR で close する (正本は 1 つ)。マージまでに「どう作るか」の記述を削り、今どうなってるかの Reference に仕上げる。経緯として残したい判断は ADR に書く。
探すときの入口は 3 つ: repo のことは AGENTS.md から docs/ へ、経緯は issue 検索と ADR、横断は brain vault。
会話から残す候補を列挙し、判定結果を表で 1 回だけ提示する。候補には番号を振り、「番号で指定してください」と添える。
| # | 内容 | 置き場 | アクション |
|---|
承認で実行する。「2 と 4 だけ」のような番号での取捨選択、修正指示 (「これは issue でなく ADR」等) があれば反映して実行する。issue 作成・PR は外向き操作なので、承認前に実行しない。
docs/decisions/)対象 repo の docs/decisions/ に 1 判断 1 ファイルで作る。ディレクトリは最初の ADR を書くときに初めて作る。
superseded by <新 ADR への相対リンク> にするテンプレート。見出しの日本語は添え書きで、慣れたら外してよい。
# <決定を 1 文で>
Status: accepted
Date: YYYY-MM-DD
## Context — 判断を迫られた状況
## Decision — 決めたこと
## Consequences — 決定がもたらすもの
実装 PR があればそこに同梱し、なければブランチを切って PR にする。セッション開始ディレクトリ以外の repo は sibling の wt SKILL.md を明示的に読み、worktree を切ってから作業する。
note skill に委譲する。
実装を終えて PR を作る前に次を自問し、該当があれば候補として提案する。