| name | work-artifacts-layout |
| description | work/ 配下の作業ディレクトリ構造を、後続タスクが確実に参照できるよう整備するスキル。 USE FOR: work/ structure, artifacts path, qa/ structure. DO NOT USE FOR: docs/ format (use docs-output-format). WHEN: work/ 配下にファイルを作成したい、作業ディレクトリを整備したい。
|
| metadata | {"origin":"user","version":"2.0.0"} |
work-artifacts-layout
目的
- 後続Sub/別PRが確実に参照できるよう、work// を「入口つき」で整理する。
Non-goals
docs/ 配下の成果物フォーマット管理 — Skill docs-output-format が担当src/ 配下のソースコード構造管理 — リポジトリ慣習または Agent 固有ルールに従う- 成果物の品質評価・レビュー — Skill
adversarial-review が担当
- 質問票の内容設計 — Skill
task-questionnaire が担当
運用ルール
- README.md を"入口"として最初に整備
- 契約/決定事項は contracts/ に集約（根拠のパスを必ず付ける）
- 生成物/抽出物は artifacts/ に集約（巨大なら large-output-chunking に従う）
README.md（入口）最小テンプレ
目的 / 入口（plan / contracts / artifacts）/ 根拠（参照元）/ 現状（完了/未完/次のSub）/ 検証
§4.1 絶対ルール概要（詳細: references/directory-structure-detail.md）
work/ および qa/ 配下のファイル作成・更新時は delete→create に必ず従うこと。
- 禁止: 上書き更新(edit/update/patch) / 追記(append) / 削除省略
- 適用範囲:
work/ 全ファイル / qa/ 全ファイル / knowledge/ 全ファイル / 全 Custom Agent
並列安全性ルール
複数ジョブが同時実行される場合、各ジョブは以下の識別子でディレクトリを分離する:
- Web UI 方式: Issue 番号（
Issue-<N>）で自動分離（変更不要）
- CLI SDK 方式:
run-<タイムスタンプ-UUID> + step-<step_id> で分離
- 例:
work/self-improve/run-20260413T143022-a1b2c3/step-1.1/
- ロックファイル（
.self-improve-lock）は run_id ディレクトリ内に配置
run_id は SDKConfig.run_id フィールドで管理し、run_workflow() 開始時に1回生成する
work/ ディレクトリ構造（2系統）
非 Custom Agent 時: work/Issue-<識別子>/
Custom Agent 時: work/<Custom Agent Name>/Issue-<識別子>/
各ディレクトリの構成ファイル：
README.md・plan.md・subissues.md（分割時のみ）・onboarding.md（初見時のみ）・contracts/・artifacts/
ガイド一覧（references/）
| ファイル | 内容 |
|---|
references/directory-structure-detail.md | §4.1 疑似コード全体、§4.3 qa/ の構造・命名規則・適用対象、§4.4 ソースコードパス標準定義テーブル |
成果物サマリーテンプレート（Observation Quality）
全 Agent の成果物に以下 4 要素を含める（PR description 内に統合して記載する）:
## 成果物サマリー
- status: [成功/失敗/部分完了]
- summary: [何を行い何が変わったか（3行以内）]
- next_actions: [後続で必要な作業（あれば Agent 名を推奨付き）]
- artifacts: [生成/変更したファイルの一覧]
§7 との関係: 本テンプレートは §7「目的/変更点/影響範囲/検証結果/既知の制約/次にやるSub」の構造化補完版。PR description 内に統合して記載する。
入出力例
※ 以下は説明用の架空例です
例1（非 Custom Agent: Issue #42）: work/Issue-42/ に README.md + plan.md + contracts/ + artifacts/
例2（Custom Agent: Arch-DataModeling + Issue #58）: work/Arch-DataModeling/Issue-58/
例3（qa/ 命名）: Custom Agent + Issue #58 → qa/Arch-DataModeling-Issue-58.md
Related Skills
| Skill | 関係 | 説明 |
|---|
task-dag-planning | 利用元 | plan.md / subissues.md の配置に本Skillのパス規則を使用 |
large-output-chunking | 利用元 | artifacts/ 配下の分割ファイル配置に本Skillの構造を使用 |
docs-output-format | 補完 | docs/ 配下のフォーマットは docs-output-format が担当 |
task-questionnaire | 利用元 | qa/ 配下の質問票ファイル管理に本Skillの§4.3を使用 |
