Works Factory — Development skill for Claude Code

works-factory

works-factory は、どのリポジトリにも使える修正の工場。直してほしい事（修正依頼か GitHub の issue）を渡すと、確かめ済みの変更と報告を返す。工場は、まず何が問題かを判定し、直し方を計画し、その計画を別の目に審査させる。直す前には、落ちるテストで欠陥を示す（赤の証明）。前から落ちていたテストと今回の欠陥を分ける。互いに触らない直しは別々の作業ツリーで並べて進める。対象のプロジェクト自身の確かめ（テストや CI）を走らせる。最後に、直しの経緯を知らない別の審査役が、目的だけから白紙で作った設計と突き合わせて判定する。人に聞くのは、決めた関所の所だけ。

GitHub の About: A dev factory on Archon that turns a fix request into a verified change for any repository: plans are reviewed before code is written, red tests are proven before fixes, every agent claim is checked against quoted evidence, and independent reviewers judge blind. Japanese only for now.

今は日本語だけ。

約束すること

• 事実は機械が確かめる。テストが落ちたか・通ったか、何件か、どのファイルが変わったかは、AI の申告でなく機械が見る（テストの結末の JUnit XML・git の差分など）。
• 判断には引用の証拠を要る。AI が「この理由で落ちた」「ここが原因」と言う時は、根拠の文を引かせ、その引用が実物に在るかを機械が照らす。判断の正しさは別の目が見る。
• 持ち主の決めは言葉のまま記録し、工場に戻す。人が関所で答えた事・方針として決めた事は docs/owner-decisions.md に言葉のまま残り、次の判断と次の run の材料になる。同じ事を二度聞かない。
• 関所を通らなかった物は取り込まない。人が最後の関所で見た差分は封じられ（hash）、取り込む時に照らす。違えば止まる。

流れ

1. 判定: 依頼の前提を実測し、目的を 1 文に固め、同じ種類の問題を世の中がどう解いているか（定石）を当たり、根本の欠陥を単位に切る。
2. 計画: 単位ごとに直し方・触ってよい範囲・受け入れのテストを決める。
3. 事前審査: 書く前に計画を叩く。別の役が目的の文だけから独立に設計し、計画と比べる。
4. 修正: TDD（先に落ちるテストを書き、直して通す）。互いに触らない単位の組を、別の作業ツリーで並べて直す（Archon の fan_out:）。
5. 試験の関門: 対象のプロジェクトの確かめを走らせ、赤の原因（今回入れた・元から・環境）を分け、緑を作業ツリーの指紋つきで認証する。
6. 独立の目: 4 つの観点（最小か・独立設計と合うか・全体の整合・見えていない範囲）を、経緯を知らない別の会話の審査役が判定する。
7. 報告: 結末・単位ごとの記録・人への問い・次に回す事。

人の関所は、始める時・直す前（聞く必要がある時）・最後の 3 か所が基本。無人で回す方針も選べる。

使い方（予定）

ここに書くコマンドはまだ無い。作りの順は `docs/design.md`。

1. 入れる: このリポジトリを clone する。bin/ が pack.json で止めた版の Archon と ASF を取って置く。
2. 始める: bin/start <対象のリポジトリ> <依頼の文か issue の番号>。
3. 答える: 関所で止まったら bin/answer で答える。
4. 見る: bin/show で今どこか・報告・人への問いを見る。
5. 当てる: bin/apply で、最後の関所で封じた差分を対象のリポジトリに当てる。

Claude Code からは `/works`（raiki61/claude-plugins の works プラグイン）で同じ事ができるようになる。

作り

flowchart TB
  entry["入口 bin/"] --> wf["グラフ workflows/"]
  wf --> shared["境 workflows/.shared/"]
  wf --> lib["助け手 lib/"]

• 入口 bin/: 人が打つ口。