AI AGENT WORK RECORDER · OPEN SOURCE

仕事は先へ。
航跡は残る。

AI エージェントに新しい作業計画を提出させる必要はありません。まず仕事を進める。flightwake が要所で状態、意思決定、根拠を残し、次のセッションへの安全な引き継ぎを支えます。

npm 公開版 0.16.0導入フローを改善 · Claude Code mod 0.2.0

01 / THE GAP

モデルの文脈には限界がある。プロジェクトにはない。

セッションの推論は終わっても、リポジトリの仕事は続きます。次のエージェントが進捗、未検証の箇所、選択の理由を推測し直すことが、本当の負担です。

STATE

現在地

現状、正直な健全性、次に着手する場所をひと目で。

RECORDS

何をしたか

意味のある区切りごとに変更と検証の根拠を残します。

DECISIONS + TRAPS

理由と落とし穴

別の選択肢を退けた理由と、実際に遭遇した意外な罠を記録します。

記録は仕事の後を追う。仕事を先導しない。

維持すべき計画を減らし、たどれる航跡を増やす。

02 / ONE CONTINUOUS LOOP

「始めよう」と言うだけ。あとは出来事が記録を生む。

01 / 開始

状態を読み、安全に引き継ぐ

新しいセッションは STATE と最新の record を読みます。根拠がなければ健全性を緑と決めつけません。

/fw-coldstart
02 / 作業中

進めながら手がかりを残す

選択肢を狭める判断には理由を一行。意外な問題に出会ったら、すぐ TRAPS に残します。

DECISIONS + TRAPS
03 / 終了

根拠を次へ渡す

重要な作業の終わりにテスト、リスク、次の一手を記録。STATE は短く正確に保ちます。

/fw-record
04 / 続行

モデルを替えても続けられる

Claude Code、Codex、Gemini CLI は同じリポジトリの航跡を読みます。特定のチャット画面には依存しません。

git + Markdown
START
CONTINUE ↗

03 / 0.16.0 / ACTUAL OUTPUT

Claude Code では実際に何が見える?

0.16.0 では任意の追加機能を対話式セットアップにまとめ、Claude Code mod 0.2.0 にコストとセッション状態を追加しました。以下は隔離したテストリポジトリで実行したコマンドの抜粋です。端末の枠はサイト用に整え、一時パスは伏せています。

FLIGHTWAKE · FIELD CAPTURE01 / 03
npx flightwake setup
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:
01 / SETUP

導入前に確認

setup は下部ステータス表示と mod を別々に示し、推奨項目と書き込み先を確認できます。

FLIGHTWAKE · FIELD CAPTURE02 / 03
/fw-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.
02 / CLAUDE CODE

7 機能の状態を確認

Claude Code で /fw-mod を実行すると、各機能の状態と理由が見えます。下部ステータス表示が有効なら、mod の上部表示は重複を避けます。

FLIGHTWAKE · FIELD CAPTURE03 / 03
npx flightwake fleet --lang=en
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.ts
03 / FLEET

応答待ちを先に表示

Fleet は応答待ちのセッションを先に表示します。実際の CLI にテスト用セッションデータを与えた出力です。

setup はテストドライバーから回答を渡して実際の処理を実行し、/fw-mod は Claude Code の対話セッションで実行。Fleet は公開 CLI にテストデータを読み込ませました。抜粋を整形し一時パスを伏せています。実ユーザーデータは含みません。権限ダイアログと異常終了後の再開には未検証の場面があります。

04 / FIELD NOTES / ORCA × FLIGHTWAKE

複数のエージェントが働くとき、全体像はどこに残る?

このプロジェクトは flightwake を自分自身で使っています。Orca は並行した議論とレビューを見えるタブに置き、flightwake は採用した知見、テスト、未解決事項をリポジトリに戻します。

CASE STUDY · FLIGHTWAKE REPOSITORY 2026.10
01

並行作業とレビュー

複数のエージェントが Fleet、導入フロー、境界条件を分担して確認。担当者が結果を統合し、検査を再実行しました。

02

記録者は一人、事実は一つ

