決めてから、作り終わるまで ― npx の道具 8 本をつないだ流れ

Baton で決め、AI に作ってもらい、作り終わったら 5 つの確かめと書類を 1 回で作る。作例のゲーム「のこれ！」で通した、全部の流れです。

基本の使い方では、Baton で決めて、AI に作ってもらい、Aegis で確かめる 3 段を紹介しました。この記事では、Kokoro OS の npx の道具 8 本を全部つないだ流れを説明します。

あなたが答えるのは、最初の Baton だけです。 作り終わったあとの 5 つの段は、npx kokoro-pipeline が 1 回でまとめて動かします。

実際にこの流れで作ったゲーム「のこれ！」と、できた紙を、まとめてダウンロードできます（中身は記事の最後で説明します）。

流れの全体

npx の道具でつないだ制作の流れ。法則の紙と Baton で指示書を作り、Claude Code などが実装する。作り終わったら kokoro-pipeline がパラメータ表・人が読む仕様書・仕組みの仕様書・Aegis・研磨をまとめて動かす。直してもう一度動かす輪と、Tuner で見た目を整えて法則の候補を作り、法則の紙に戻る輪がある。

図の枠の色は、紫＝AI が書く、緑＝AI を使わない、橙＝Claude Fable が読んで確かめる、黒＝人がする、です。

段	道具	すること	費用の目安
1. 決める	kokoro-baton	選択肢に答えて、指示書 `kokoro-spec.md` を作る	数円
2. 説明スライド（見せたいときだけ）	kokoro-slide	指示書を 6 枚のスライドにする	数円
3. 作る	Claude Code など	指示書のとおりに作る	AI の道具しだい
4. 作り終わったら	kokoro-pipeline	下の 5 つをまとめて動かす	合わせて約 300〜400 円
5. 見た目を整える	kokoro-tuner	色・大きさ・余白・角を、スライダーで動かす	0 円
6. 直す	Claude Code など	見つかったことを直して、4 をもう一度	―

費用は、2026 年 10 月に作例のゲームで測った目安です。AI の費用は、あなたの Anthropic の API キーに付きます。Kokoro OS は料金をいただきません。

1. 決める ― kokoro-baton

npx kokoro-baton "作りたいもの"

選択肢つきの問いに答えると、kokoro-spec.md ができます。指示書には、作品に合わせて次の節が入ります。

調整する数の置き場所 ― 数はすべて PARAMS の 1 か所に置く（調整する数がある作品だけ）
見た目の決まりの置き場所 ― 色・大きさ・余白・角は STYLE の 1 か所に置く
あなたのデザインの法則 ― 法則の紙（~/.kokoro/laws.md）で [○] にしたもの。AI の好みより強い決まりとして入ります
作り終わったら ― 下の 4 を、作った AI に動かしてもらう頼み

数と見た目を 1 か所に集めておくと、あとの道具が、どの作品でも同じように読めます。

2. 説明スライド（見せたいときだけ）― kokoro-slide

npx kokoro-slide kokoro-spec.md

作る前に、依頼主や仲間に仕様を見せて了承をもらうためのものです。kokoro-spec.slides.md ができ、VS Code の拡張機能「Marp for VS Code」で開くとスライドに見えます。

3. 作る ― AI に指示書を渡す

kokoro-spec.md を読んで、そのとおりに作ってください。

作品の本体と、検査用の写し check.html（圧縮していないもの）ができます。

4. 作り終わったら ― kokoro-pipeline

npx kokoro-pipeline after .

次の 5 つを、この順に動かします。最初に 1 回だけ、動かす段と費用の見込みを出して聞きます。途中の段が止まってもほかは続け、最後にできたもの・飛ばした理由・止まった段をまとめて出します。

	段	道具	AI	できるもの
4a	パラメータ表	kokoro-kami params	なし（0 円）	`<名前> params.xlsx`
4b	人が読む仕様書	kokoro-writer spec-doc	あり（数円）	`spec-for-readers.md`
4c	仕組みの仕様書と照らし合わせ	kokoro-writer system-docs	あり＋Fable（作例で約 140 円）	`system-specs/`
4d	手で確かめる表	kokoro-aegis	なし（0 円）	`aegis-report.md`
4e	研磨	kokoro-polish	Fable（作例で約 90 円）	`kokoro-fixes.md`

