Torus Engineering in Practice

§1クイックスタート（3分）¹

1. 実行ループを確認する。 すでにある。CI を直し、Issue を処理し、PR を出す——あなたが毎日回しているあれが第1の円環（子午線）である。追加作業：なし。
2. 改善ループを設置する。 繰り返しの予定を1つ作る。件名は「エージェントの運用を見直す会（30分）」。これで第2の円環（経線）が手に入る。気合や反省の心ではなく、カレンダー上の予定であることが位相的に重要である。
3. 直積を取る。 何もしなくてよい。2本のループが独立に回ってさえいれば、直積 S¹ × S¹ は自動的に成立する。この工程は位相幾何学が担当するため、依存パッケージの追加は不要。

導入は以上です。ここから先は、動き始めてから読む部分です。

§2コピペ用ファイル

結論だけ知りたい方のために、そのまま貼れるファイルを2つ用意した。1つ目は CLAUDE.md への追記、2つ目は経線を回すワークフローである。プロジェクトの事情に合わせて数値を変えてよいが、構造（ループが2本で、互いに独立）だけは変えないこと。

## トーラス運用規約（Torus Operating Rules）

### 実行ループ（子午線）
- CI が赤ければ直す。Issue が来たら処理する。PR を出したら見届ける。
- 1 周ごとに `.torus/revolutions` の数値を 1 増やす。

### 改善ループ（経線）
- `.torus/revolutions` が 100 の倍数になったら、実行ループの仕事を直すのを
  いったんやめ、実行ループ**そのもの**を直す：
  1. 直近 100 周の失敗パターンを 3 つ挙げる
  2. この CLAUDE.md を 1 箇所以上改訂する
  3. 使われていない Skill を 1 つ削除する（供養は任意）
- 改善ループの中で改善ループを改善しないこと
  （種数 2 は次のメジャーバージョンで対応予定）。

### 禁止事項
- 穴を埋めない。すべてを自動化した瞬間、トーラスは球面に退化し、
  第 4 世代に戻る（本編 §4）。人間の判断が通る空洞を必ず 1 つ残すこと。

# 経線方向の円環。子午線（いつもの CI）とは独立に回る。
name: improvement-loop
on:
  schedule:
    - cron: "0 9 * * 1"   # 周期比はここで調整する（表 1 参照）
  workflow_dispatch:        # 人間の判断が通る穴。塞がないこと。
jobs:
  wind:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 実行ループそのものを見直す
        run: |
          echo "直近の失敗パターンを集計し、CLAUDE.md の改訂 PR を作る"
          # ここにお好みのエージェント CLI を置く。守るべき点は 1 つ：
          # このジョブはプロダクトコードに触らない。触った瞬間それは
          # 実行ループであり、経線は子午線に潰れて種数が 0 になる。

§3周期比の選び方（早見表）

周期比（実行ループ何周につき改善ループ1周か）は、トーラスエンジニアリング唯一のチューニングパラメータである。迷ったら 100 : 1 でよい。

§4トラブルシューティング

§5導入チェックリスト

• 実行ループが回っている（= 普段の仕事をしている）
• 改善ループがカレンダー上に存在する（希望としてではなく、予定として）
• 周期比を1つ選び、口頭で言える（「うちは 100 対 1 です」）
• 改善ループは実行ループを変更しており、実行ループの仕事をしていない
• 穴が空いている（少なくとも1箇所で人間が判断している）
• ドーナツを用意した（任意。ただし推奨）

6項目中4項目にチェックが入れば、あなたのシステムは位相的にトーラスです。残りの2項目は、次に経線を一周するときに改善されます。それがこの手法の良いところです。

§6用語対訳表

本編の著者らと会話する必要が生じた場合に備え、対訳を示す。

§7よくある質問（実務編）

本編を読む必要はありますか？

ありません。そのためにこのページがあります。ただしトーラス上では「読んでいない」という状態も周回すればいずれ「読んだ」に戻ってきます。

コピペしただけで動きますか？

コピペした時点であなたは実行ループを1周しています。すでに動いています。

上司にはどう説明すれば？

「ループとグラフの直積です」で通らなければ、「導入コストはドーナツ1個分です」（本編 §5）が通ります。