workspace-layout

Workspace / Layout

Agent と人間が同じ地図を共有できるよう、ワークスペース（@this/）の 推奨レイアウト を定義する。 散在した規約・ドキュメント・一時領域は発見コストと ignore 漏れを増やすため、ここに揃える。

一時成果物を いまのタスクでどこに書くか は workspace-agent-temporary の責務である。 本 SKILL は「全体の箱」と、必要になったタイミングでの不足パス提案を担う。

いつ使うか

• ワークスペース全体の推奨構成を説明する・提案するとき
• ドキュメント作成・Agent 作業などで、推奨パスが未整備だと分かったとき
• 「このファイル／ディレクトリはルートのどこ？」と配置を決めるとき

いつ使わないか

• 使い捨てスクリプト・計画・調査メモの 置き場選びだけ → workspace-agent-temporary
• Memory 本文のフォーマット → workspace-agent-memory-save
• 文書内パスや {assets}/ の実体解決だけ → workspace-resolve-file-path / workspace-resolve-agent-assets

アセットディレクトリ

ひな形の探索先（{assets}/... を解決するとき workspace-resolve-agent-assets に従う）:

• ./assets/
• apm_modules/**/workspace-layout/assets/

推奨レイアウト

@this/ 直下を基準とする。 本 SKILL は APM 配布を前提とするため、apm.yml / apm_modules/ は構成上そろっている想定である。

@this/
├── AGENTS.md                      # Agent 向けプロジェクト規約（常時 Context）
├── README.md
├── apm.yml                        # APM 依存定義
├── .ai-agent/                     # Agent 作業領域（gitignore・単数形のみ）
│   ├── .gitignore
│   ├── tmp/                       # 使い捨てスクリプト・ログ・下書き
│   ├── plan/                      # 実行中・レビュー中の計画 (*.md)
│   │   └── done/                  # 完了した計画
│   └── memory/                    # 調査結果・引き継ぎ Memory (*.md)
│       └── done/                  # 用済み Memory
├── docs/                          # 技術ドキュメント正本（markdown-*）
└── apm_modules/                   # APM 依存の展開先・Agent アセット探索先

各要素の役割

パス	必須度	役割
AGENTS.md	推奨	Agent 向け規約の置き場（常時 Context）。本 SKILL はパス案内のみ
README.md	推奨	人間向け概要の置き場。本 SKILL はパス案内のみ
apm.yml	前提	APM 依存定義（本パッケージ配布の前提）
.ai-agent/	必要時	コミットしない作業領域。単数形のみ
docs/	必要時	技術ドキュメント正本
apm_modules/	前提	APM install の展開先（通常は gitignore）

AGENTS.md / README.md

• 置く場所は @this/ 直下（上表）である
• 中身・見出し・テンプレートは本 SKILL の対象外である
• 無いまま規約や README が必要になったら、@this/ への作成を提案する（本文はユーザー方針や他ドキュメントに任せる）

.ai-agent/ の場所

• ディレクトリ名は .ai-agent/（単数形） のみ
• 一時ファイル・計画・Memory の運用ベースは @this/.ai-agent（workspace-agent-temporary / workspace-resolve-root-directory）。Git ルート相対で特定サブディレクトリの .ai-agent を優先する旧候補順は使わない
• ひな形を導入するときも、導入先は いまの @this/.ai-agent とする（別 Multi-Root folder へ勝手に作らない）
• 配下の使い分け（tmp / plan / memory）の運用は workspace-agent-temporary に委譲する
• Memory の書き方は workspace-agent-memory-save に委譲する