Imported from takushio2525/tako (
AGENTS.md). Install upstream withnpx skills add takushio2525/tako. Copyright stays with the author.
tako — エージェント向けガイド
AI 駆動・エージェント集約監視に特化した OSS GUI ターミナル。 iTerm2 + Zed の思想で Zed 級に高速・軽量。macOS 先行、Windows 対応必須。GPL-3.0-or-later。
このリポジトリの AI 向け規約はここに集約してある。詳細仕様は
.agent/を参照。 人間向けの説明はREADME.mdにある。
概要
- 目的: AI エージェント（Claude Code 等）+ 子エージェント + dev サーバーを「1 グループ = 1 タブ」で集約監視する
- 対象: AI エージェントで開発する開発者。ただしゼロコンフィグで一般ユーザーが使えることが最優先の設計原則
- 状況: 公開済み OSS（v0.8.x）。macOS は Homebrew cask + GitHub Releases で配布中、
Windows 本格対応（Phase 6）が進行中。フェーズ進捗は
.agent/roadmap.md、現在地は.agent/activeContext.md
技術スタック
| 領域 | 採用 | 補足 |
|---|---|---|
| 言語 | Rust | |
| UI | GPUI（Zed 製） | pre-1.0・破壊的変更頻発・Windows 対応進行中。リスクと対策は .agent/architecture.md |
| ターミナル | alacritty_terminal | |
| テスト / Lint | cargo test / fmt + clippy（-D warnings） | コード着手後に CI 化 |
ディレクトリ規約
tako/
├── AGENTS.md / CLAUDE.md ← AI 向け規約（このファイル）
├── .agent/ ← AI 向け詳細仕様（下記参照）
├── README.md / LICENSE ← 人間向け・GPL-3.0-or-later
├── crates/
│ ├── tako-core/ ← ドメインモデル（PaneTree / Workspace / TerminalSession、GPUI 非依存）
│ ├── tako-control/ ← 制御プレーン（IPC + dispatch + MCP 実装済み。検知は Phase 4）
│ ├── tako-app/ ← GPUI バイナリ（GPUI 依存はここだけ。IPC / MCP サーバー内蔵）
│ └── tako-cli/ ← Layer 1 CLI（`tako` コマンド）+ MCP stdio ブリッジ（`tako mcp serve`）
├── poc/ ← Phase 0 の使い捨て検証コード（品質基準の対象外）
└── .github/workflows/ ← CI（macOS / Windows ビルド + テスト）
.agent/に置くもの: AI 向け仕様・作業文脈。置かないもの: 人間向け紹介文（README へ）- コード着手前に
.agent/の該当仕様を読み、仕様変更はコードと同一コミットで md に反映する
絶対ルール
- cmux（GPL-3.0）のソースコードを読まない・参照しない・移植しない。設計思想のみ参考可（
.agent/concept.md） - ペイン内容・送信テキスト・
TAKO_TOKENを診断ログ（persist.log / perf.log / stderr）に出さない （ペインログ機能 FR-5.13 はユーザー管理のローカルデータとして明示の例外。.agent/requirements.md） - 実ユーザー名・実ホームパス・実ホスト名を現行コードへ置かない（#927）。public リポなので、
実機の採取物（ペインの capture・PowerShell のプロンプト行・
HOMEの値・claude TUI の cwd 行）は 貼る前にプレースホルダ（testuser/winuser/山田等）へ置換する。番犬はcrates/tako-control/tests/no_personal_data.rs、書き方は.agent/conventions.md
機能実装時の必須ルール（開発不変条件）
- 設計原則 5「AI フルコントロール」は不変条件: すべての機能は追加した時点で MCP / CLI から
操作可能でなければならない（UI でできることはすべて AI からもできる）。新機能の Definition of
Done に「対応する MCP / CLI 操作の提供」を含め、例外は理由を
.agent/requirements.mdに明記する - 新機能の操作ロジックは tako-core の操作 API として実装し、
tako-control::dispatch（protocol + ControlHost）へ 1:1 で載せる（UI 層に閉じたロジックを作らない）。 Phase 2 以降、CLI はこの経路で操作できる。MCP 公開（Phase 3）も同じ dispatch を呼ぶ - 設定・データファイルのスキーマ変更は常に自動マイグレーション（#916）: 永続ファイル
（
settings.json/layout.json/projects.yaml/profiles/*.yaml/handoff/等）の 形式や置き場を変えるときは自動移行を同梱する。ユーザーや master へ手動の移行作業を 要求してはならない（「移行手順を提示する」も不可）。実装はtako-core::migrationの機構へtako-control::migrations::SPECSのtarget_versionを上げてStepを足す形で載せる。 発火は二段構え（tako setup実行時 + GUI / master / CLI の実行時差分検出）で既に配線済み なので、登録するだけで両方から効く。安全要件（冪等 / 旧ファイルは.pre-v<N>.bakへ退避して 消さない / 解釈できない内容は.unreadable.bakへ保全 / persist.log へ記録）は機構側の 1 実装が担保する。永続構造体のフィールドを増減・改名した PR はmigration_registryテスト（指紋スナップショット）が落ちるので、 「serde の default / alias で旧ファイルがそのまま読める」か「移行を足した」かを明示する - agent 系統ごとの能力差はマトリクスへ書く（#982）: claude 以外で落ちる / まだ使えない機能を
作った・見つけたら、判断を
if agent == claudeで散らさずtako-core::agent_support::MATRIXの 1 マスとして宣言する（正本 1 箇所・根拠必須・日英の理由文）。 能力を問う側はagent_support::supports(agent, keys::…)を通す。 この宣言は診断・docs・将来の system prompt がすべて引くので、過大にも過小にも申告しない。 agent 種別の enum は現状 5 つ並存している（統合しない理由と対応表は.agent/agent-enums.md）ので、 値を増減させた PR はagent_parityテストが落ちる = マトリクスの列と docs も直すこと - 「最も簡単なコマンドを提案する」原則（#322）: ユーザーへ提示するコマンドは常に最簡形
（既定値で済む引数を付けない。
tako master -defaultではなくtako master）。機能追加は 新しい--オプションではなく既定動作を賢くする方向で設計する。CLI 出力・system prompt・ docs のすべてに適用。詳細は.agent/conventions.md「コマンド案内の規約」
コマンド
1 行 1 コマンドの索引。実測・罠・A/B の env・オプションの意味は .agent/commands.md の
同じ行にあるので、そのコマンドを使う直前にそこを Read する（毎ターンは読まない）。
| 操作 | コマンド |
|---|---|
| dev（最小ターミナル起動） | cargo run -p tako-app |
| 実験・検証用の隔離起動（本番 GUI 稼働中は必須。#177） | TAKO_ISOLATED=1 cargo run -p tako-app |
| 検証用 GUI の置き場（ユーザーの画面に窓を出さない。#1141） | scripts/lib/virtual-display.sh ensure |
| 仮想ディスプレイの孤児の後片付け（#1150） | scripts/lib/virtual-display.sh cleanup-orphans |
| tmux サーバーの孤児の後片付け（隔離・テストの残骸。既定は dry-run。#1192 / #1282） | tako tmux cleanup --servers [--apply] |
| セルフテスト起動（入力経路 + CLI / MCP e2e の機械検証） | TAKO_SELF_TEST=1 cargo run -p tako-app |
| 実 claude の e2e（#28 / #716。要 claude CLI + 認証 + tmux） | env -u CLAUDE_CODE_CHILD_SESSION -u CLAUDE_CODE_SESSION_ID -u CLAUDECODE -u CLAUDE_CONFIG_DIR TAKO_SELF_TEST=1 TAKO_SELF_TEST_CLAUDE=1 cargo run -p tako-app |
| Claude Code 実機検証（MCP 設定ゼロ接続） | scripts/verify-claude-mcp.sh |
| 自動セットアップ | tako setup [--yes] [--answers <json|@file|->] |
| エージェント CLI のゼロスタート導入（claude / codex / agy。#868 / #1057 / #989） | tako setup bootstrap [status|status-all|install|path|undo-path|handoff] [--agent <claude|codex|agy>] |
| 任意依存のその場導入（#88 / #1057 / #1499） | tako setup deps [install] [--dep <名>] [--dry-run] [--json] |
| モデル一覧の実取得とピッカー（#1002） | tako setup models [--agent <claude|codex|agy>] [--json] |
| MCP セットアップ（claude / codex / agy。#979） | tako setup-mcp |
tako CLI ビルド |
cargo build -p tako-cli |
| .app バンドル生成（macOS） | scripts/build-app.sh [--verify] [--install] |
| リリース（両 OS 同時が既定。#594/#965） | scripts/release.sh |
| 夜間リリース（自動） | scripts/nightly-release.sh |
| 安定版への昇格（Homebrew cask・docs の「最新の安定版」も追従。#403 / #1853） | scripts/release.sh --promote <tag> |
| Windows 配布物生成（既定は CI。#587/#965） | .github/workflows/release-windows.yml |
| Windows リリース（CI が使えないときの実機経路。#587/#965） | pwsh -File installer/windows/release-windows.ps1 |
| Windows アプリアイコン再生成 | pwsh -File installer/windows/make-icon.ps1 |
| マスターオーケストレーター起動 | tako master [-profile] |
SSH ペイン（ファイルメニュー「リモート接続…」/ ペインの右クリック / tako open-in remote <host>。#20 / #919 / #1006） |
ssh <host> |
| ソロエージェント起動（オーケストレーション無しの 1 対 1 対話） | tako solo [-profile] |
| オーケストレーター master 自己情報 | tako orchestrator self [--pane N] |
| オーケストレーター master 引き継ぎ（#193/#749/#915/#854/#917） | tako orchestrator handoff [--pane N] [--tab T] [--projects a,b] |
| master の自動ハンドオフ（#749） | 【tako 自動通知】 |
| 引き継ぎファイルの管理（#915） | tako orchestrator handoffs list/show/write/migrate |
| master の手順書を引く（#1154） | tako orchestrator guide <topic> |
| 個人ルールの追記を常時部 / on-demand 部へ自動分割（#1477） | tako migrate run |
| オーケストレーター worker spawn | tako orchestrator spawn --project <key> --prompt "..." |
| worker への指示送達（#790） | <data_dir>/persist.log |
| オーケストレーター worker 監視 | tako orchestrator watch --pane <N> |
| オーケストレーター ダイアログ応答（#319 → #748 で全種別） | tako orchestrator respond --pane <N> [--choice <番号|ラベル>] |
| オーケストレーター worker 報告取得 | tako orchestrator report --pane <N> [--lines 2000] |
| オーケストレーター worker レジストリ一覧 | tako orchestrator workers [--all] |
| オーケストレーター プロジェクト管理（add は専用プロファイルも作る。#1453） | tako orchestrator projects list/add/remove |
| オーケストレーター プロファイル管理（#721/#749） | tako orchestrator profiles list/show/set/create/copy/delete |
| 走っている master を専用プロファイルへその場で寄せる（#1453） | tako orchestrator adopt <名前> |
| スマホから会話を操作する（Claude 公式 Remote Control。#1068 / #1069 / #1077 / #1078） | tako orchestrator profiles set <名前> --remote-control true |
| オーケストレーター アカウント管理（#504/#548） | tako orchestrator accounts list/show/add/remove |
| worker spawn のレイアウト設定 | tako orchestrator layout [--policy master-reserved|legacy] [--master-ratio 0.5] [--algorithm grid|spiral] |
| PWA を単独でビルドする（新規 worktree で dist が無いとき。#1309） | scripts/build-pwa.sh |
| PWA の e2e（Playwright。書き出しは outputDir の中だけ。#1357 / #1449 / #1749） | cd web/tako-remote && npm run e2e |
| build | tako queue cargo build --workspace |
| lint（3 つの feature 宇宙を見る。#1383 / #1072） | cargo fmt --all --check && tako queue cargo clippy --workspace --all-targets -- -D warnings && tako queue cargo clippy -p tako-app --features visual-test --all-targets -- -D warnings && tako queue cargo clippy -p tako-core -p tako-control -p tako-cli --all-targets -- -D warnings |
| test | tako queue cargo test --workspace |
| PR の CI 完了を待つ（判定はこの 1 実装。#1333） | scripts/wait-pr-checks.sh <PR> |
| CI が緑で揃ってから PR を merge する（#1333） | scripts/merge-pr.sh <PR> |
| リリース経路のモックテスト（#256 / #965） | bash scripts/test-release-retry.sh |
| スマホからの master 起動の実経路テスト（#1078） | bash scripts/test-remote-master-launch.sh |
| スマホの「+」から立てる 3 種の実経路テスト（#1449） | bash scripts/test-remote-launch-1449.sh |
| リモート serve 自己検査のモックテスト（#1049） | bash scripts/test-serve-watch.sh |
| 編集カーソルの追従スクロールの実測（#1649） | bash scripts/test-cursor-follow-1649.sh |
| ファイルツリーフォルダ操作 | tako tree add <path> |
| Finder の「このアプリケーションで開く」（#708 / #835） | tako open <file> --new-tab |
| ターミナル上のパスの cmd+右クリックメニュー（#1182） | tako file open-in-tako <path> |
| 画面のどのパスがリンクになるかを読む（cmd+クリックの検証。#1283） | tako links [--pane N] [--text <画面テキスト>] |
| ジャンプ履歴を戻る / 進む（行を指定して開くと積まれる。GUI は ⌃- / ⌃⇧-。#1677） | tako jump back |
| 言語サーバ（LSP）の状態と起動・停止（編集モードで自動的に起きる。#1678） | tako lsp status |
| 言語サーバを tako が取って入れる（無ければ開いた時点で自動。前もって入れる・取り直すとき。#1944） | tako lsp install |
| 編集中のコードの診断（エラー・警告。波線と右パネルと同じ表。#1679） | tako lsp diagnostics |
| 定義へ飛ぶ（GUI は ⌘クリック。別ファイルは新しいペイン。#1680） | tako lsp definition --pane N --line L --column C |
| 編集中のコードを整形する（GUI は ⇧⌘I。undo 1 回で戻る。保存時整形は既定 off。#1683） | tako lsp format |
| 補完の候補を読む・確定する（GUI は打鍵中に一覧が出る。#1682） | tako lsp completion --pane N --line L --column C |
| ワークスペース横断検索（GUI は ⇧⌘F。結果の行を押すとその行を開く。#1694） | tako search <検索語> |
| 右クリックメニューの言語サーバの項目を読む（GUI は本文の右クリック。#1684） | tako lsp menu --pane N --line L --column C |
| その位置の型・doc を読む（GUI は識別子にマウスを乗せるとカード。#1681） | tako lsp hover --pane N --line L --column C |
参照・呼び出し階層・型階層（GUI は右クリック → 右パネル。結果は tako lsp results。#1685） |
tako lsp references --pane N --line L --column C |
名前を変える（既定は書き換えずに件数と場所。--yes で当てる = undo 1 回。GUI は右クリック。#1686） |
tako lsp rename --pane N --line L --column C --new-name NAME |
| リモートからフォルダを開く（SSH 先のワークスペース化。#919 / #65 / #976 / #1041） | ssh <host> |
| スマホからファイルを見る・直す（#1079 / #1084 / #1085） | #/files |
| スマホから PC 全体を Finder 風に辿る（manage 以上。#1451） | #/files の「このマシン」 |
| リモート閲覧のショートカット（お気に入り。#1451） | tako remote shortcuts [add <path>|remove <path|id>] |
| リモートファイルの編集・保存（#966 / #65） | put |
| リモート公開の自己検査と自動復旧（#1049） | tako remote status |
| リモート端末の権限（一覧・降格・削除。上げるのは画面だけ。#1452） | tako remote devices list / role <id> <role> / revoke <id> |
| プレビュー目次操作 | tako preview-outline [--pane N] [--item N] |
| プレビュー内リンク（#680 / #271） | tako preview-link-list |
| Markdown コードブロックのコピー（#680） | tako preview-copy-code [index] |
| プレビューライブリロード | tako preview-reload [on|off] |
| プレビュー画像キャッシュ | tako preview-cache [max_mb] |
| 設定の自動マイグレーション（#916） | tako migrate [status|run] [--schema <種別>] |
| ユーザー向けタスク（人がやること。承認待ち・レビュー・投稿。#1450） | tako todo list |
| その 1 件を右パネルで開いて見せる（#1479） | tako todo expand <id> |
| 人がやることを画面で見る・返答する（右パネル。#1450 B2） | tako panel --show --view tasks |
| 人がやることをスマホから片付ける（PWA。#1450 B3） | #/tasks |
| 受け入れゲート（#244 / #935） | tako task gate set <task_id> --command "cmd" [--pr-merged N] [--custom "desc"] |
| git ブランチ操作（#496） | tako git checkout <branch> |
| コンフリクト解消エージェント（#496） | tako git resolve [--agent claude|codex|agy] [--tab N] |
| Web ビューペイン操作 | tako web open <url> |
| 複数ウィンドウ操作（ビューポート方式 + 共有タブバー。#339/#380） | tako window list |
| 窓の位置・寸法を外から決める（検証で窓を並べる。AX は使わない。#1442） | TAKO_WINDOW_BOUNDS=x,y,w,h / tako window move / resize |
| シェル統合（cwd 追従・コマンド状態。#525） | tako shell-integration [status|install|uninstall] |
| tako mod（Claude Code の mod 連携。ctx・使用制限・ターンの報告 #1879・画面の帯 #1881・画面の UI 設定 #1960・設定 dir の skills/tako へ入れる / 外す #1959） | tako mod [on|off] / tako mod band [on|off] / tako mod ui / tako mod install|uninstall |
| エージェント共通ルール同期 | tako agents sync-rules |
| AI 系設定のデバイス間共有（#513） | tako config |
| tmux の一覧・取り込み・window 切替（#1185 / #1190 / #1186） | tako tmux list / tako tmux open <session> [--window N] / tako tmux select-window N |
| レイアウト復旧（タブ・ペイン消失時。#177/#381/#770） | tako recover |
| 何がいつ消えたかを調べる（#770） | <data_dir>/persist.log |
| tmux への再接続が止まったペインを繋ぎ直す（#1857） | tako persist reattach --pane N |
| 再起動後にエージェントが戻らないとき（#1076 / #1238 / #1554） | <data_dir>/persist.log の「復元の内訳」 |
| セッションカタログ（会話の発見・復元。#112 / #1069） | tako sessions list [--role r] [--project p] |
| 利用制限の観測と使用量の内訳（ログイン → プロジェクト → Issue → 会話。#2200 / #2201） | tako usage [--by issue] [--window 5h] |
| ペインの平文ログ（ペイン死亡後も出力を遡る。#112） | tako logs list |
| スクロールバック保持上限（直接ペインの RAM。#818） | tako scrollback [lines] |
| フォーカスの無いペインの再描画の上限（CPU。#1979） | tako redraw-limit [fps] |
| TUI（全画面の claude 等）へのクリックの転送（⌥ / Shift + ドラッグで tako の選択。#1961） | tako mouse [on|off] |
| 貼り付けに鍵らしき文字があれば送る前に確かめる（既定 ON。#2046） | tako paste-guard [on|off|check] |
| スリープ防止 | tako sleep-guard status |
| 会話を引き継いだセッション再起動（ペインの右クリック。#1067） | tako session-restart [--mode harness|handoff] [--pane N] |
| リミット後の自動復帰（ペイン単位 / 一括 = ステータスバーのボタン。#813 / #1945） | tako limit-resume [on|off] [--pane N] [--all] |
| ネット復帰で、接続エラーで止まったセッションを再開（既定 ON。#2112） | tako limit-resume --network [on|off] |
| 入力予測（tako 内 zsh のゴースト予測。#600/#614） | tako autosuggest [on|off] |
| UI テーマ切替 | tako theme [dark|light|toggle] |
| UI 表示モード切替（GUI ライク表示。#691/#694/#702/#715/#716/#720/#725/#737/#739） | tako ui-mode [gui|terminal|toggle] |
| チャット本文のコピー（#725） | tako chat copy [--pane N] [--message N] [--code K] [--markdown] [--list] |
| プラットフォーム対応マトリクス（#515 / #591） | tako platform [--platform macos|windows] [--status pending] [--known-limitations] [--json] |
| 環境の健全性診断（IPC の受け口・CLI の PATH・tmux。#1441） | tako check-health [--json] |
| PC のメモリ・CPU と重い処理（どのペインで何が食っているか）（#1993） | tako queue |
| 重い処理を順番待ちで走らせる（同時数・空きメモリ・メモリ圧で割り当て。#1994） | tako queue <コマンド> |
| codex の利用制限データ（#357 / #985） | $CODEX_HOME/sessions/**/rollout-*.jsonl |
| agent 能力マトリクス（#982） | tako agent-support [--agent claude|codex|agy|local] [--status supported|degraded|pending|unsupported] [--json] |
| Windows 対応状況ページのデータの生成（ページは docs のビルドが組む。#591 / #2104） | cargo build -p tako-cli && node scripts/gen-windows-support-docs.mjs |
| THIRD-PARTY-LICENSES.md を今の依存から作り直す（CI が --check でずれを落とす。#1851） | bash scripts/third-party-licenses.sh |
| Windows のウインドウを実測する（#1063） | pwsh -File scripts/windows/measure-window.ps1 -TakoPid <pid> |
| 右パネルのビュー切替 | tako panel --show --view <fleet|orch|git|tasks|diagnostics|references|search> |
| Code Runner でファイル実行（#453） | tako run <file> [--profile <name>] |
| 拡張子既定コマンド設定 | tako run-default [ext] [command] |
| 実行環境・プロファイルを選んで覚える（ファイル / プロジェクト単位。#1731） | tako run-config <file> [--runtime <候補>] |
| AI コマンド提案カード（#666/#703） | tako show-command <コマンド>... |
| 設定画面（#459/#721） | tako settings [--tab <名>] |
| 初回起動バナー（#549） | tako welcome [show|dismiss] |
| アプリ内更新（#36/#403/#616/#690/#1042） | tako update [status|check|apply|apply-zip|repair] |
| テスト・検証プロセスの残骸の後片付け（一時 dir。既定は dry-run。#1296 / #1312） | tako test-residue [--apply] |
| target 掃除 | scripts/clean-target.sh |
| cargo の target を Spotlight の索引から外す（既定は状態だけ。#1968） | scripts/spotlight-noindex.sh [--apply] |
CI（.github/workflows/ci.yml）は macOS / Windows の両ランナーで build + test を回す。
AI 向け詳細仕様（必要なときだけ Read する）
- コマンドの詳細（実測・罠・A/B の env・オプションの意味）:
.agent/commands.md - コンセプト・競合・Non-goals:
.agent/concept.md - 機能要件（FR / NFR）:
.agent/requirements.md - 技術設計・リスク・3 層制御プレーン:
.agent/architecture.md - 規約（命名・エラー・ログ）:
.agent/conventions.md - agent 種別 enum の対応表（統合しない理由・寄せ先一覧）:
.agent/agent-enums.md - 手動確認チェックリスト（IME・.app 等、機械検証できない項目）:
.agent/manual-checks.md - リリース運用の詳細（両 OS 同時 / 夜間リリース / 版数の予約）:
.agent/release.md - オーケストレーター使い方ガイド:
.agent/orchestrator.md - 解説動画 / X 向けショートの作り方:
.agent/plans/2026-09-youtube-explainer.md/.agent/plans/2026-09-x-short.md - LSP 基盤（#1007 の S1）の実装設計:
.agent/plans/2026-09-lsp-s1.md
作業履歴メモ（毎ターン参照・更新）
- 現在の作業状況（毎ターン上書き）: @.agent/activeContext.md
- 完了タスクの時系列（毎ターン追記）: @.agent/progress.md
セッション開始時に必ず読み、応答終了前に activeContext は最新状態で上書き、
作業が一段落していれば progress の末尾に1〜3 行で追記する。
スキップ可能なターン（単発質問への回答、タイポ修正のみ）では更新しない。
フェーズ計画・次の一手は .agent/roadmap.md、移送済みの古い履歴は
.agent/progress-archive.md（どちらも毎ターンは読まない。必要なときだけ Read する）。
起動時ロードの予算（Issue #1139）
この節は生成物（正本は tako_core::context_budget の予算表）。手で数値を書き換えない。
tako context-budget / MCP tako_context_budget が同じ表で判定し、CI の番犬
crates/tako-control/tests/context_budget.rs が落とす。
絶対に読む範囲（@import してよいもの）
- 現在状態（
activeContext.md型）: 80 行以内。「現在の対象 / 直近の観点 / 次の一手」だけを置く - 作業ログ（
progress.md型）: 直近 5 作業日 かつ 20 エントリ かつ 12 KB 以内。 1 エントリは「何を / どこを / 結果」の 3 行以内にとどめ、詳細は git log・Issue・PR に委ねる - タスクリスト 1 本（プロジェクトにあれば）
アーカイブとする範囲
- 予算から外れたエントリは
progress-archive.mdへ 1 行（- YYYY-MM-DD #番号 一言）で移す - アーカイブは
@importしない・普段は Read しない - 90 日より古いアーカイブ行は消す（git log・Issue・PR が正本なので情報は失われない）
それ以外の上限
- エージェント規約（
AGENTS.md）は 30 KB 以内。長い注記・実測・罠は.agent/配下の 別ファイルへ出し、規約からはバックティック参照で案内する（@importにはしない） @importの合計は 40 KB 以内- 引き継ぎの運用メモは 80 行以内 / グローバル指示ファイルは 24 KB 以内
- master / solo の system prompt は 24 KB 以内。手順の詳細は
tako orchestrator guide <topic>で必要なときだけ引く形にし、prompt には「いつ引くか」を残す - そのうち tako が作る部分は 18.5 KB 以内で、残り 5.5 KB は
プロファイルの
prompt_blocks.append（個人環境のルール）の取り分。追記がこれを超えるとtako migrateが見出し境界へ<!-- tako:on-demand -->を入れ、その行より後ろはtako orchestrator guide local-rulesで引く形になる（内容は 1 文字も消さない） - MCP で公開するツールカタログは 200 KB 以内（
tools/listの応答）。 MCP を繋いだエージェント全員が起動時に名前 + 説明 + inputSchema の全文を受け取る tako 自身の生成物なので、超えたらツールを隠すのではなく 1 本ずつの説明文を短くする
機械強制
tako context-budgetで状態を確認し、tako context-budget fixで作業ログの移送を自動で行う （冪等・本文は改変しない・全文は git 履歴に残る）- 自動で直せないもの（規約の肥大・
@importの増殖）はproposalsとして直し方が返る - CI の番犬がこの予算を検査するので、超えたまま merge できない
コミット規約
グローバル CLAUDE.md（~/.claude/CLAUDE.md）の「Git コミット」節に従う。
push 運用: リポジトリは公開済みなので main 直 push はしない。作業ブランチから PR を出し、
CI（macOS / Windows / docs）が緑になってから gh pr merge --squash --delete-branch する。
リリース運用
- 機能追加・バグ修正が一段落したら
CHANGELOG.mdに追記（日英併記、Keep a Changelog 形式） Cargo.toml（ワークスペースルート）の[workspace.package] versionを bumpscripts/release.sh --publishでタグ + GitHub Release 作成（CHANGELOG から自動抽出）- リリースノートは日英併記
- 両 OS 同時が正常な状態（#965）: リリース 1 回で macOS / Windows の配布物が揃う。
片肺は
scripts/release.shの終了コード 3 で検出する - 夜間リリースは自動（#166 / #1005 / #1136）: launchd から
scripts/nightly-release.shが 毎日 5:00 に走り、main に変更があった夜だけ**テスト版（prerelease）**として出す。 節目の版は--reserve <版>で予約する（既定は patch bump） - 仕組み・実測・罠（両 OS の生成場所と待ち合わせ / 共有ツリーの HEAD を動かさない理由 /
予約の消費とフォールバック / モックテスト）は
.agent/release.mdを Read する （長いので@importにはしない）