4a パラメータ表 ― PARAMS の数を Excel の比べ表にします。同じ種類（武器・敵）を横に並べ、マスにカーソルを乗せると、コードのコメントに書いた「数の理由」が読めます。表で数を直して npx kokoro-kami params game.html --apply を動かすと、コードのその数だけが書き換わります。
4b 人が読む仕様書 ― AI が書くのは「概要」と「設計の考え方」の 2 節だけです。決めたこと・数・確かめ方は、指示書から AI を通さずに写します。最後に、決めたことが全部入っているか、AI の文に材料に無い数が無いかを照らし合わせます。
4c 仕組みの仕様書 ― コードを仕組みごとに分け、仕組みごとに仕様書を書きます。別の係（Claude Fable）がコードと照らし合わせ、食い違っていた文を直して、直した所の表を末尾に足します。
4d 手で確かめる表 ― コードをどこにも送らずに、決めたことを 1 行ずつ確かめる表を作ります。
4e 研磨 ― Claude Fable が check.html と指示書を読み、直してほしいことを重い順に、理由と直し方つきで並べます。

作った AI に任せるとき：指示書の「作り終わったら」の節が、AI を使わない段（4a・4d）は聞かずに動かし、AI を使う段（4b・4c・4e）は費用を言ってから「動かしてよいか」を聞くように頼んでいます。

作り直すときは、前の紙を previous/<日付_時刻>/ に移してから、同じ名前で最新を書きます。前の紙は消さないので、付けたチェックや直した数は前の版に残ります。

5. 見た目を整える ― kokoro-tuner

npx kokoro-tuner .

色・大きさ・余白・角を、スライダーで動かす画面が開きます。動かすたびに STYLE の値だけを書き換えるので、いつもの開発サーバーで見ながら整えられます。「この値で決める」を押すと、指示書の「作りながら決めたこと」に足されます。

決めた記録がたまったら（作品 3 つか、決めたこと 10 回）、npx kokoro-tuner candidates が、あなたのデザインの法則の候補を紙に足します（AI・数十円ほど）。[○] にした法則は、次の Baton の指示書に入ります。

6. 直す、そしてもう一度

kokoro-fixes.md と、Aegis の表で引っかかった所を AI に渡して直してもらいます。直したら、もう一度 npx kokoro-pipeline after . を動かします。

仕様やコードを変えたあと、どの紙が古くなったかは、こう打つと分かります。

npx kokoro-pipeline status .

紙の先頭には「何から作ったか」の印（仕様とコードの指紋）が入っていて、今のファイルと中身で比べます。開いて保存しただけでは、古くなりません。

作例「のこれ！」

この流れで作った、上から見下ろす生き残りアクションのゲームです。指示書・本体・5 つの紙が全部入っています。

nokore-sample.zip をダウンロード（約 75 KB）

ファイル	どの段で
`kokoro-spec.md`	1. 決める
`kokoro-spec.slides.md`	2. 説明スライド
`game.html`・`check.html`	3. 作る（`game.html` をブラウザで開くと遊べます）
`game params.xlsx`	4a. パラメータ表
`spec-for-readers.md`	4b. 人が読む仕様書
`system-specs/`	4c. 仕組みの仕様書（5 本）
`aegis-report.md`	4d. 手で確かめる表
`kokoro-fixes.md`	4e. 研磨

解凍したフォルダで、費用のかからないものを試せます。

npx kokoro-pipeline status .
npx kokoro-kami params game.html

この流れを支える決まり

数と見た目は 1 か所 ― 調整する数は PARAMS、見た目は STYLE に集めます。だから、どの作品でも道具が同じように読めます。
事実は写す ― AI に書かせるのは説明の文章だけです。決めたこと・数・計算式・確かめ方は、指示書とコードから写します。
係を分ける ― 書いた係と確かめる係を分けます。AI の言うことは、引用が本当にあるかを機械で照らしてから使います。
直すのは元 ― 表・スライド・仕様書は作り直せる紙です。直すときは指示書とコードを直し、紙は作り直します。
お金は聞いてから ― AI の費用はあなたのキーに付きます。動かす前に、何に・いくらかかるかを言って聞きます。

自分で並べる

決まった流れのほかに、道具を自分の順番で並べることもできます。1 行に 1 段の「レシピ」を書くと、前の段が出したファイルが自動で次の段に渡ります。

npx kokoro-pipeline new
npx kokoro-pipeline run kokoro-flow.txt

ひな形の作り方と使える段は、npx kokoro-pipeline parts で見られます。