レビュアーは各自で STATE を書き換えません。担当者が採用した結果を record に残し、次のセッションが同じ場所から始めます。

03

根拠も、未完了も残す

46 項目の smoke と 465 件の mod テストが通過。一方で Fleet の実セッション検証が必要な場面も明記しました。

実際の作業記録を読む ↗ORCA × FLIGHTWAKE

* Orca は任意の協業ツールで、flightwake の必須条件ではありません。Fleet は 0.16.0 で公開済みですが、一部の実セッションでの動作は未検証です。

もう一つの現場 / 匿名のプロダクトチーム

2 つのリポジトリ、4 つの役割、たどれる 1 本の作業線。

一方のリポジトリで製品判断を、もう一方で開発を進めます。Orca はエージェントの協業を見える形にし、flightwake は両方に現状、引き継ぎ、検証の境界を残します。

01 / プロダクト担当

定義して依頼

製品担当のエージェントが目標と受け入れ条件を定め、限定的な計画を承認して開発を依頼します。

02 / 技術担当

リスクを検討

技術担当のエージェントが実装方針と境界を見直し、前提を検証します。

03 / 開発担当

実装と自己テスト

開発担当のエージェントが製品リポジトリで実装し、ローカルテストと型検査を実行。未確定の変更を記録します。

04 / 独立レビュー

検証してから受け入れ

実装確定後にレビューとセキュリティ担当が独立して確認します。それまでは作業中のままです。

2026.10 時点:実装中、独立レビューは未完了。製品の受け入れや公開は宣言していません。

05 / WHAT YOU GET

軽いから、使い続けられる。

01

git 内の Markdown

別のデータベースは不要。STATE、records、判断、落とし穴をリポジトリに保存。

02

3 種類のコーディングエージェント

Claude Code、Codex、Gemini CLI にそれぞれの skill と終了時 hook。同じ作業記録を共有します。

03

出来事に応じた規律

開始、判断、意外な問題、終了の場面だけで動き、日常の作業を申請書にしません。

04

確認してから導入

対話式 setup が言語、エージェント、任意の追加機能、書き込み先を先に表示します。

05

読み取り専用の健全性確認

doctor は導入構成を検査。STATE の health は検証済みと未検証を正直に示します。

06

必要な協業機能だけ追加

ステータス表示、Orca 指示、チームの役割、Claude Code mod は任意です。

06 / START HERE

あなたのリポジトリで、いくつかの質問に答えるだけ。

Git と Node.js 18 以上が必要です。setup は言語、エージェント、任意の追加機能、リポジトリの種類を確認し、書き込み先をすべて提示してから導入します。

導入ガイドを読む ↗
01 / 対話式セットアップ
$ cd your-repo
$ npx flightwake setup
02 / 自動化 / 非対話
$ npx flightwake init --lang=ja --agents=claude,codex,gemini

導入後、リポジトリでエージェントのセッションを開き、対応する coldstart skill を実行します。以後は出来事に応じて記録します。

導入済みなら npx flightwake update を実行。Claude Code mod の追加は npx flightwake update --mod。

07 / FAQ

よくある質問

flightwake が作業計画を立てますか?

いいえ。作業を記録する枠組みです。エージェントは直接仕事を進め、開始、判断、意外な問題、終了時に次のセッションが引き継ぐための情報を保存します。

Orca や Claude Code は必須ですか?

いいえ。Claude Code、Codex、Gemini CLI に対応しています。Orca 連携と Claude Code mod は任意です。

データはどこに保存されますか?クラウドは必要ですか?

主なデータは .flightwake/STATE.md や records/ など、リポジトリ内の Markdown です。flightwake のクラウドアカウントや実行時パッケージ依存は不要です。

0.16.0 はもう導入できますか?

はい。0.16.0 は npm に公開済みです。対話式セットアップの改善と、任意の Claude Code mod 0.2.0 を含みます。Fleet の一部の実セッションでの動作は未検証です。

既存の導入を更新するには?

npx flightwake update を実行します。既存の設定と .flightwake のユーザーデータを保持し、任意の追加機能を自動導入することはありません。