STATE
現在地
現状、正直な健全性、次に着手する場所をひと目で。
AI AGENT WORK RECORDER · OPEN SOURCE
AI エージェントに新しい作業計画を提出させる必要はありません。まず仕事を進める。flightwake が要所で状態、意思決定、根拠を残し、次のセッションへの安全な引き継ぎを支えます。
01 / THE GAP
セッションの推論は終わっても、リポジトリの仕事は続きます。次のエージェントが進捗、未検証の箇所、選択の理由を推測し直すことが、本当の負担です。
STATE
現状、正直な健全性、次に着手する場所をひと目で。
RECORDS
意味のある区切りごとに変更と検証の根拠を残します。
DECISIONS + TRAPS
別の選択肢を退けた理由と、実際に遭遇した意外な罠を記録します。
記録は仕事の後を追う。仕事を先導しない。
維持すべき計画を減らし、たどれる航跡を増やす。02 / ONE CONTINUOUS LOOP
新しいセッションは STATE と最新の record を読みます。根拠がなければ健全性を緑と決めつけません。
/fw-coldstart選択肢を狭める判断には理由を一行。意外な問題に出会ったら、すぐ TRAPS に残します。
DECISIONS + TRAPS重要な作業の終わりにテスト、リスク、次の一手を記録。STATE は短く正確に保ちます。
/fw-recordClaude Code、Codex、Gemini CLI は同じリポジトリの航跡を読みます。特定のチャット画面には依存しません。
git + Markdown03 / 0.16.0 / ACTUAL OUTPUT
0.16.0 では任意の追加機能を対話式セットアップにまとめ、Claude Code mod 0.2.0 にコストとセッション状態を追加しました。以下は隔離したテストリポジトリで実行したコマンドの抜粋です。端末の枠はサイト用に整え、一時パスは伏せています。
The core (records, the four skills, the wrap-up hook) is always installed. Optional add-ons — * = recommended:
[*] 1) Bottom gauge in Claude Code (health / STATE lag / context usage)
[*] 2) Claude Code mod — inside Claude Code: a status row above the prompt, STATE loaded when a session starts, a log of this session's changes and test runs (/fw-log), a hint when you touch something a known trap mentions, and an optional role guard.
Needs Claude Code 2.1.287 or later. It loads in a Claude Code session started from the repo root, after you accept the folder trust prompt — a session that is already open needs a restart.
[ ] 3) Team roles (installs only the fw-roles skill; your agent recommends roles later, nothing applied yet)
Enter = the * ones · or type the numbers you want (e.g. 1 2) · 0 = none:setup は下部ステータス表示と mod を別々に示し、推奨項目と書き込み先を確認できます。
flightwake-mod v0.2.0
STATE at session start (stateInject): on — STATE is not initialized yet, so only a "run /fw-coldstart" note is injected
band above the prompt (band): on — hiding the fields the bottom gauge already shows; only the one-time 80% context toast remains
session flight log (recorder): on — this session: 0 file(s) by tools, 0 via shell (inferred), 0 test run(s), 0 commit(s) — /fw-log prints them
trap tripwire (tripwire): idle — no active TRAPS entry has paths or commands
role guard (roleGuard): off — opt-in
tokens and cost (spend): on — this session: tokens unknown · API-equivalent ≈ $0.00 — /fw-cost prints the breakdown
session fleet (fleet): on — this session is reported as idle in [isolated test sessions] (heartbeat 30 s; never prompt or command text)
Read-only: /fw-mod changes nothing.Claude Code で /fw-mod を実行すると、各機能の状態と理由が見えます。下部ステータス表示が有効なら、mod の上部表示は重複を避けます。
flightwake fleet — 2 live · ⛔ 1 blocked — [isolated test sessions] (last 7 days)
⛔ blocked demo-review demo-re… 21s permission · Bash
● working demo-build demo-bu… 14s Read src/app.tsFleet は応答待ちのセッションを先に表示します。実際の CLI にテスト用セッションデータを与えた出力です。
setup はテストドライバーから回答を渡して実際の処理を実行し、/fw-mod は Claude Code の対話セッションで実行。Fleet は公開 CLI にテストデータを読み込ませました。抜粋を整形し一時パスを伏せています。実ユーザーデータは含みません。権限ダイアログと異常終了後の再開には未検証の場面があります。
04 / FIELD NOTES / ORCA × FLIGHTWAKE
このプロジェクトは flightwake を自分自身で使っています。Orca は並行した議論とレビューを見えるタブに置き、flightwake は採用した知見、テスト、未解決事項をリポジトリに戻します。
ORCA / 見える協業
複数のエージェントが Fleet、導入フロー、境界条件を分担して確認。担当者が結果を統合し、検査を再実行しました。
FLIGHTWAKE / 共有記憶
レビュアーは各自で STATE を書き換えません。担当者が採用した結果を record に残し、次のセッションが同じ場所から始めます。
実際の結果 / 2026.10
46 項目の smoke と 465 件の mod テストが通過。一方で Fleet の実セッション検証が必要な場面も明記しました。
* Orca は任意の協業ツールで、flightwake の必須条件ではありません。Fleet は 0.16.0 で公開済みですが、一部の実セッションでの動作は未検証です。
もう一つの現場 / 匿名のプロダクトチーム
一方のリポジトリで製品判断を、もう一方で開発を進めます。Orca はエージェントの協業を見える形にし、flightwake は両方に現状、引き継ぎ、検証の境界を残します。
製品担当のエージェントが目標と受け入れ条件を定め、限定的な計画を承認して開発を依頼します。
技術担当のエージェントが実装方針と境界を見直し、前提を検証します。
開発担当のエージェントが製品リポジトリで実装し、ローカルテストと型検査を実行。未確定の変更を記録します。
実装確定後にレビューとセキュリティ担当が独立して確認します。それまでは作業中のままです。
2026.10 時点:実装中、独立レビューは未完了。製品の受け入れや公開は宣言していません。
05 / WHAT YOU GET
別のデータベースは不要。STATE、records、判断、落とし穴をリポジトリに保存。
Claude Code、Codex、Gemini CLI にそれぞれの skill と終了時 hook。同じ作業記録を共有します。
開始、判断、意外な問題、終了の場面だけで動き、日常の作業を申請書にしません。
対話式 setup が言語、エージェント、任意の追加機能、書き込み先を先に表示します。
doctor は導入構成を検査。STATE の health は検証済みと未検証を正直に示します。
ステータス表示、Orca 指示、チームの役割、Claude Code mod は任意です。
06 / START HERE
Git と Node.js 18 以上が必要です。setup は言語、エージェント、任意の追加機能、リポジトリの種類を確認し、書き込み先をすべて提示してから導入します。
導入ガイドを読む ↗$ cd your-repo
$ npx flightwake setup$ npx flightwake init --lang=ja --agents=claude,codex,gemini導入後、リポジトリでエージェントのセッションを開き、対応する coldstart skill を実行します。以後は出来事に応じて記録します。
導入済みなら npx flightwake update を実行。Claude Code mod の追加は npx flightwake update --mod。
07 / FAQ
いいえ。作業を記録する枠組みです。エージェントは直接仕事を進め、開始、判断、意外な問題、終了時に次のセッションが引き継ぐための情報を保存します。
いいえ。Claude Code、Codex、Gemini CLI に対応しています。Orca 連携と Claude Code mod は任意です。
主なデータは .flightwake/STATE.md や records/ など、リポジトリ内の Markdown です。flightwake のクラウドアカウントや実行時パッケージ依存は不要です。
はい。0.16.0 は npm に公開済みです。対話式セットアップの改善と、任意の Claude Code mod 0.2.0 を含みます。Fleet の一部の実セッションでの動作は未検証です。
npx flightwake update を実行します。既存の設定と .flightwake のユーザーデータを保持し、任意の追加機能を自動導入することはありません。