flightwake：替 AI 開發留下飛行紀錄
flightwake 是一套給 AI coding agent 使用的輕量工作紀錄框架。它不要求先寫完整計畫，而是在工作進行後，把目前狀態、技術決策、踩雷經驗與驗證結果保存成 Markdown，再跟著 Git 一起版本控制。核心技術很樸素：Node.js 安裝器、Claude Code Skills、Stop hook 與純文字檔案；實際效果是讓 Claude Code、Codex、Gemini 或下一位工程師接手時，不必重新翻 commits 猜前因後果。
現實應用
最適合需要跨多個 AI session 開發的專案，尤其是重構、除錯、維運與同時改動多個服務的工作。個人開發者可以拿它避免 context 清空後失憶；小型團隊則能把 AI 做過的決策與陷阱放進 repo，讓人類和不同 agent 共用同一份狀態。
它建立 STATE.md、DECISIONS.md、TRAPS.md 與 records/：開工先讀狀態，遇到重要決策或非直覺問題就追加紀錄，收工時更新接手位置。若 STATE 落後 Git 三個 commits，Stop hook 會提醒補紀錄；也可在 CI 執行同一檢查。
期望評估
我認為低標期望很實際：即使 agent 沒有完全遵守流程，至少仍會得到一份可搜尋、可 diff、可隨 repo 攜帶的交接紀錄，降低重複探索程式碼與再次踩坑的成本。
高標方面，我猜成熟團隊若能穩定維護 STATE 與決策紀錄，新 session 有機會在數分鐘內安全接手，並讓不同 AI 工具輪替工作。不過這不是自動產生正確文件的魔法；紀錄品質仍取決於 agent 是否誠實更新，過期內容也需要定期整理。
商業策略分析
它影響的不是模型能力，而是 AI 開發工作流與知識交接工具。對 Claude Code 外掛、agent orchestration、工程知識庫及開發治理產品來說，flightwake 示範了一條低成本路線：先用 repo 內的開放格式解決狀態共享，不急著導入資料庫或 SaaS。
我認為值得跟進，但現階段更適合試用而非直接列為公司標準。專案仍是 v0.x、慣例可能調整；優點則是 MIT 授權、資料格式透明且容易移除，導入風險不高。若團隊已經有 ADR、runbook 或 GSD 流程，應先界定各自責任，避免重複維護。
實作細節
在 Git repo 根目錄執行 npx flightwake init，需要 Node.js 18 以上；升級既有安裝可加 --force。安裝器會建立 .flightwake/、複製四個 skills、合併 Claude Code 設定，並在 CLAUDE.md、AGENTS.md 或 GEMINI.md 加入觸發規則。日常以 /fw-coldstart 開工、/fw-record 收尾，跨 session 時使用 /fw-handoff；另有 --private 與選用的 --statusline 模式。
目前模板與 CLI 主要是繁體中文，英文預設仍在規劃。Stop hook 只直接作用於 Claude Code，其他 agent 要靠指令規則或 CI 檢查；高流量 monorepo 也可能需要調整落後門檻。