mb-init

mb-init — Memory Bank のスケルトンを初期化する

• 内容： 基本フォルダー、コアドキュメント、プロジェクトネイティブのコマンドプロキシを作成します。
• 使用する場面： PRD を選択したり、既存コードベースのマッピングをすぐに始めたりせず、スケルトンだけを作成したい場合に使用します。
• 入力： リポジトリのルート。
• 出力： .memory-bank/、.tasks/、.protocols/、AGENTS.md、生成されたコマンドスタブ。

目標

エージェントが場当たり的なプロンプトではなく、リポジトリ内のコンテキストを使って作業できるよう、一貫したベースラインを作成します。

手順

1) ディレクトリを作成する

存在しない場合は、以下を作成します。

• サブフォルダーを含む .memory-bank/（./references/shared-structure-template.md を参照）
• .tasks/
• .protocols/

2) Memory Bank のコアファイルを作成する

テンプレートから以下を作成します。

• AGENTS.md
• CLAUDE.md → AGENTS.md へのシンボリックリンク／コピー
• .memory-bank/index.md
• .memory-bank/constitution.md
• .memory-bank/mbb/index.md
• .memory-bank/spec-index.md
• .memory-bank/glossary.md
• .memory-bank/invariants.md
• .memory-bank/product.md
• .memory-bank/requirements.md
• .memory-bank/schemas/task.schema.json
• .memory-bank/tasks/index.json
• .memory-bank/testing/index.md
• .memory-bank/skills/index.md

PRD を作成しない新規ブートストラップでは、.memory-bank/features/FT-001-*.md、.memory-bank/tasks/TASK-001.task.json、その他の架空のロードマップ成果物を作成してはいけません。.memory-bank/tasks/index.json は { "version": 1, "tasks": [] } から開始します。/write-prd は明確化された PRD を作成し、/spec-init は軽量な SDD ルートマップのみを準備し、/prd は実際の機能を作成し、必須の /spec-design は最小限または完全なバックボーンゲートを作成し、/spec-improve FT-<NNN> は機能設計を完成させるか不要とマークし、その後に /prd-to-tasks FT-<NNN> が実際の TASK-*.task.json レコードを作成します。明示的に保留中／ブロック中の機能に対する /clarify-feature FT-<NNN> は任意です。

必須にはせず、より充実した規範レイヤーをサポートする任意のフォルダーも作成します。

• .memory-bank/contracts/
• .memory-bank/states/
• .memory-bank/runbooks/

3) コマンドスタブを作成する

AGENTS.md からのリンクが切れないよう、.memory-bank/commands/ に最小限のドキュメントを作成します。 ./references/shared-commands-*.md を使用します。

• mb.md
• analysis.md
• brainstorm.md
• brief.md
• constitution.md
• write-prd.md
• spec-init.md
• prd.md
• spec-design.md
• spec-improve.md
• spec-auto.md
• clarify-feature.md
• prd-to-tasks.md
• execute.md
• verify.md
• red-verify.md
• autopilot.md
• autonomous.md
• map-codebase.md
• discuss.md
• add-tests.md
• review.md
• find-skills.md

4) ネイティブスキル（プロキシコマンド）を作成する

各コマンドの薄いプロキシスキルを作成し、複数のランタイムでネイティブに動作するようにします。

• .claude/skills/<name>/SKILL.md → Claude Code + OpenCode
• .agents/skills/<name>/SKILL.md → Codex CLI + OpenCode

各プロキシには、次の内容を記述します。.memory-bank/commands/<name>.md の指示を読み、それに従ってください。 これにより、コマンドがネイティブに登録されます。Claude Code では /mb、Codex では $mb、OpenCode では /mb を使用します。

init-mb.js スクリプトは、両方のセットを自動的に作成します。

エージェントは、初期化の早い段階で .memory-bank/constitution.md を読み込む必要があります。このファイルにはプロジェクトを統制する原則が記録されており、.memory-bank/invariants.md、.memory-bank/contracts/*、.memory-bank/spec-index.md の代わりにはなりません。これらの原則を作成または修正する場合にのみ、/constitution を使用してください。

5) MBB ルールを直ちに適用する

• すべての .memory-bank/**/*.md にフロントマター（description、status）を設定する必要があります。

任意の高速パス

Node.js が使用可能な場合は、ヘルパースクリプトを実行できます（安全です。既存のファイルは上書きしません）。

# Option A: copy ./scripts/shared-init-mb.js into your repo then run:
node scripts/init-mb.js

スクリプトを使わない場合は、テンプレートを使ってファイルを手動で作成してください。

完了の定義

• AGENTS.md が存在し、.memory-bank/index.md を参照しています。
• CLAUDE.md が存在し、AGENTS.md の内容を反映しています。
• .memory-bank/ に初期ドキュメントが用意されています。
• .memory-bank/constitution.md が統治原則のドキュメントとして存在し、.memory-bank/commands/ で /constitution を利用できます。
• .memory-bank/tasks/index.json と .memory-bank/schemas/task.schema.json が存在し、タスクの状態は JSON に基づいて管理されます。
• PRD のないスケルトンでは、.memory-bank/tasks/index.json の tasks 配列が空になっています。
• スケルトンのブートストラップでは、架空の機能ドキュメントは作成されません。タスク計画は後から /write-prd、/spec-init、/prd、必須の /spec-design、/spec-improve FT-<NNN>、続いて /prd-to-tasks FT-<NNN> の順に開始します。
• ブートストラップによって .memory-bank/tasks/TASK-001.task.json が作成されることはありません。
• 今後のタスクレコードには必須の tier: T0|T1|T2|T3 を含める必要があります。ルーティングは task.tier のみを通じて行い、削除された risk / risk.level モデルは使用しません。
• .memory-bank/commands/ にスタブのコマンドドキュメントがあります。
• .tasks/ と .protocols/ が存在します。