mergegate/.codex/instructions.md

Codex Instructions — Polaris (miyabi-gate)

バイナリ: ~/bin/miyabi-gate

このリポで作業する前に 必ず miyabi-gate gate を使うこと。 使わずにファイルを編集すると pre-commit hook が拒否する。

初回（このリポで初めて作業する場合）

miyabi-gate gate init

タスク実行フロー（必ずこの順序で実行）

# 1. タスク登録（Issue 番号必須）
miyabi-gate gate register --issue 45 --title "認証機能修正"

# 業務タスク（コード変更なし）の場合:
miyabi-gate gate register --issue 45 --title "ドキュメントレビュー" --completion-mode manual

# 2. 影響分析を記録
miyabi-gate gate impact <task-id> --risk low --symbols 3
# HIGH/CRITICAL は承認必須:
miyabi-gate gate impact <task-id> --risk high --symbols 12 --approve

# 3. ファイルロック獲得（ここから作業開始）
miyabi-gate gate assign <task-id> --agent codex --node macbook --files "src/auth.rs"
# → 実行プランが表示される。それに従う。

# 4. ロックしたファイルだけを編集する

# 5a. コードタスクの完了:
miyabi-gate gate branch <task-id> feature/issue-45-auth
miyabi-gate gate pr <task-id> 78
miyabi-gate gate merge <task-id> <40文字SHA>

# 5b. 業務タスクの完了:
miyabi-gate gate manual-complete <task-id> --reason "完了理由" --operator codex

確認コマンド

miyabi-gate gate status              # 全タスク一覧
miyabi-gate gate locks               # ロック中ファイル一覧
miyabi-gate gate dag                 # DAG 依存関係
miyabi-gate gate dispatchable        # 実行可能タスク
miyabi-gate gate attach <task-id>    # コンテキスト表示
miyabi-gate gate --format json status # JSON 出力

緊急時

miyabi-gate gate force-unlock <task-id> --reason "理由" --operator codex

禁止

• miyabi-gate gate assign なしでファイル編集 → pre-commit hook が拒否
• 他エージェントのロック中ファイルに触る → CLI が拒否 (exit 1)
• Issue なしでタスク開始 → GATE 0 が拒否

exit code

• 0: 成功
• 1: GATE 拒否（条件を満たしてリトライ）
• 2: 入力エラー（コマンド修正）

コミット規約

日本語タグ形式: [追加], [修正], [改善], [整備], [文書], [検証], [完了] Issue 番号を含める: [修正] 認証機能 (#45)

品質チェック（コミット前）

cargo test --all
cargo clippy --all-targets --all-features -- -D warnings