refactor(docs): ideation 文書を aidlc-docs/ 配下に移動(Issue #20)#21
Merged
Conversation
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>
Collaborator
Author
📝 追加コミット `caec35e` - 再レビューで発見した内部リンク・README ツリー整合化PR #21 を再レビューし、初版コミット `f985d03` で見落としていた 2 件を修正しました。 🔹 R0: 移動した ideation 文書内の `audit.md` 相対パス(3 箇所)git mv だけでは「移動したファイル自身の中の相対リンク」は更新されない問題:
旧位置 `docs/ideation/X.md` から見て `../../aidlc-docs/audit.md` は正しかったが、新位置 `aidlc-docs/ideation/X.md` からは `../audit.md` が正解。 🔹 R1: README.md ディレクトリ構造ツリーの実態整合化README L80-117 のディレクトリツリーが旧構造(`docs/ideation/` 独立ブロック)のまま残っていた: ```diff
`customer_insights.md` に「(マスター)」注記を追加し、PR #18 で確立したマスター文書としての位置づけも明示。 🔹 スコープ外と判定(今回触らない)
整合性最終確認```bash (no output - すべて aidlc-docs/ideation/ に整合化)``` PR #21 これで完了です。 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/ideation/をaidlc-docs/ideation/に移動customer_insights.mdが審査者視点で発見可能な配置にCloses #20
ベースブランチについて
本 PR は
sync-persona-project-overview(PR #18)ではなくmainをターゲットにしますが、ブランチ自体は PR #18 の内容を継承しています。これは PR #18 のcustomer_insights.md編集とのコンフリクトを回避するためです。推奨マージ順: PR #18 → PR #20(本 PR)の順でマージ
変更概要
ファイル移動(git mv で履歴保持)
docs/ideation/customer_insights.mdaidlc-docs/ideation/customer_insights.mddocs/ideation/ideas.mdaidlc-docs/ideation/ideas.mddocs/ideation/commercialization.mdaidlc-docs/ideation/commercialization.mddocs/ディレクトリは空になったため削除。ドキュメント参照修正(10 箇所)
README.mdCLAUDE.mdaidlc-docs/inception/project-overview.mdaidlc-docs/inception/requirements/requirements.mdaidlc-docs/inception/user-stories/personas.mdSkill 定義修正(10 箇所)
将来 ideation を再実行する際もマスター =
aidlc-docs/ideation/に統一される設計:.claude/skills/ideation/step1_customer_insights.md.claude/skills/ideation/step2_ideation.md.claude/skills/ideation/step3_commercialization.md移動の意義
Test plan
ファイル移動
aidlc-docs/ideation/に 3 ファイル(customer_insights.md / ideas.md / commercialization.md)が配置されているdocs/ディレクトリが削除されているgit log --followで旧パスからの履歴追跡可能)リンク整合性
docs/ideation/参照(aidlc-docs/ideation/ の部分一致を除外)が0 件../ideation/X/../../ideation/X/aidlc-docs/ideation/X)Skill 定義
aidlc-docs/ideation/に追従修正監査
audit.mdに作業を追記🤖 Generated with Claude Code