Skip to content

refactor(docs): ideation 文書を aidlc-docs/ 配下に移動(Issue #20)#21

Merged
arashihaishima-sys merged 2 commits into
mainfrom
relocate-ideation-to-aidlc-docs
May 10, 2026
Merged

refactor(docs): ideation 文書を aidlc-docs/ 配下に移動(Issue #20)#21
arashihaishima-sys merged 2 commits into
mainfrom
relocate-ideation-to-aidlc-docs

Conversation

@arashihaishima-sys
Copy link
Copy Markdown
Collaborator

Summary

  • AI-DLC ハッカソン審査要綱「aidlc-docs の中身を見て審査します」を踏まえ、コアコンセプト文書を審査スコープ内に統合
  • docs/ideation/aidlc-docs/ideation/ に移動
  • 全 20 箇所の参照(ドキュメント 10 + Skill 定義 10)を新パスに整合化
  • マスター文書 customer_insights.md が審査者視点で発見可能な配置に

Closes #20

ベースブランチについて

本 PR は sync-persona-project-overview(PR #18)ではなく main をターゲットにしますが、ブランチ自体は PR #18 の内容を継承しています。これは PR #18customer_insights.md 編集とのコンフリクトを回避するためです。

推奨マージ順: PR #18 → PR #20(本 PR)の順でマージ

変更概要

ファイル移動(git mv で履歴保持)

Before After
docs/ideation/customer_insights.md aidlc-docs/ideation/customer_insights.md
docs/ideation/ideas.md aidlc-docs/ideation/ideas.md
docs/ideation/commercialization.md aidlc-docs/ideation/commercialization.md

docs/ ディレクトリは空になったため削除。

ドキュメント参照修正(10 箇所)

ファイル 箇所数 内容
README.md 1 L152 commercialization.md リンク
CLAUDE.md 1 L548 ドキュメント構成説明
aidlc-docs/inception/project-overview.md 5 L162, L225, L247-249(リンクパス + 表示テキスト両方)
aidlc-docs/inception/requirements/requirements.md 3 L438-440 関連ドキュメント一覧
aidlc-docs/inception/user-stories/personas.md 1 L5(リンクパス + 表示テキスト両方)

Skill 定義修正(10 箇所)

将来 ideation を再実行する際もマスター = aidlc-docs/ideation/ に統一される設計:

ファイル 箇所数
.claude/skills/ideation/step1_customer_insights.md 2
.claude/skills/ideation/step2_ideation.md 4
.claude/skills/ideation/step3_commercialization.md 4

移動の意義

観点 Before After
審査スコープ整合 コアコンセプト文書が審査スコープ外 aidlc-docs/ 配下に統合
マスター文書の発見性 customer_insights.md(マスター)が docs/ 配下で発見しづらい aidlc-docs/ideation/ で明示
ディレクトリ統一 docs/ と aidlc-docs/ の 2 系統 aidlc-docs/ 一本化
将来の ideation 再実行 docs/ideation/ に出力(審査スコープ外) aidlc-docs/ideation/ に出力(審査スコープ内)

Test plan

ファイル移動

  • aidlc-docs/ideation/ に 3 ファイル(customer_insights.md / ideas.md / commercialization.md)が配置されている
  • docs/ ディレクトリが削除されている
  • git mv による履歴保持確認(git log --follow で旧パスからの履歴追跡可能)

リンク整合性

  • grep で docs/ideation/ 参照(aidlc-docs/ideation/ の部分一致を除外)が0 件
  • ドキュメント内リンクの相対パスが正しく更新されている(../ideation/X / ../../ideation/X / aidlc-docs/ideation/X
  • 表示テキスト(マークダウン link label)も新パスに更新

Skill 定義

  • 10 箇所すべてが aidlc-docs/ideation/ に追従修正
  • 将来 ideation を再実行した際の出力先がマスター位置と整合

監査

  • audit.md に作業を追記

🤖 Generated with Claude Code

arashihaishima-sys and others added 2 commits May 10, 2026 12:23
AI-DLC ハッカソン審査要綱「aidlc-docs の中身を見て審査します」を
踏まえ、コアコンセプト文書(customer_insights / ideas / commercialization)
を審査スコープ内に移動。

特に customer_insights.md は本プロジェクトのマスター文書として
位置付けられているため、審査者が aidlc-docs/ のみを見た場合でも
発見可能な配置に。

実施内容:
- ファイル移動(git mv): 3 ファイル
  - docs/ideation/{customer_insights,ideas,commercialization}.md
    → aidlc-docs/ideation/
- ドキュメント参照修正(10 箇所):
  - README.md / CLAUDE.md / project-overview.md (5箇所)
  - requirements.md (3箇所) / personas.md (1箇所)
  - リンクパス + 表示テキストの両方を更新
- Skill 定義修正(10 箇所):
  - .claude/skills/ideation/step{1,2,3}_*.md の出力先を
    aidlc-docs/ideation/ に追従
  - 将来 ideation を再実行してもマスター = aidlc-docs/ 配下に
    統一される設計

Closes #20

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
PR #21 を再レビューし 2 件の見落としを修正。

- R0: 移動した 3 ファイル(aidlc-docs/ideation/{customer_insights,
  ideas,commercialization}.md)内の audit.md への相対パスが旧位置
  基準のまま(../../aidlc-docs/audit.md)だった → ../audit.md に修正
- R1: README.md ディレクトリ構造ツリーを実態に整合化
  - docs/ ブロック削除(既に削除済みディレクトリ)
  - aidlc-docs/ 配下に ideation/ ブロック追加
  - customer_insights.md に「(マスター)」注記追加

これで PR #21 のリンク・参照・ドキュメント構造表記がすべて新パスと
完全整合。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@arashihaishima-sys
Copy link
Copy Markdown
Collaborator Author

📝 追加コミット `caec35e` - 再レビューで発見した内部リンク・README ツリー整合化

PR #21 を再レビューし、初版コミット `f985d03` で見落としていた 2 件を修正しました。

🔹 R0: 移動した ideation 文書内の `audit.md` 相対パス(3 箇所)

git mv だけでは「移動したファイル自身の中の相対リンク」は更新されない問題:

ファイル Before After
`aidlc-docs/ideation/customer_insights.md` L3 ``../../aidlc-docs/audit.md`` ``../audit.md``
`aidlc-docs/ideation/ideas.md` L3 同上 同上
`aidlc-docs/ideation/commercialization.md` L7 同上 同上

旧位置 `docs/ideation/X.md` から見て `../../aidlc-docs/audit.md` は正しかったが、新位置 `aidlc-docs/ideation/X.md` からは `../audit.md` が正解。

🔹 R1: README.md ディレクトリ構造ツリーの実態整合化

README L80-117 のディレクトリツリーが旧構造(`docs/ideation/` 独立ブロック)のまま残っていた:

```diff
Sloth-Lab/
├── README.md
-├── docs/
-│ └── ideation/
-│ ├── customer_insights.md
-│ ├── ideas.md
-│ └── commercialization.md
├── mock/
│ └── index.html
└── aidlc-docs/
├── aidlc-state.md
├── audit.md

  • ├── ideation/ ← コアコンセプト文書
  • │ ├── customer_insights.md ← ペルソナ詳細(マスター)
  • │ ├── ideas.md
  • │ └── commercialization.md
    └── inception/
    ```

`customer_insights.md` に「(マスター)」注記を追加し、PR #18 で確立したマスター文書としての位置づけも明示。

🔹 スコープ外と判定(今回触らない)

場所 内容 理由
`CLAUDE.md` の `docs/permanent/` 言及 将来テンプレート用 本プロジェクトに存在しないパス
`.claude/commands/init-project.md` / `new-feature.md` 同上 コマンド定義のテンプレート
`aidlc-state.md` 等の「ideation 修正」履歴記述 パス参照ではなく作業履歴 修正不要

整合性最終確認

```bash
$ grep -rnE "(\.\./)docs/ideation/" --include=".md" --include="*.html" .

(no output - すべて aidlc-docs/ideation/ に整合化)

```

PR #21 これで完了です。

@arashihaishima-sys arashihaishima-sys merged commit ac32479 into main May 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

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

1 participant