Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[Bug]: Auto-restart is documented as `claude -c` (conversation kept) but the default is a fresh session (FW_RESTART_MODE=fresh, T-3166)

オープン 初心者向け
  • 何か問題がありますか？
#95 コメント 4 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
78/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
shell
領域
cli, documentation

調査の方向性

lib/templates/claude-project.md の Auto-Restart セクションを読み、その記述を bin/claude-fw:1432 のデフォルト設定と比較します。次に、bin/claude-fw、docs/harnesses.md、docs/context-compaction.md、agents/context/post-compact-resume.sh に記載された参照先を確認します。説明を更新し、新規セッションのデフォルトと FW_RESTART_MODE=continue について明記します。引用されたすべてのドキュメントがラッパーの動作と一致し、空の会話が想定されていることを説明していれば完了です。

索引モデルが issue の本文から書いたものです。

説明

area:docs bug severity:medium status:in-progress triaged
Bug Description

Since T-3166 the budget-critical auto-restart starts a FRESH session by default (bin/claude-fw:1432, ${FW_RESTART_MODE:-fresh}): new transcript, seeded from the handover only, SessionStart source startup. The documents that describe the restart still say claude -c, i.e. the conversation is continued:

  • lib/templates/claude-project.md:875: "the wrapper detects this signal on exit and auto-restarts with claude -c. The SessionStart:resume hook then injects handover context into the fresh session."
  • lib/templates/claude-project.md:877: "Flow: Budget critical → auto-handover → signal file → claude exits → wrapper detects → sleep 3 → claude -c → context injected → /resume ready."
  • bin/claude-fw:6: "If found (and fresh), auto-restarts with claude -c to continue."
  • docs/harnesses.md:59: "claude-fw restarts with claude -c after a handover signal."
  • docs/context-compaction.md:88: "Same as above — claude -c re-injects via the same truncated path."
  • agents/context/post-compact-resume.sh:8: "After claude -c (session continuation, including auto-restart via T-179)"

The template matters most: it becomes the agent's operating instructions (CLAUDE.md) in every consumer project. FW_RESTART_MODE itself appears only in bin/claude-fw and in one runbook (docs/runbooks/arc-012-continuous-mode-live-fire.md:39), so a consumer cannot learn that the choice exists.

Steps to Reproduce
  1. grep -n 'claude -c' lib/templates/claude-project.md bin/claude-fw docs/harnesses.md docs/context-compaction.md agents/context/post-compact-resume.sh
  2. grep -n 'FW_RESTART_MODE' bin/claude-fw
  3. Live: start a session with claude-fw, no FW_RESTART_MODE set, and let it reach the budget cap.

Steps 1 and 2 were run on 1.8.6 and again on 1.8.11 (e42aa41bf). Step 3 was observed once on 1.8.6.

Expected Behavior

The template and the other documents describe what the wrapper does by default: a new session seeded from the handover, the previous conversation not in context (it can be reopened with claude --resume), and FW_RESTART_MODE=continue as the documented way to keep the transcript at the price of not freeing the context.

Actual Behavior

The operator came back to an empty conversation and asked whether it was a bug. The agent's instructions said the restart used claude -c, so the agent had no reason to expect an empty conversation either. The only place the real mode is named is one banner line ("Restart mode: fresh (new session, seeded from the handover)") printed during the three-second cancel window.

fw doctor output
AI Agent

Claude Code

Operating System

Linux

Additional Context

Version: 1.8.11 (e42aa41bf), vendored consumer. First observed on 1.8.6; every quoted line is still present in 1.8.11 (only line numbers moved). Outside bin/claude-fw, FW_RESTART_MODE is only mentioned in that runbook and in an internal report (docs/reports/T-3181-continuous-run-model-refinement.md).

The restart itself worked as designed; nothing was lost. This report is about the description only.

Suggestions:

  1. Rewrite the "Auto-Restart" section of the template for the fresh default, and document FW_RESTART_MODE.
  2. Fix the header of bin/claude-fw, the header of post-compact-resume.sh, docs/harnesses.md:59 and docs/context-compaction.md:88 the same way.
  3. Say in the template what the operator sees: an empty conversation is the expected result, not a loss.
主要言語
Shell
スター
16
フォーク
6
平均マージ
6時間 24分
マージ済み PR（30日）
5

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

DimitriGeelen/agentic-engineering-framework のほかの issue

DimitriGeelen/agentic-engineering-framework の issue をすべて見る

似ている issue

Shell/Bash の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。