tobari

name	tobari
description	帳をおろしてプロジェクトを開始する（STG0 儀式）。 自然言語の意図を構造化された契約に変換し、tobari-session.json を生成する。 エイリアス: /orose, /startproject 「/tobari」「帳をおろす」「/orose」で呼び出される。
metadata	{"short-description":"帳をおろす — STG0 セレモニー"}

/tobari — 帳をおろす

自然言語の意図を構造化された契約に変換し、帳をおろしてプロジェクトを開始する。

Overview

このスキルは STG0（帳をおろす儀式）を実行する。 ユーザーが自由テキストで意図を伝えるだけで、tobari がコードベースを分析し、 構造化された契約（やること / やらないこと / 完了基準 / スコープ）を自動生成する。

ユーザーが契約を承認すると、帳がおりる（= tobari-session.json が生成される）。

/tobari <feature>     ← 帳をおろす（正式名）
/orose <feature>      ← 同上（世界観エイリアス）
/startproject         ← 同上（claude-code-orchestra 互換）
    ↓ 帳がおりた後
/team-implement       ← 並列実装（任意）
    ↓ 完了後
/team-review          ← 並列レビュー（任意）

---

Workflow (STG0: 5 Steps)

$ARGUMENTS（自然言語の意図）
  │
  ▼
Step 1: receive_intent     意図の受取
  │
  ▼
Step 2: analyze_context    コードベース分析 + リスク評価
  │
  ▼
Step 3: generate_contract  契約の生成
  │
  ▼
Step 4: user_confirm       ユーザー確認 [はい / 修正する / やめる]
  │                          ├─ 修正する → Step 3 に戻る
  │                          └─ やめる   → 中止
  ▼
Step 5: lower_veil         帳をおろす（tobari-session.json + 詠唱 + 登録）

---

$ARGUMENTS の判定（最初に実行）

$ARGUMENTS を受け取り、以下の順で分岐する:

値	分岐先
init	Init フロー へ
amend	Amend フロー へ
空	fail-close（以下参照）
その他の文字列	通常フロー（STG0 儀式） へ

---

Step 1: receive_intent（意図の受取）

$ARGUMENTS からユーザーの意図を受け取る。

fail-close 条件

• $ARGUMENTS が空の場合 → 停止。以下を表示して再入力を促す:

帳をおろすには、やりたいことを伝えてください。

例:
  /tobari ログイン機能を追加
  /tobari READMEを日本語化
  /tobari APIのエラーハンドリングを改善

※ はじめて使う場合は先にセットアップを実行してください:
  /tobari init

---

Step 2: analyze_context（コンテキスト分析）

Claude Code が直接ツールを使い、コードベースを分析する。

分析項目

1. ディレクトリ構造: Glob でプロジェクトの主要ディレクトリをスキャン
2. 関連ファイル: Grep で意図に関連するコード・設定を検索
3. 影響範囲: 変更が必要になりそうなファイル・ディレクトリを特定
4. 既存パターン: 類似の実装がないか確認

リスクレベルの評価

分析結果から以下の基準でリスクを判定する:

risk_level	条件	Profile
low	ドキュメントのみ、設定変更、小さな修正、テスト追加	Lite
medium	新機能追加、既存コードの変更、リファクタリング	Standard
high	セキュリティ関連、公開 API 変更、破壊的変更、認証・決済	Strict

Profile 別ゲート適用

Profile	適用ゲート	特徴
Lite	STG0 + STG6 のみ	中間ゲートはスキップ
Standard	STG0 〜 STG6 全て	通常の開発フロー
Strict	STG0 〜 STG6 全て + 人間レビュー必須	STG6 で自動マージしない

---

Step 3: generate_contract（契約の生成）

分析結果から構造化された契約を生成する。

契約の構成要素

フィールド	内容	生成方法
intent	ユーザーの意図（原文保持）	$ARGUMENTS をそのまま
requirements.do	やること（3-5 項目推奨）	意図を具体的なタスクに分解
requirements.do_not	やらないこと（2-3 項目推奨）	典型的な除外項目をテンプレート提案
dod	完了基準（テスト可能な項目）	コードベース分析 + パターンから自動生成
scope.include	影響ファイル・ディレクトリ	分析で特定されたパス
scope.exclude	触らないファイル・ディレクトリ	スコープ外の重要パス
risk_level	low / medium / high	Step 2 の評価結果

初心者への配慮

