English: README.en.md
bearing は 2 つのことを同時に意味する: 進んでいる方位と、負っている荷重。 この repo は、その両方を AI との coding セッションへ持ち込み、セッションを跨いでも、 マシンを跨いでも、context window が埋まる瞬間を越えてもそこに保ち続ける。
これが仕えている目的。 自前の場を供給しない。汎用ハーネスを器として受け入れ、 そこへ接ぎ木するのは、そのハーネスが持ちえないものだけ —— 人間が pin した目的を運ぶ 機構と、注意の予算を守る機構である。
⚠ 想定するのは個人開発である。 1 人の人間が 1 つのセッションと対話しながら進める形 —— いわゆる vibe coding —— が前提であり、それは規模の遠慮ではなく、機構が成り立つ条件 である。「目的は人間のもの」「迷ったら人間に escalate する」が 1 文で書けるのは、その人間が 誰かを問う必要がないからだ。複数人の project で使うなら、誰が目的を pin し誰が達成を宣言 するのかを、その project が自分で決めて書く必要がある。
コーディングハーネスは良くなった。⚠ それでもなお持っていないのは、「これは何のためか」 「我々は何をなぜ決めたのか」「code はそれが書かれた理由から離れていないか」に対する持続的な 答えである。 これらの問いはセッションより長く生きる。セッションは生きない。
| 何をするか | |
|---|---|
| aim | 目的と手段の木。1 つの目的につき 1 file。⚠ aim: の行は人間のもので、エージェントはそれを書き換えてはならない。 |
| handoff | ⚠ 0.35.0 で退役した(人間の決定 2026-10-27)。context が圧縮される前に著す baton だったが、圧縮とハーネス側のセッション継続で足りると人間が判断した(session-handoff)。 |
| drift | body が、それが仕えると称する目的から離れていないか、隣接から離れていないかを、安く機械的に検知する。⚠ 候補を可視化するだけで、判定はしない。 |
エージェントの framework ではないし、server でもないし、wrapper でもない。何かが走るための 場を一切足さない。 実体は plugin 1 つと、いくらかの Markdown と、git に問い合わせる数百行の Node である。
⚠ ここが敷く体制は、エージェントを利するためではなく、エージェントに対して働く。 エージェントは木を保守し、どの目的についても変更を提案してよい —— だが目的を pin すること、 そして目的が達成されたと宣言することは、人間の act である。 この非対称が要点の全てである。
採るかどうかを決める前に ——
docs/adoption.mdが契約を 1 枚で述べる: 採ると何がリポジトリに置かれ、その後どの act があなたに残り続けるか。
claude plugin marketplace add https://github.com/trust-delta/bearing.git --scope user
claude plugin install bearing@trust-delta --scope user
そのうえでプロセスごと開き直す —— 一覧はプロセスが最初に解決した時点で固まる(⚠ 実測
2026-09-04、1 台。対象は slash command の面である —— skill と hook について同型の A/B は取れて
いない)。⚠ /clear では足りない —— あれは新しいセッションを立てる
が、新しいプロセスを立てない ∴ いま入れた版は、そのセッションには載らない。
⚠ enabledPlugins の宣言は「載せる」ことではない。 installed_plugins.json に record が
無ければ skill も hook も 1 枚として走らず、⚠ 載っていない機構は自分の不在を報告できない
∴ 画面には何も出ない。載っているかを見るのは claude plugin list である —— claude plugin details は record が無くても版も skill も hook も列挙する ∴ 載っている証拠にならない。
/bearing:setup-aim # 法の block を CLAUDE.md の末尾へ差し込み、.claude/skills/aim/ へ aim skill を置く
/bearing:setup-aim --check # 状態だけ述べる
/bearing:setup-aim --remove # block を外す(skill は残す —— 置いた後はこの repo のもの)
/bearing:setup-aim --dir proj/aims # corpus の在り処を宣言する(既定は docs/aims)
/bearing:setup-aim --update # 区別できない複製を捨てて、block と skill を今の版へ揃える
⚠ 書き先は実行した project である —— aim の採用はその repo の corpus についての宣言ゆえ、repo にしか置けない。 ⚠ 置いた後は block も skill もこの repo のもの —— track するか・直すか・古いままにするかは repo が決める。
🔴 block と skill は 1 組である(人間の決定 2026-09-07)—— 更新するなら両方、しないなら
どちらも維持であり、どちらにするかは aim を使う側が決める。 ⚠ 理由は保有 corpus である:
版が上がることは doc の差し替えではなく、手元の aim node の書き換えを伴いうる act だからで
ある。∴ 置かれた skill が同梱の正本と一致しなければ、SKILL.md の frontmatter に刻んだ版と 3 枚の
指紋に訊く —— 🔴 刻印が今の中身を指していれば「この repo は触っていない」 ∴ 打った act で
揃え直す(消えるものが無いからである)。⚠ 刻印が無いか、刻印と中身が食い違えば block も触らず
に止まる —— そこは「古い」と「手を入れた」を分けられない。捨ててよいと述べるのが --update。
⚠ 刻印は frontmatter に在る ∴ 消費者の context には 1 token も乗らない(実測 2026-09-07、対象:
Claude Code 2.1.263、1 台 —— skill として読み込まれるとき、注入されるのは --- の後の本文だけで
ある)。⚠ 対して HTML コメントは skill の本文では除かれない —— CLAUDE.md の marker と違う。
⚠ 刻印は、これから置くものにしか付かない —— 既に置かれた複製は今までどおり止まる。
⚠ marker は HTML コメント ∴ context を 1 token も食わない。 版と本文 sha を運ぶので、
--check は**「版が古い」と「人間が block を編集した」を別のものとして述べる** —— 後者では
置き直さず、述べて止まる。
⚠ 採っていない project では hook は 1 byte も出さない。🔴 corpus が在っても、marker が無ければ黙る。 ⚠ 2026-09-05 まではそうではなく、述語は
marker || corpus だった —— 移行の便宜として、既に node を書いている project を「印が無い」
という理由で黙らせないためである。同日、述語から corpus が落ちた(lib/claude-md.mjs の
isEngaged は adopted だけを見る)∴ corpus が在ることは使っている証拠であって、この機構を
通したいという宣言ではない。 ⚠ 例外は statusline の 2 行目だけで、corpus を見つけたことを
aim 未採用 と corpus N を 1 行述べる —— 黙る機構は自分の存在を告げられないからである。
/bearing:setup-statusline # 装着(--force で差し替え、--uninstall で外す)
⚠ 書き先は人間の home(~/.claude/)であり、project には何も書かない。 薄い shim を置き、user settings に 1 行を書く。⚠ shim は走るたびに install
record を読んで今の版へ橋渡しする ∴ 1 行に version が入らず、bump で腐らない。
⚠ 書き先は user settings だけである(1 行に home を含む絶対 path が入る ∴ repo で共有できる
ものではない)。既に別の statusline が在れば上書きせず述べて止まる。⚠ statusline だけは再起動を要さない(設定は live に拾われる)。
claude plugin marketplace update trust-delta
claude plugin update bearing@trust-delta
そしてプロセスごと開き直す —— ⚠ /clear では足りない(同上)。claude plugin update
自身が (restart required to apply) と述べている。⚠ ただし面ごとに時定数が違う —— 既に載って
いる skill の実体は、同一プロセスの中で新しい版へ追随した(実測 2026-09-06、対象: plugin cache、
1 台)∴ 開き直すのは安全側の作法であって、全ての面がそれを要するという意味ではない。
⚠ 起動時の自動 pull は当てにしないこと。 extraKnownMarketplaces に "autoUpdate": true
を宣言していても、引かれる日と引かれない日があった(実測、1 台)∴ 更新が要るときは上の
2 行を打つ。
⚠ 更新が来ないときは、まだ release されていない可能性がある —— cache は plugin.json の
version が上がるまで差し替わらない。
なぜこの形なのか —— 供給が 2 層(宣言と実体)に分かれる理由、法を
CLAUDE.mdへ置いた 理由、装着が人間の act として残る理由、そのそれぞれの実測はdocs/aims/bearing.mdとdocs/aims/ambient-display.mdに在る。
CONTRIBUTING.md を参照。 ⚠ こちらは日本語のみである —— 理由は
下の「言語」に書いた。
このプロジェクトの正本は日本語である。 ⚠ これは慣習ではなく、エージェントへの指示は
言語を統一した方が質が高いという判断に基づく手段であり、その前提はまだ実測されていない
(docs/aims/native-language.md を参照)。英語版の
README は併置してあるが従属物であり、食い違ったときは日本語側が正である。
⚠ ただし外向きの英語は「読む面」に限る。 開発に加わる面(CONTRIBUTING.md)は日本語のみで、翻訳を置かない —— 開発が日本語で進み、aim の木も canon も commit message も日本語である以上、手引きだけを訳しても拾えるのは表面であって変更の意図ではない。
機械が parse する契約 —— fence の tag と field 名、slug、識別子 —— は英語のままである。 判別線は「人が読む文か、機械が parse する token か」であって、内と外ではない。
初期段階であり、それを正直に述べる。規律そのものは、ある private project の中で数か月に
わたって自分自身に適用されながら育った。⚠ plugin の実体はこの repo に移り、標準ハーネス上で
動いている。だが「標準ハーネスとこの plugin だけで開発が成り立つか」はまだ実測していない ——
それがこのプロジェクトの中心的な未検証項目である(docs/aims/bearing.md)。
規律は前身プロジェクト tmai(tactful multi agents interface)の中で育った。あれは coding
agent が走るための場を作ろうとした project であり、3 本の柱のうち 2 本は、標準ハーネスが
その「場である」という仕事を吸収した時点で死んだ。⚠ 生き残ったのは場ではなく、方法だった。
この repository は、その方法が今住んでいる場所である。
⚠ 履歴は運ばなかった。 あちらの記録は一貫して「tmai という場所の中での役割・手段」を前提に 書かれているが、この repo が問うのは「外付け拡張としてどうか」であり、出発点が違う。∴ 概念は 継承し、履歴は継承しない。
MIT。正本は LICENSE 1 枚で、plugin に同梱される複製はそこから生成される
(食い違いは CI が赤くする)。
Copyright (c) 2026 TrustDelta