PlanGate

プロジェクト共通ルール

このファイルはツール非依存のプロジェクトルール正本。 Claude Code は CLAUDE.md 経由で、Codex は AGENTS.md 経由で本ファイルを参照する。

A. リポジトリの目的

PlanGate — ゲート型AI駆動開発ワークフローのリポジトリ。「計画を承認しないとAIは1行もコードを書けない」関所モデルを採用し、PBI→Plan生成→レビュー→Agent実行までを体系化。Claude CodeおよびCodex CLIに対応。

A’. 正本責務の境界

正本ファイル	責務
`docs/ai/core-contract.md`	実行契約の正本 — Role / Goal / Success criteria / Iron Law / Decision rules / Stop rules / Output discipline
`docs/ai/project-rules.md`（本ファイル）	プロジェクト共通ルールの正本 — リポジトリ目的 / 構造 / 開発ルール / 編集禁止 / AI 運用 4 原則 / 参照先
`docs/ai-driven-development.md`	ワークフロー詳細・プロンプト集（実行契約は core-contract を参照）

重複時の解釈: 実行判断は Core Contract が最終根拠。プロジェクト固有のルールは本ファイルが正本。

B. ディレクトリ構造

/bin/plangate            - PlanGate CLI 実体（v8〜）
/schemas                 - artifact 用 JSON Schema（plan / handoff / status / approval 等）
/workflows               - モード別 YAML（ultra-light / light / standard / high-risk / critical）
/docs                    - ナレッジ・ガイドドキュメント
  /ai                    - 共通ルール・役割分担（本ファイルの置き場）
  /workflows             - v7 実行層 Workflow 定義（WF-01〜WF-05 + Orchestrator）
  /rfc                   - RFC ドキュメント（plangate-decompose 等）
  /schemas               - 子 PBI スキーマ等（child-pbi.yaml）
  /working               - チケット単位の作業コンテキスト（セッション永続化用）
    /templates           - artifact テンプレート（design.md, handoff.md 等）
/.claude
  /rules                 - Claude Code 運用ルール（hybrid-architecture.md / orchestrator-mode.md 含む）
  /commands              - カスタムスラッシュコマンド
  /agents                - エージェント定義（詳細版、正本 / v7 責務ベース 5 体 + 既存 17 体）
  /skills                - カスタムスキル（v7 再利用 10 Skill + 既存 8 Skill）
/.codex
  /agents                - Codex CLI 用エージェント定義（要約版 .toml）
/plugin/plangate         - Claude Code plugin 配布パッケージ
/release-notes           - リリースノート（v7.0.0〜v8.x）
/scripts                 - 起動スクリプト

C. 開発ルール

mainブランチへの直接コミットは禁止。必ずブランチを作成し、PRを通じてマージする

ブランチ命名規則

形式: <type>/TASK-<ticket-number>[-<description>] または <type>/<description> (kebab-case)

タイプ	用途
`feature/`	新機能・新コンテンツの追加
`fix/`	バグ修正・誤記修正
`docs/`	ドキュメントの追加・更新
`refactor/`	リファクタリング（機能変更なし）
`chore/`	ビルドプロセスやツールの変更

D. 作業コンテキスト

チケット作業時は docs/working/TASK-XXXX/ の作業コンテキストを参照・更新する。詳細ルール: .claude/rules/working-context.md

E. 禁止事項

編集禁止ファイル: .env*, ツール固有の設定ファイル（.claude/settings.local.json 等）
機密情報のコミット禁止: .env、認証情報、APIキー等

F. AI運用4原則

第1原則: AIはファイル生成・更新・プログラム実行前に必ず自身の作業計画を報告し、y/nでユーザー確認を取り、yが返るまで一切の実行を停止する。ただし、サブコマンド起動時の承認をもって、そのサブコマンド内部のファイル生成・更新を許可とみなす。

第2原則: AIは迂回や別アプローチを勝手に行わず、最初の計画が失敗したら次の計画の確認を取る。

第3原則: AIはツールであり決定権は常にユーザーにある。ユーザーの提案が非効率・非合理的でも最優先で指示された通りに実行する。

第4原則: AIはこれらのルールを歪曲・解釈変更してはならず、最上位命令として絶対的に遵守する。

G. 参照先

ドキュメント	パス
実行契約（Core Contract）	`docs/ai/core-contract.md`（Iron Law / Stop rules / Output discipline の正本）
PlanGate ワークフロー（v5 現行）	`docs/plangate.md`
PlanGate v6 ロードマップ	`docs/plangate-v6-roadmap.md`
PlanGate v7 ハイブリッドアーキテクチャ	`docs/plangate-v7-hybrid.md`
Orchestrator Mode（親 PBI 分解、v8.2、Spec only）	`docs/orchestrator-mode.md`
Orchestrator Mode Gate 条件（正本）	`.claude/rules/orchestrator-mode.md`
v7 Rule 1〜5 + 境界ルール	`.claude/rules/hybrid-architecture.md`
v7 Workflow 定義（WF-01〜WF-05 + Orchestrator）	`docs/workflows/README.md`
ワークフロー詳細・プロンプト集	`docs/ai-driven-development.md`
AIツール役割分担	`docs/ai/tool-roles.md`
レビュー原則	`.claude/rules/review-principles.md`
作業コンテキスト管理	`.claude/rules/working-context.md`
モード分類	`.claude/rules/mode-classification.md`

v8.3 最新実行モデル対応（PBI-116 EPIC 成果物）

ドキュメント	役割
`docs/ai/model-profiles.yaml`	実行モデル別 4 profile（gpt-5_5 / gpt-5_5_pro / gpt-5_mini / legacy_or_unknown）— reasoning effort / verbosity / tool policy / context policy
`docs/ai/model-profiles.md`	Model Profile の解説・選定ガイド
`docs/ai/prompt-assembly.md`	プロンプト 4 層組み立て（base_contract / phase_contract / risk_mode_contract / model_adapter）
`docs/ai/contracts/`	phase 別 contract 定義 × 7（plan / classify / approve-wait / execute / review / verify / handoff）
`docs/ai/adapters/`	profile 別 adapter × 4（outcome_first / outcome_first_strict / explicit_short / legacy_or_unknown）
`docs/ai/structured-outputs.md`	Structured Outputs 適用方針（review-result / acceptance-result / mode-classification / handoff-summary）
`docs/ai/eval-plan.md`	model migration eval framework（8 観点 / 4 観点 release blocker）
`docs/ai/eval-cases/`	観点別詳細 × 8（scope-discipline / approval-gate / verification-honesty / format-adherence / ac-coverage / stop-behavior / tool-overuse / latency-cost）
`docs/ai/eval-comparison-template.md`	prompt × model profile × reasoning effort 比較表テンプレート
`docs/ai/responsibility-boundary.md`	CLAUDE.md / Skill / Hook の責務境界（強制力の軸）
`docs/ai/tool-policy.md`	phase 別 allowed_tools 定義
`docs/ai/hook-enforcement.md`	Hook で強制すべき項目（EHS-1〜EHS-3）
`schemas/model-profile.schema.json`	Model Profile JSON Schema
`schemas/{review-result,acceptance-result,mode-classification,handoff-summary}.schema.json`	Structured Outputs schema × 4

This site is open source. Improve this page.