讓 AI 先讀懂資料夾，再開始動手

文章草稿，待作者實測。前置：Day 02 的兩份文件、可啟動的 Claude Code。

今天遇到的問題

如果一開始就說「幫我完成股票研究工具」，AI 可能直接建立很多檔案。對新手來說，結果越多不一定越容易理解。我想先知道：它到底讀了什麼，哪些內容是檔案證據，哪些只是推測？

一個核心概念：依據檔案回答

檔案提到「未來要支援 SQLite」，不表示現在已經有資料庫。看專案時，要區分需求、實作、測試與輸出；這個習慣會一路用到全市場資料完整度檢查。

實作：只讀的專案地圖

在工作台啟動 Claude Code，貼上：

先閱讀 project-goal.md 與 docs/PROJECT-BRIEF.md。
今天只讀，不建立或修改檔案，不安裝套件，不連線查股價。
請列出：
1. 目前實際存在的文件或程式。
2. 規格希望有、但尚未實作的功能。
3. 從需求無法判定、需要之後驗證的事情。
每項指出檔名；找不到證據就寫「尚未確認」。
最後用我能理解的文字說明今天的資料夾用途。

把回答和自己看到的資料夾核對。確認沒有憑空多出 API、網站或資料表後，把整理好的內容自行保存成 docs/project-map.md。

可以追問：「你說有研究報告功能，證據是程式，還是只有規格？」這不是挑錯，而是在建立自己的檢查方法。

一個失敗案例

AI 讀到規格裡的 research report 就說「執行這個指令即可」，但指令尚未實作。請它重新標示 planned 和 implemented，並說明如何判斷。

當日驗收

• [ ] 專案地圖能對應實際檔案。
• [ ] 計畫中的五個 CLI 沒被誤寫成已完成。
• [ ] 找到至少一項需要未來實測的前提。

實測後補：摘錄一段需要追問的回答，以及追問後改善的版本。

下一天預告

明天把願望改寫成具體任務，讓 AI 的成果可以被驗收。