dotagents
Claude Code / Codex の環境そのもの（skill・command・agents・rule・グローバル共通憲法・調査資産・環境整備の聖典）を複数端末で同期する個人 dotfiles。GitHub が真実の源。
- 趣旨・原則・残件: PLAN.md（憲章＝聖典 v4。プランは docs/ に作る。目的・判断理由・受入条件と工程正本への導線を持つ）
- AI 向けの掟（全エージェント共通）: AGENTS.md（Claude Code も CLAUDE.md が無ければ直接読む）。URL を渡された AI のオンボーディング入口も AGENTS.md（「AI オンボーディング」節）
構成
dotagents/
├── PLAN.md … 開発工場の憲章（趣旨・原則・定常運用・残件）
├── AGENTS.md … 全 AI 共通のプロジェクト正典＋AI オンボーディング入口
├── install.sh … symlink 配置（冪等・実ファイルは SKIP・失敗は停止）
├── docs/ … 00_overview.md（地図）・02_models.md（役割→モデル×effort順位表）・01_project-layout.md・進行中プラン／archive/（役目を終えた文書）
├── rag/ … 調査・研究の再利用棚（INDEX.md＋topic/raw/ 一次ソース）
├── shared/
│ └── constitution.md … Claude/Codex/Grok/Cursor共通憲法の唯一の手編集正本
├── claude/
│ ├── CLAUDE.delta.md … Claude固有差分の正本
│ ├── CLAUDE.md … 共通＋deltaの生成物（→ ~/.claude/CLAUDE.md）
│ ├── skills/ … → ~/.claude/skills/<name>│ └── agents/ … → ~/.claude/agents/<name.md ├── codex/ │ ├── AGENTS.delta.md … Codex固有差分の正本 │ ├── AGENTS.md … 共通＋deltaの生成物（→ ~/.codex/AGENTS.md） │ ├── skills/ … → $HOME/.agents/skills/<name（既定。legacy は明示指定） │ └── rules/ … → ~/.codex/rules/<file ├── grok/ │ ├── AGENTS.delta.md … Grok固有差分の正本 │ ├── AGENTS.md … 共通＋deltaの生成物（→ ~/.grok/rules/AGENTS.md） │ ├── skills/ … → ~/.grok/skills/<name │ └── agents/ … → ~/.grok/agents/<name.md ├── cursor/ │ ├── AGENTS.delta.md … Cursor固有差分の正本 │ ├── AGENTS.md … 共通＋deltaの生成物（リポ内保持。HOMEへは置かない） │ ├── rules/factory.mdc … 同一本文の alwaysApply 規則（→ ~/.cursor/rules/factory.mdc） │ ├── skills/ … → ~/.cursor/skills/<name │ └── agents/ … → ~/.cursor/agents/<name.md └── bin/ … 配布scriptだけ → ~/.local/bin/<name（拡張子は外れる。repo専用rendererは非配布）
flowchart LR subgraph repo["dotagents (このリポジトリ)"] common["shared/constitution.md"] cdelta["claude/CLAUDE.delta.md"] xdelta["codex/AGENTS.delta.md"] gdelta["grok/AGENTS.delta.md"] kdelta["cursor/AGENTS.delta.md"] gcm["claude/CLAUDE.md (generated)"] cs["claude/skills/<name>/"] cc["claude/commands/<name>.md"] ca["claude/agents/<name>.md"] xam["codex/AGENTS.md (generated)"] xs["codex/skills/<name>/"] xr["codex/rules/<file>"] gam["grok/AGENTS.md (generated)"] kam["cursor/rules/factory.mdc (generated)"] bin["bin/<name>.sh"] end subgraph home["$HOME (各端末)"] hgcm["~/.claude/CLAUDE.md"] hcs["~/.claude/skills/<name>"] hcc["~/.claude/commands/<name>.md"] hca["~/.claude/agents/<name>.md"] hxam["~/.codex/AGENTS.md"] hxs["$HOME/.agents/skills/<name> (official)"] hxsl["~/.codex/skills/<name> (legacy)"] hxr["~/.codex/rules/<file>"] hgam["~/.grok/rules/AGENTS.md"] hkam["~/.cursor/rules/factory.mdc"] hbin["~/.local/bin/<name>"] end common -- gcm cdelta -- gcm common -- xam xdelta -- xam common -- gam gdelta -- gam common -- kam kdelta -- kam gcm -. "install.sh が symlink" .- hgcm cs -. symlink .- hcs cc -. symlink .- hcc ca -. symlink .- hca xam -. symlink .- hxam xs -. "--profile official (既定)" .- hxs xs -. "--profile legacy (明示時のみ)" .- hxsl xr -. symlink .- hxr gam -. symlink .- hgam kam -. symlink .- hkam bin -. "symlink (.sh は外れる)" .- hbin
Codex skill は同一端末・同一入口で **official / legacy の一方だけ**に置く。既定は公式 user skill 面
`$HOME/.agents/skills`。古い入口の互換検証だけ `./install.sh --profile legacy` を明示し、
`verify-install --profile legacy` を通す。installer は反対面を勝手に削除しない。
## 同梱資産
| 種類 | 名前 | 用途 |
|---|---|---|
| Claude skill | `auto-deploy-on-push` | push 契機の SSH + docker compose 自動デプロイ構築 |
| Codex skill | `auto-deploy-on-push` | read-only調査とH承認を先行するpush起点デプロイ構築 |
| Claude agent | `implementer` | 委譲契約焼き込み済みの実装者（安価枠。順位表は shared/runbooks/02_models.md） || Claude command | auto-deploy-on-push / polish-github | 各スキルの入口 | | Codex skill | polish-github | GitHub presentation 整備（正本は Claude 版・Codex 版は薄いポインタ＝一本化済み） | | Codex rule | default.rules | Codex 常時適用ルール | | 共通憲法 | shared/constitution.md | Claude／Codex／Grok／Cursorへ生成する人格・応対・安全・調査・計画・git・報告の唯一の共通正本 | | Claudeグローバル規範 | claude/CLAUDE.delta.md → claude/CLAUDE.md | 共通憲法＋Claude固有deltaから合成する配布生成物 | | Codexグローバル規範 | codex/AGENTS.delta.md → codex/AGENTS.md | 共通憲法＋Codex固有deltaから合成する配布生成物。配置・配線の正典はdocs/02・docs/05 | | Grokグローバル規範 | grok/AGENTS.delta.md → grok/AGENTS.md | 共通憲法＋Grok固有deltaから合成する配布生成物。配置先は~/.grok/rules/AGENTS.md | | Cursorグローバル規範 | cursor/AGENTS.delta.md → cursor/AGENTS.md と cursor/rules/factory.mdc | 共通憲法＋Cursor固有delta。runtime mountは~/.cursor/rules/factory.mdcのみ | | Cursor skill | auto-deploy-on-push / gpt-connector / polish-github | ~/.cursor/skills。skills-cursor/は触らない | | Cursor agent | implementer / refuter | ~/.cursor/agents。bundled explore/planは置換えない | | Grok skill | auto-deploy-on-push / gpt-connector / polish-github | ~/.grok/skillsが同名のCodex/Claude面に勝つ | | Grok agent | implementer / refuter | ~/.grok/agents。bundled explore/planは置換えない | | bin | render-global-constitution.mjs | 共通憲法＋host deltaから4 harness向け完全指示を冪等生成し、driftを検査 | | repo内検査 | bin/render-current-docs.mjs | 配備契約から現行状態を生成し、ASTで全documentの所有surface、local link、既存evidenceの不変性を検査。npm ci --ignore-scripts後にrepo内で実行し、~/.local/binへは配布しない | | bin | apply-grok-config | Grok の compat.claude.agents=false / hooks=false と工場hookを dry-run / backup / 冪等適用する（--apply は端末承認後。正典はdocs/07） | | bin | apply-cursor-config | Cursor の工場hookを ~/.cursor/hooks.json へ dry-run / backup / 冪等適用する（--apply は端末承認後。正典はdocs/08）。cli-config.json は触らない | | Codex サブエージェント | shared/runbooks/02models.md | 役割と任務からmodel×effortを選び、呼出しごとに指定 | | bin | agents-update.sh | deployment contractのhost別CLI／SDK集合を@latestへ更新し、公開結果の記録とreportの配送を実行 | | bin | setup-macos-factory.sh / setup-linux-factory.sh / setup-linux-workstation-factory.sh / setup-windows-native-factory.ps1 | host別の工場一撃展開。Linux 2席は共通本体を使いながらserver/workstationの役割を分離し、各製品の公式入口の実行と工場の配置・報告配送を行う。Windows入口はmain-serverへの恒久SSHも所有する | | GitHub Actions | ci.yml / factory-full-ci.yml | 工場の現行状態でfull CIとしたrunnerだけに、論理CPU数をjob数とする同じmake ciを実行する。main-server runnerは運用workflow専用。運用契約はFactory CI runbook | | GitHub Actions | enroll-windows-main-server-ssh.yml | Windows専用公開鍵をmain-server runner自身がauthorizedkeysへ冪等登録する。秘密鍵はWindowsから出さない | | bin | bughub-external-probe.mjs | server profileからloopback /readyzとdeploy revision manifestを照合し、安全な固定checkへ投影 | | bin | factory-reporter.mjs | 明示opt-inされた工場reportを検証・outbox保存・BugHubへ冪等送信 | | bin | factory-external-event.mjs | Pi5等の外部監視結果をmain-serverの所有者限定stateへ固定ServerManager eventとしてappend-only記録し、BugHub受理後だけack | | bin | apply-codex-config.sh / apply-claude-config.sh | Codex routing / hook と、Claudeの正本化・callout・advisory・Lattice Gantt・Git破壊操作・責務境界hookを dry-run / backup / 冪等適用する（--apply は端末承認後） | | 工場接続 | Caveat（dotagents 外） | 工場は caveat mcp-server と caveat factory-diagnostics --json の公開面だけを呼ぶ。導入・罠DB・同期・公開は Caveat README が正 | | 自作コア製品 | 工場の現行状態に列挙（いずれもdotagents 外） | 罠知識、セッション継続、未使用ツール監査、工程graphとコード構造理解、ChatGPT接続、PTYと外部モデル枠、隔離Codex実行、macOS native開発面、中央運用管理、対等マルチエージェント円卓、日本語文章の校正規範を担う。AIShellはmacOS arm64専用。Observerは2026-08-16に工場コアから撤去。各製品の編入版は製品契約台帳が持つ | | 第三者管理製品 | 工場の現行状態に列挙 | 上流の公式導入・更新と公開CLIの呼出し、公開結果の記録・報告だけを管理する。製品本体・操作・OS対応は上流が所有する | | 基盤toolchain | Claude Code CLI／Codex CLI／Grok Build | コア製品とは別区分。Oracleはv1互換・rollback専用。Mac自前 Desktop と main-server 自前 AFK は overlay で、正典は docs/factory-grok-build-community-overlay.md | | 中央管理コア | ServerManager（dotagents 外） | 自作コア一覧に含まれる中央運用管理製品。内部のBugHubをversion・bug・compatibility結果の統括に使い、BugHubを独立製品へ分離しない | | コード構造・工程graph | Lattice（dotagents外） | 自作コア一覧に含まれる。Codegraphを完全吸収した正式後継で、lattice-mcpと同梱sensorを所有する。独立Codegraphはretired／notapplicable履歴だけを保持。導入完了記録 | | 知識 | rag/ | 調査の一次ソース＋結論（第二の脳。人間用の窓は Obsidian） |
Claude command の Codex 正規入口は slash command の模造ではなく、対応 skill の明示 invocation とする。
| Claude command | Codex 入口 | |---|---| | /auto-deploy-on-push | $auto-deploy-on-push | | /polish-github | $polish-github |
工場コア製品の変更管理
工場の現行状態に列挙された管理製品の追加・削除・第三者化・所有移管は、PRODUCTIDSや表の1行だけを変えて終わりにしない。製品repoで導入・設定・状態・schema・migration・診断・復旧・更新・releaseの正本を先に確定し、dotagentsの統合契約台帳には製品ID、repo、version入口、公開diagnosticsとschema ID、adapter projection、privacy、host参照、製品文書へのpointerだけを記録する。
- 追加は、製品repoで単独導入・更新・診断・復旧・releaseを確定してから、dotagentsへhost matrix、adapter、BugHubの固定product集合と期待matrix、privacy fixture、工場rollout/verifyだけを追加する。自作製品はnative diagnosticsを先に作り、dotagentsが内部DBを推測しない。
- 削除は、rg -aとLattice sensorでconsumerを確認し、scheduler/outbox/runtime cursorを停止・drainしてから行う。BugHubの履歴を物理削除せず、移行中の旧clientは対象をnotapplicableで報告し、server期待matrixから外す時期とclient/server双方が旧reportを扱う期間を明示する。
- 第三者化は、製品repoへのinstrumentation・内部state解釈・fork/patchを撤去し、version範囲付きblack-box adapterへ切り替える。追従不能な状態はunsupportedまたはunverifiedであり、greenへ丸めない。
- 所有移管は、製品repo側でsource/state/schema、release/update、credential責務と修正先を更新し、dotagentsは統合pointerとadapterだけを追従する。製品のsourceやstateをdotagentsへ移さない。基準path・repo移動はこの変更とは別にオーナーの明示承認を取る。
- wire schema majorを変える時は factory reporterランブック のserver-first・別endpoint・host単位cutoverを使う。全repoを独立commit/rollback可能にし、各gateとcanary後にだけ旧majorをretireする。
- 自作コア製品の修理・releaseは各製品repoの正典と機械gateで完遂する。dotagentsはその手順を中央規定せず、公開後のversion/diagnostics probe、host rollout、wire横断受入だけを行う。公開不具合のrollback方式も製品repoが所有する。
Codex 9面の対応状況
「全対応」はファイル数の左右対称ではなく能力対称で判定する。合格条件・進捗・各面の状態は Codex全対応の工程状態はLattice storeが正本で、旧4 host・5入口の完了台帳は アーカイブ済み計画に履歴として残す。現役hostと入口は下のhost別表を正とする。
| 面 | dotagents の正規入口 | |---|---| | AGENTSMD | codex/AGENTS.md＋リポごとの AGENTS.md | | CONFIG / MCPSERVERCONFIG | docs/05codex-fragments.md＋apply-codex-config＋verify-install | | SKILLS | codex/skills/ → user skill 面（公式面が既定） | | PLUGINS | — 非採用（個人git＋symlink配布と二重化するため） | | SUBAGENTS | shared/runbooks/02models.mdに基づく呼出し時のmodel／effort指定 | | HOOKS | bin/codex-git-destroy-gate-hook.sh＋docs/05codex-fragments.md | | COMMANDS | Claude command に対応する Codex skill | | SESSIONS | Throughline＋Codex handoff smoke |