agent-dotfiles docs
agent-dotfiles の通常 Markdown docs を docs-site 上で読むための入口。 このページでは初期移植対象、follow-up、non-goal、source-side fix needed を分けて棚卸しする。
Source of truth
原本は TomoakiMizuno/agent-dotfiles の docs/。
内容が古くなった場合は元リポジトリを読み直して content/agent-dotfiles/docs/ を更新し、build で public/ を再生成する。
MVP pages
CLI 利用方法
インストール、基本コマンド、target 指定、doctor、agchat の使い方。
同期仕様
管理対象ファイル、Skills 管理、サニタイズ、非管理データ保持、status / diff の見方。
review 運用
review-orchestrator、multi-review、parent-assisted reviewer、artifact と gate の責務。
task-research contract
read-only research packet、artifact shape、downstream handoff 境界。
durable workflow dogfood runbook
durable workflow state を日常運用で使い続けるための手順。
durable acceptance close-readiness
deterministic coverage と live opt-in waiver の close audit 条件。
棚卸し
| Source | 分類 | 扱い |
|---|---|---|
docs/README.md |
反映済み | source repo の案内ページ。docs-site ではこの index が同じ入口を担う。 |
docs/ai-attribution.md |
follow-up | AI CLI の非対話 commit に付ける Assisted-by trailer と hook 設定を、通常 docs の候補として扱う。 |
docs/architecture.md |
follow-up | パッケージ構成、同期データフロー、設計判断をまとめた全体アーキテクチャとして別ページ化する。 |
docs/claude-rules.md |
follow-up | Claude rules の構成、導入方法、skill との責務境界を説明する通常 docs の候補として扱う。 |
docs/auto-memory-stocktake.md |
follow-up | Claude Code の自動メモリを残す基準、削除手順、index と個別 file の整合確認をまとめた運用 docs として別ページ化する。 |
docs/e2e-test-contract.md |
follow-up | sandbox HOME への実インストールを確認する E2E 手順 contract として、契約文書の移植時に扱う。 |
| CLI 利用方法 | 初期対象 | HTML page |
| 同期仕様 | 初期対象 | HTML page |
| review 運用 | 初期対象 | HTML page |
| task-research contract | 移植済み | HTML page |
| durable workflow dogfood runbook | 移植済み | HTML page |
| durable acceptance close-readiness | 移植済み | HTML page |
docs/issue-workflow-skills.md |
follow-up | Issue workflow 全体の参照として通常 docs 移植候補にする。概要は skill reference に反映済み。 |
docs/agmsg.md |
follow-up | cross-agent messaging の運用 doc として別ページ化する。 |
docs/compact-plus.md |
follow-up | compact-plus vendoring の運用 doc として、対象読者を確認してから別ページ化する。 |
docs/orca-hook-forwarding.md |
follow-up | Orca hook forwarding の migration runbook として、設定境界を確認してから別ページ化する。 |
docs/degraded-mode.md |
follow-up | degraded mode の運用 contract として、runtime / workflow 境界を確認してから別ページ化する。 |
docs/superset-notifications.md |
follow-up | Superset 通知 filter の runbook として別ページ化する。 |
docs/*-contract.md |
follow-up | 契約文書は相互リンク量が多いため、通常 docs の第2段としてまとめて移植する。 |
docs/workflow-contracts/schema-contract-inventory.md |
follow-up | workflow contract schema の棚卸しとして、他の workflow-contracts と合わせて移植する。 |
docs/workflow-contracts/workflow-state-retention-inventory.md |
follow-up | workflow state retention の棚卸しとして、durable workflow docs と合わせて移植する。 |
docs/workflow-skill-invariant-classification.md |
follow-up | workflow skill invariant の分類メモとして、workflow contract docs の第2段で扱う。 |
docs/agent-team-*.md |
follow-up | agent team workflow docs として contract / runbook / fixture をまとめる。 |
docs/agmsg-long-lived-session-poc.md |
non-goal | PoC 記録のため、通常 docs の安定ページ化対象からは一旦外す。 |
docs/issue-304-live-verification.md |
non-goal | issue-specific verification artifact のため、汎用 docs index には載せるだけに留める。 |
docs/investigations/completion-workflow-guard-promotion-2055.md |
non-goal | required 昇格時の調査記録のため、安定した通常 docs としてはページ化しない。 |
docs/skills/*.md |
non-goal | skill reference は #12 の scope として扱う。 |