yokoten · 横展
旅路には道しるべを。 橋には番人を。
誰でも、良いチームのやり方でソフトウェアを作れる。
良いチームの開発プロセスをプロジェクトに組み込む無料ツールです。チェックはリポジトリと CI で動き、人が書いても AI が書いても同じように働きます。
npx yokoten install # PC ごとに一度cd your-projectnpx yokoten init # プロジェクトごとに一度npx yokoten doctor # 今いる関所と、次の一手
最初の npm リリース（10 月 24 日）までは、clone からインストールしてください。
ひとりの開発者と数体の AI エージェントが、良いチームのやり方で作りました。issue もレビューもリリースも、すべてリポジトリに残っています。
GitHub で見る夢
誰でも、良いチームのやり方でソフトウェアを作れる。多くの人が痛い目を見て身につける習慣を、初日から実践できます。致命的なミスは、番人がエージェントの手前で止めます。
- 番人
- 危険なコマンドを実行前に止め、その理由をエージェントに伝えます。
- 道案内
doctorがプロジェクトが五つの関所のどこにいるかを見て、次の一手をひとつだけ示します。- 開発サイクル全体
- 計画、開発、テスト、レビュー、リリース、保守。いわゆる SDLC です。自分のプロジェクトで実際にやりながら、一度にひとつの関所ずつ身につけます。
横展（横展開）はトヨタの工場で生まれた言葉で、あるラインで得た教訓をすべてのラインに広げることを指します。yokoten はそれをあなたのプロジェクトで行います。あるプロジェクトが学んだ教訓を、ほかのプロジェクトにも届けます。
動いているところを見る
あるセッションの三つの場面です。順に見てみてください。
git push --tagsyokoten: git push --tags pushes tags. Only the owner decides when to release. If the owner asked for this, they start the session with YOKOTEN_RELEASE_APPROVAL set.
エージェントがリリースタグを push しようとします。フックが実行前にそれを止め、エージェントは理由を読みます。
yokoten: stage 1 of 5, safety net. Next: no AGENTS.md, so the agents have no written rules here; `yokoten init` adds one.Why: an agent follows the rules it can read, and only those.Tell the user in plain words, one step at a time, and offer to do it (as-is, lighter, or not now with a reason).
セッションは毎回 doctor から始まります。今いる段階、次の一手、そしてそれが大事な理由。
Agent今は 5 段階中の第 1 段階、セーフティネットです。このプロジェクトにはまだ AGENTS.md がないので、ここで従うべきルールが書かれていません。yokoten init で追加できます。このまま追加しますか？ 軽めの版にしますか？ それとも今回は見送りますか？
エージェントがわかりやすい言葉で伝え、自分がやろうかと提案します。決めるのはあなたです。 返答の一例です。言い回しはエージェントによって変わります。
（yokoten のメッセージは英語です。AI がいちばん読み違えにくいからです。）
今日から始める
4 行を一度だけ。エージェントに頼むこともできます。