前導完成檢查表

1. 已完成

• 架構方向文件已拆分完成。
• 第一階段開工規格文件已拆分完成。
• Repository 分工已決定採用方案 B：文件 repo 與程式 repo 分開。
• 目前 repo 名稱已決定為 hs-device-control-template-docs。
• 未來程式碼 repo 名稱已建議為 hs-device-control-template。
• GitHub repository 已建立並推送：Hongsen-tw/hs-device-control-template-docs。
• Cloudflare Pages 正式文件網站已發布：https://hs-device-control-template-docs.pages.dev/
• 原始完整計畫書已移至 archive/舊版計畫書/。
• 文件首頁 index.html 已建立。
• 文件已整理為響應式網頁，支援手機閱讀。
• 文件已加入列印 / 匯出 PDF 按鈕。
• 第一階段技術基底已決定為 .NET 5.0。
• 第一階段測試框架已決定為 xUnit。
• 第一階段主要 Host 已決定為 ConsoleHost。
• 第一階段設備實作已決定先用 Mock Adapter。
• 第一階段 Log 策略已決定為 Interface + FileLogWriter / ConsoleLogWriter / MemoryLogWriter。
• 第一個代表流程已決定為「燈號導引 + Sensor 驗證」。
• AGENTS.md 已擴充為正式專案 AI 開發規範。
• 對話規則已納入 AGENTS.md：回答問題、完成分析或完成工作後，主動詢問下一步。

2. 已確認的第一階段 MVP

• C# Solution 與基本專案結構。
• HS.DeviceControl.Core
• HS.DeviceControl.Adapters
• HS.DeviceControl.ConsoleHost
• HS.DeviceControl.Core.Tests
• HS.DeviceControl.Adapters.Tests
• HS.DeviceControl.WorkflowSimulation.Tests
• WorkflowNode / WorkflowEngine。
• StateMachine / TaskEngine。
• IDeviceAdapter 與 Mock Adapter。
• 標準 Result / ErrorInfo / ErrorCode。
• FileLogWriter / ConsoleLogWriter / MemoryLogWriter。
• devices.json / workflows.json / appsettings.json 範例。
• Config Validator。
• 單元測試與流程模擬測試。
• README.md 初版。
• AGENTS.md 初版。

3. 已確認的第一階段不做事項

• 不接真實硬體。
• 不做完整 WinForms Debug Tool。
• 不做正式 Web UI。
• 不做中央 Server。
• 不做多案場管理。
• 不做報表與統計分析。
• 不導入正式資料庫。
• 不做完整權限系統。
• 不把案場客製邏輯寫入共用 Core。

4. 待確認

• 是否要立即建立未來程式碼 repo hs-device-control-template。
• 是否要立即建立實際 C# Solution。
• README.md 是否要現在建立。
• 第一階段是否需要建立 docs/ 資料夾並放入 HTML / Markdown 文件。
• promt 資料夾是否要整理、重新命名為 prompt，或移入 archive。
• 是否需要把目前 HTML 文件另存成 Markdown 版本，方便 Git diff 與後續維護。
• 是否需要匯出 PDF 版給主管或團隊確認。

5. 建議補強

• 建立 README.md，作為工程師快速進入專案的入口。
• 建立 docs/ 資料夾，集中放架構方向、開工規格、Prompt Library、錯誤代碼表、Log 格式說明。
• 建立 docs/prompt-library.md，避免 Prompt 範例散落。
• 建立 docs/error-codes.md，讓錯誤碼可獨立維護。
• 建立 docs/log-format.md，明確定義 Log 欄位。
• 建立 docs/workflow-schema.md，明確定義 workflows.json。
• 建立 docs/config-schema.md，明確定義 devices.json / appsettings.json。

6. 開工前建議順序

1. 確認本檢查表。
2. 建立 README.md。
3. 整理 docs/ 文件資料夾。
4. 建立 C# Solution 與專案骨架。
5. 建立 Core 模型與 Result / ErrorCode。
6. 建立 WorkflowEngine / StateMachine / TaskEngine。
7. 建立 Mock Adapter。
8. 建立 ConsoleHost 代表流程。
9. 建立測試矩陣對應的 xUnit 測試。
10. 驗收第一階段 MVP。