• ユーザーが曖昧な表現をした場合 → 候補を提案して確認する
• やらないことが想定できない場合 → 典型的な除外項目をテンプレートから自動提示
• 完了基準が書けない場合 → コードベース分析 + パターンから DoD を自動生成
• 技術用語は使わず、結果ベースの日本語で提示する

---

Step 4: user_confirm（ユーザー確認）

以下のフォーマットで契約を日本語で表示し、AskUserQuestion ツールで確認を求める。

契約 UX フォーマット

まずマークダウン形式で以下を表示する。Claude Code がマークダウンをレンダリングするため、 どの環境（Mac/Windows、ターミナル/VSCode 拡張）でも正しく表示される:

## 帳の契約

### やること

- {requirements.do[0]}
- {requirements.do[1]}
- {requirements.do[2]}

### やらないこと

- {requirements.do_not[0]}
- {requirements.do_not[1]}

### できあがりの確認項目

- [ ] {dod[0]}
- [ ] {dod[1]}
- [ ] {dod[2]}

### 影響する場所

`{scope.include[0]}`, `{scope.include[1]}`, ...

### リスク

**{低 / 中 / 高}** -- {Lite / Standard / Strict} プロファイル

フォーマットルール:

• 絵文字・ボックスドローイング文字（┌─┐）を使わない
• マークダウンの ### 見出し・- リスト・- [ ] チェックボックスを使う
• パスは ` で囲みインラインコードとして表示
• 強調は **bold** を使用

その後、AskUserQuestion で以下の選択肢を提示する:

• はい — この内容で帳をおろして実装を開始する
• 修正する — 契約の内容を修正する（Step 3 に戻る）
• やめる — 帳をおろさずに終了する

応答分岐

• はい → Step 5 へ進む
• 修正する → ユーザーの修正指示を受けて Step 3 に戻る（修正ループ）
• やめる → 「帳をおろさずに終了しました。」と表示して終了

---

Step 5: lower_veil（帳をおろす）

ユーザーが「はい」を選択した後、以下を順に実行する。

5a. tobari-session.json の生成

.claude/tobari-session.json に以下のスキーマで書き出す:

{
  "active": true,
  "task": "{$ARGUMENTS の feature 名}",
  "profile": "{lite / standard / strict}",
  "started_at": "{現在の ISO-8601 タイムスタンプ}",
  "gates_passed": ["STG0"],
  "retry_count": 0,
  "token_usage": {
    "input": 0,
    "output": 0,
    "budget": 500000
  },
  "git_state": {
    "branch": "feat/{feature 名のケバブケース}",
    "uncommitted_changes": false,
    "pr_url": null
  },
  "contract": {
    "intent": "{ユーザーの意図原文}",
    "requirements": {
      "do": ["{やること1}", "{やること2}"],
      "do_not": ["{やらないこと1}", "{やらないこと2}"]
    },
    "dod": ["{完了基準1}", "{完了基準2}"],
    "scope": {
      "include": ["{影響パス1}", "{影響パス2}"],
      "exclude": ["{除外パス1}", "{除外パス2}"]
    },
    "risk_level": "{low / medium / high}"
  },
  "learned_permissions": [],
  "evidence": []
}

5b. backlog.yaml にタスク登録

tasks/backlog.yaml を読み取り、既存タスクの最大 ID（TASK-NNN）を検出して +1 する。

新しいタスクエントリを追加:

- id: "TASK-{次の番号}"
  phase: "P4"
  title: "{intent から生成した日本語タイトル}"
  priority: "P1"
  status: "in-progress"
  owner: "Claude Code"
  acceptance:
    - "{dod[0]}"
    - "{dod[1]}"
  evidence: []
  stage_status:
    STG0: "done"
    STG1: "pending"
    STG2: "pending"
    STG3: "pending"
    STG4: "pending"
    STG5: "pending"
    STG6: "pending"
  next_action: "実装開始"
  updated_at: "{今日の日付 YYYY-MM-DD}"

backlog.yaml が存在しない場合は fail-close: 「tasks/backlog.yaml が見つかりません。先に /tobari init でプロジェクトを初期化してください。」

5c. 詠唱 + ステータス表示

以下をマークダウンで出力する:

> 闇より出でて 闇より黒く その穢れを禊ぎ祓え

**帳 -- ACTIVE**

| 項目    | 値                         |
| ------- | -------------------------- |
| Profile | {Lite / Standard / Strict} |
| Task    | {feature 名}               |
| Gates   | STG0 -> STG6               |

- [x] 破壊的操作ブロック
- [x] 秘密情報スキャン
- [x] 境界分類チェック
- [x] 証跡ログ記録（HMAC署名）
- [x] インジェクション検出
- [x] 自動承認・学習
- [x] コスト監視
- [x] 自己修復エンジン

帳の内側で作業を開始します。

---

Notes

• Claude Code が全て直接実行する（外部 CLI 不使用）
• tobari-session.json の生成 + 詠唱表示が主な成果物
• Hook 有効化は /tobari init でセットアップ済みの前提

---

Init Flow: /tobari init

プロジェクトへの帳（とばり）の初回セットアップを行う。

$ARGUMENTS が init の場合にこのフローを実行する。

Init Step 1: 環境チェック      現在の設定状況を確認
Init Step 2: 状況レポート      チェック結果をユーザーに表示
Init Step 3: 確認              不足設定を自動修正するか確認
Init Step 4: 設定の適用        hooks / settings.json / .gitignore を整備
Init Step 5: Webhook 設定      緊急通知の任意設定
Init Step 6: 完了メッセージ    使い方ガイドを表示

---

Init Step 1: 環境チェック

以下をツールで確認する:

チェック項目	ツール	確認方法
Node.js 18+	Bash	node --version
hooks ディレクトリ	Glob	.claude/hooks/*.js の存在確認
settings.json の hooks 設定	Read	.claude/settings.json の hooks キーを確認
.gitignore への tobari-session.json 除外	Grep	tobari-session.json が .gitignore に含まれるか

---

Init Step 2: 状況レポート

チェック結果をマークダウンテーブルでユーザーに表示する:

### 帳のセットアップ状況

| 項目                        | 状態      |
| --------------------------- | --------- |
| Node.js 18+                 | OK / NG   |
| hooks ディレクトリ          | OK / NG   |
| settings.json の hooks 設定 | OK / WARN |
| .gitignore への除外登録     | OK / WARN |

全て OK の場合:

帳のセットアップは完了しています。 /tobari <機能名> で帳をおろして作業を開始できます。 → Init Step 5（Webhook 設定）へスキップ

問題がある場合は Init Step 3 へ進む。

---

Init Step 3: 確認

AskUserQuestion ツールで確認を求める:

• 「問題のある設定を自動で修正しますか？」
  • はい → Init Step 4 へ
  • いいえ（手動で対応します） → Init Step 5 へスキップ

---

Init Step 4: 設定の適用

「はい」の場合のみ実行。問題のある項目を順に修正する。

4a. hooks ディレクトリが存在しない場合

Bash で作成:

mkdir -p .claude/hooks

4b. 必要な hooks ファイルが存在しない場合

以下の hooks ファイルが .claude/hooks/ に存在するか確認し、存在しないものを Write ツールで作成する:

ファイル	役割
tobari-session.js	セッション共有ライブラリ
tobari-stage.js	STG ステージコントローラ
tobari-gate.js	PreToolUse: Gate (止める)
tobari-evidence.js	PostToolUse: Evidence (残す)
tobari-evidence-failure.js	PostToolUseFailure: Evidence (失敗記録)
tobari-stop.js	Stop: Self-Repair (自己修復)
tobari-cost.js	PostToolUse: Cost Monitor (コスト監視)
tobari-permission.js	PermissionRequest: Permission (口)
tobari-precompact.js	PreCompact: Memory (記憶)
tobari-injection-guard.js	PostToolUse: Injection Guard (境界防御)
tobari-session-start.js	SessionStart: Session Init (セッション開始)
lint-on-save.js	PostToolUse: コード品質

4c. settings.json の hooks 設定が不足している場合

.claude/settings.json を Read で読み込み、不足している hooks エントリを Edit で追加する。 最小構成の hooks 設定:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write|NotebookEdit|Bash",
        "hooks": [
          {
            "type": "command",
            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/tobari-gate.js\"",
            "timeout": 10
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Bash|Edit|Write|NotebookEdit|Read|Grep|Glob|WebFetch|WebSearch|Task",
        "hooks": [
          {
            "type": "command",
            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/tobari-evidence.js\"",
            "timeout": 5
          }
        ]
      },
      {
        "matcher": "Bash|Edit|Write|NotebookEdit|Read|Grep|Glob|WebFetch|WebSearch|Task",
        "hooks": [
          {
            "type": "command",
            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/tobari-cost.js\"",
            "timeout": 5
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/tobari-stop.js\"",
            "timeout": 30
          }
        ]
      }
    ],
    "PermissionRequest": [
      {
        "matcher": ".*",
        "hooks": [
          {
            "type": "command",
            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/tobari-permission.js\"",
            "timeout": 10
          }
        ]
      }
    ],
    "PreCompact": [
      {
        "matcher": "auto",
        "hooks": [
          {
            "type": "command",
            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/tobari-precompact.js\"",
            "timeout": 5
          }
        ]
      }
    ]
  }
}

4d. .gitignore に tobari-session.json が未登録の場合

.gitignore に以下を追記（Edit ツール使用）:

# tobari — session state (contains task secrets, do not commit)
.claude/tobari-session.json

---

Init Step 5: Webhook 設定（任意）

AskUserQuestion ツールで確認:

• 「緊急通知用の Webhook を設定しますか？（任意、後からでも設定できます）」
  • 設定する → Webhook URL の入力を促す（フォローアップ質問）
  • スキップする → そのまま Init Step 6 へ

Webhook URL が入力された場合: .claude/tobari-session.json を Read で確認し、webhook_url フィールドを設定する（ファイルが存在しない場合は skeleton を Write で作成）。

注意: Webhook は一方向の緊急通知（fire-and-forget）。Discord / Slack / GitHub webhook が利用可能。

---

Init Step 6: 完了メッセージ

以下をテキスト出力する:

**帳のセットアップが完了しました。**

**帳 -- READY**

- [x] 破壊的操作ブロック
- [x] 秘密情報スキャン
- [x] 境界分類チェック
- [x] 証跡ログ記録（HMAC署名）
- [x] インジェクション検出
- [x] 自動承認・学習
- [x] コスト監視
- [x] 自己修復エンジン

### 次のステップ

帳をおろして作業を開始するには:

- `/tobari ログイン機能を追加`
- `/tobari READMEを日本語化`
- `/tobari APIのエラーハンドリングを改善`

帳はあなたの代わりに安全を守ります。安心して作業に集中してください。

---

Amend Flow: /tobari amend

帳をおろしたまま契約スコープを修正する軽量フロー。

$ARGUMENTS が amend の場合にこのフローを実行する。 完全な /tobari の再実行なしに、スコープの追加・除外を変更できる。

/tobari amend
  │
  ▼
Amend Step 1: verify_session    セッションの存在確認
  │
  ▼
Amend Step 2: show_current      現在のスコープ表示
  │
  ▼
Amend Step 3: collect_changes   変更内容を収集
  │
  ▼
Amend Step 4: user_confirm      修正内容を確認
  │
  ▼
Amend Step 5: apply_amendment   tobari-session.json 更新 + 証跡記録

---

Amend Step 1: verify_session

tobari-session.json が存在し active: true であることを確認する。

fail-close 条件:

• セッションファイルが存在しない場合
• active: false の場合

→ 「帳が下りていません。先に /tobari <機能名> で帳をおろしてください。」と表示して終了。

---

Amend Step 2: show_current

現在の契約スコープをマークダウンで表示する:

### 現在の契約スコープ

**含む（include）:**

- `{scope.include[0]}`
- `{scope.include[1]}`

**除外（exclude）:**

- `{scope.exclude[0]}` （空の場合は「なし」）

---

Amend Step 3: collect_changes

AskUserQuestion で変更内容を収集する:

• 「追加したいパス、または除外したいパスを教えてください。」
• 例: 「.claude/skills/ を追加」「src/legacy/ を除外」

---

Amend Step 4: user_confirm

修正後のスコープを表示し、AskUserQuestion で確認する:

### 修正後のスコープ

**含む（include）:**

- `{新しい include リスト}`

**除外（exclude）:**

- `{新しい exclude リスト}`

• はい → Amend Step 5 へ
• やめる → 「スコープの変更を中止しました。」と表示して終了

---

Amend Step 5: apply_amendment

Bash で CLI エントリポイントを呼び出してスコープを更新する:

node .claude/hooks/tobari-session.js amend-scope '{"include":[...],"exclude":[...]}' '変更理由'

成功時、以下を表示する:

**スコープを更新しました。**

| 項目 | 値                   |
| ---- | -------------------- |
| 理由 | {変更理由}           |
| 証跡 | Evidence Ledger 記録 |

帳の内側で作業を続けてください。