Skip to content

ideation 文書を aidlc-docs/ 配下に移動(審査スコープ整合化) #20

@arashihaishima-sys

Description

@arashihaishima-sys

背景

AI-DLC Workflow ハッカソンの審査要綱に以下の記載がある:

Q: AI-DLC Workflow はカスタマイズしても良いですか?
A: はい、カスタマイズは問題ありません。aidlc-docs の中身を見て審査します。

現状、コアコンセプト級の重要文書(customer_insights.md / ideas.md / commercialization.md)が docs/ideation/ に配置されており、aidlc-docs/ 配下にない。審査者が aidlc-docs/ のみを見た場合、これらの文書を見落とすリスクがある。

課題

提案

docs/ideation/aidlc-docs/ideation/ に移動:

[Before]                          [After]
docs/                             aidlc-docs/
└── ideation/                     ├── ideation/                ← 移動
    ├── customer_insights.md      │   ├── customer_insights.md
    ├── ideas.md                  │   ├── ideas.md
    └── commercialization.md      │   └── commercialization.md
                                  ├── inception/               ← 既存
                                  ├── aidlc-state.md
                                  └── audit.md

影響範囲(事前調査)

docs/ideation/(customer_insights|ideas|commercialization) への参照を grep した結果:20 箇所

修正必須(ドキュメント内の参照)― 10 箇所

ファイル 内容
README.md 152 docs/ideation/commercialization.md リンク
aidlc-docs/inception/project-overview.md 162 customer_insights.md リンク(ペルソナ詳細)
aidlc-docs/inception/project-overview.md 225 ideas.md リンク(§4 参照)
aidlc-docs/inception/project-overview.md 247-249 関連ドキュメント一覧 3 リンク
aidlc-docs/inception/requirements/requirements.md 438-440 関連ドキュメント 3 リンク
aidlc-docs/inception/user-stories/personas.md 5 customer_insights.md リンク

検討要(Skill 定義の参照)― 10 箇所

ファイル 内容
.claude/skills/ideation/step1_customer_insights.md 36, 47 出力先を docs/ideation/customer_insights.md に指定
.claude/skills/ideation/step2_ideation.md 8, 11, 40, 52 入力/出力先を docs/ideation/ に指定
.claude/skills/ideation/step3_commercialization.md 8, 11, 51, 64 入力/出力先を docs/ideation/ に指定

→ Skill 定義は将来の Ideation 再実行時の出力先指定。docs/ideation/ のままにするか、aidlc-docs/ideation/ に追従させるかは別判断。

実行手順

  1. mkdir aidlc-docs/ideation/
  2. git mv docs/ideation/*.md aidlc-docs/ideation/
  3. rmdir docs/ideation/ (docs/ 配下に他がなければ docs/ も削除)
  4. ドキュメント内の参照 10 箇所を git mv 後の相対パスに置換
  5. Skill 定義 10 箇所の出力先パスを更新(または別 Issue で議論)
  6. リンク切れがないか grep で再確認
  7. mkdocs / docusaurus 等のサイトジェネレータがあれば設定確認(現状なし)

受入条件

  • docs/ideation/ が削除されている
  • aidlc-docs/ideation/ に 3 ファイル(customer_insights.md / ideas.md / commercialization.md)が配置されている
  • ドキュメント内の参照 10 箇所がすべて新パスに更新されている
  • grep で docs/ideation/ への参照がドキュメントに残っていない(Skill 定義は別判断)
  • audit.md に作業を追記

関連

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions