mb-init — Initialize Memory Bank skeleton

• What it does: creates the base folders, core docs, and project-native command proxies.
• Use it when: you want the skeleton only, without immediately choosing PRD or brownfield mapping.
• Input: repository root.
• Output: .memory-bank/, .tasks/, .protocols/, AGENTS.md, and generated command stubs.

Goal

Create a consistent baseline so agents can work with repo-local context instead of ad-hoc prompts.

Steps

1) Create directories

Create (if missing):

• .memory-bank/ with subfolders (see ./references/shared-structure-template.md)
• .tasks/
• .protocols/

2) Create core Memory Bank files

From templates, create:

• AGENTS.md
• CLAUDE.md → symlink/copy to AGENTS.md
• .memory-bank/index.md
• .memory-bank/mbb/index.md
• .memory-bank/product.md
• .memory-bank/requirements.md
• .memory-bank/tasks/backlog.md
• .memory-bank/testing/index.md
• .memory-bank/skills/index.md

3) Create command stubs

So links from AGENTS.md are not broken, create minimal docs under .memory-bank/commands/. Use ./references/shared-commands-*.md:

• mb.md
• prd.md
• prd-to-tasks.md
• execute.md
• verify.md
• autopilot.md
• autonomous.md
• map-codebase.md
• discuss.md
• add-tests.md
• review.md
• find-skill.md

4) Create native skills (proxy commands)

Create thin proxy skills for each command so they work natively across runtimes:

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

Each proxy contains: Read and follow the instructions in .memory-bank/commands/<name>.md. This registers commands natively: /mb in Claude Code, $mb in Codex, /mb in OpenCode.

The init-mb.js script creates both sets automatically.

5) Enforce MBB rules immediately

• Every .memory-bank/**/*.md must have frontmatter (description, status).

Optional fast path

If Node.js is available, you may run the helper script (safe: doesn’t overwrite existing files):

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

If you don’t want a script, just create the files manually using the templates.

Definition of done

• AGENTS.md exists and points to .memory-bank/index.md.
• CLAUDE.md exists and mirrors AGENTS.md.
• .memory-bank/ has the seeded docs.
• .memory-bank/commands/ has stub command docs.
• .tasks/ and .protocols/ exist.