ctx-handoff 0.6.0

Handoff summaries now carry most of what the next conversation needs, project notes follow what you actually care about, and rules that keep failing turn into guards Claude asks you about. Items moved into your repo no longer get stuck, and leftover /config rows are gone.

Added

• A new front page: the README opens with a banner and an animated overview, shows each feature in a picture, and moves the details into a guide.
• Changelog in Traditional Chinese: CHANGELOG.zh-TW.md, and GitHub Releases carry both languages.

Changed

• Guards ask you: a rule you had to correct again after it went into your repo (or said 3 times while keeping it out) gets a guard drafted in the background, and the next conversation has Claude ask whether to use it. Answer in the conversation; no command or panel needed. Before, you had to run /handoff guard suggest, so guards were rarely used.
• Background prompts reworded: loaded preferences say to follow them without asking again; the reply-language reminder leaves translations and English documents you asked for alone; the "said done without checking" nudge asks Claude to show what it ran and the result.
• Project notes follow your standard: decisions with their reasons (even ones already in the code) and how you like to work are kept; decisions that only matter for the task at hand go to the progress note; things already in your CLAUDE.md files aren't repeated; something Claude proposed and you just okayed is kept as a decision, not as your request. A rule's count is how many times you had to say it; Claude following it doesn't add to it.
• No length cap on the progress note: the per-field limits and the 600-character total are gone, and it now keeps the decisions that matter until the task is done.
• Handoff summaries say more: the 1800-character cap is gone. A summary now keeps the limits you set in your own words, says where the work stopped, what was already found out and how to run the tools, and gives questions waiting for you their background and options. Measured on real handoffs, it covers over 90% of what the next conversation needed, up from about half. Longer summaries take about 45 seconds to 2 minutes to write, so a handoff now waits up to 5 minutes (was 3).
• Moving rules into your repo no longer gets stuck: Claude doesn't have to report where it put a rule, procedure or guard. The next notes update sees it in the conversation and checks the file exists. If the conversation that was asked ends first, a later one is asked; there's no limit on how many times. Before, an item Claude forgot to report was never asked about again, and nothing told you.

Fixed

• Temporary errors no longer push Claude off a working approach: the repeated-failure nudge now lets Claude wait and retry once when the error looks temporary, such as a timeout or a page still loading, instead of abandoning an approach that was right.
• No leftover settings rows in /config: 0.5 moved settings to the panel, but 7 of them, including the threshold, idle minutes, notes model and language, still showed in /config. They are on the panel only now; values in settings.json still work.
• Nothing said just before a handoff is lost from project notes: if a notes update was already running when the handoff started, the conversation since that update began was never added. The handoff now captures it first and updates the notes right after the running update finishes. The handoff also no longer waits for the notes update before switching.
• A new conversation no longer gets an outdated progress note after a handoff: when the last notes update finished after the switch, the progress it found was dropped, and an older note from another conversation could be offered instead.

---

繁體中文

交接摘要現在帶得到新對話需要的大部分內容，專案筆記照你在意的標準收，寫成規則還一再犯的會變成守門、由 Claude 問你要不要用。放進 repo 的項目不再卡住，/config 的殘留設定列也清掉了。

新增

• 新的首頁： README 以 banner 和動畫概覽開場，每個功能配一張圖，細節移到使用指南。
• 繁體中文更新紀錄： CHANGELOG.zh-TW.md，GitHub Release 也同時附上兩種語言。

變更

• 守門會主動問你： 寫進 repo 之後又被你糾正的規則（或你不讓它放進 repo、卻講了 3 次的），會在背景起草守門，下一段對話由 Claude 問你要不要採用；你在對話裡回答就好，不用下指令或按面板。以前要自己打 /handoff guard suggest，所以幾乎沒人用。
• 背景提示的文字修過一輪： 帶入的偏好註明照做不用再問；回覆語言提醒不影響你要的翻譯或英文文件；「說完成卻沒驗證」要 Claude 附上跑了什麼、結果如何。
• 專案筆記照你的標準收： 有理由的決定（就算已寫進程式）與你的溝通方式會記下；只跟眼前工作有關的決定改記在進度備忘；CLAUDE.md 已經寫過的不再重複記；Claude 提議、你只說「好」的，記成決定而不是你的要求。規則的次數只算你講了幾次，Claude 照著做不會加次數。
• 進度備忘不再限字數： 拿掉每欄與整份 600 字的限制，並記下這件工作做完前要記得的決定。
• 交接摘要寫得更完整： 拿掉 1800 字上限。摘要現在用你的原話保留你訂的限制，寫出最後做到哪、已經查到的事與工具怎麼執行，等你回答的問題附上背景與選項。拿真實交接比較，新對話需要的事從寫到約一半變成九成以上。摘要變長，產生時間約 45 秒到 2 分鐘，交接最多等 5 分鐘（原本 3 分鐘）。
• 放進 repo 不會再卡住： Claude 不用另外回報規則、流程或守門放在哪，下一次整理會從對話看出來，並確認檔案存在。被交代的那段對話先結束的話，之後的對話會再被請一次，沒有次數限制。以前 Claude 忘了回報的項目就再也不會被提起，你也不會知道。

修正

• 暫時性錯誤不再被當成要換做法： 同一個工具連續失敗時的提醒，現在會讓 Claude 對逾時、頁面還在載入這類暫時性錯誤稍等再試一次，而不是放棄本來正確的做法。
• /config 不再出現殘留的設定列： 0.5 已把設定搬到面板，但門檻、閒置分鐘數、整理模型、介面語言等 7 項仍留在 /config。現在只在面板調；settings.json 裡寫的值照樣有效。
• 交接前最後說的話不會再漏記進專案筆記： 交接開始時若已有一次整理在跑，從那次整理開始到交接之間的對話永遠不會被整理。現在交接會先把這段讀好，等正在跑的整理結束就接著整理；交接也不再等整理才換對話。
• 交接後的新對話不會再拿到過時的進度備忘： 最後一次整理在換對話之後才跑完時，它整理出的進度會被丟掉，新對話可能反而拿到另一段對話留下的舊備忘。

Full changelog / 完整差異： ctx-handoff--v0.5.0...ctx-handoff--v0.6.0