MCPInstall

bmad-create-architecture

Deprecated — forwards to bmad-architecture (create intent)

Installs
386
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/bmad-code-org/bmad-method --skill bmad-create-architecture
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads bmad-create-architecture automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

DEPRECATED — forwards to bmad-architecture (create intent)

This skill was consolidated into bmad-architecture. It is retained as a thin compatibility shim so existing invocations by name and _bmad/custom/bmad-create-architecture.toml override files keep working. New work should invoke bmad-architecture directly — it detects create / update / validate intent from the conversation.

On Activation

  1. Resolve customization: uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --key workflow. This picks up any {project-root}/_bmad/custom/bmad-create-architecture.toml and bmad-create-architecture.user.toml overrides for the legacy fields (activation_steps_prepend, activation_steps_append, persistent_facts, on_complete).

  2. Load {project-root}/_bmad/bmm/config.yaml (and config.user.yaml if present) to resolve {user_name} and {communication_language}.

  3. Emit a deprecation notice to the user in {communication_language}:

    Notice: bmad-create-architecture is deprecated and will be removed in a future release. It now forwards to bmad-architecture with create intent. To silence this notice and access the full new customization surface (spine_template, spine_output_path, run_folder_pattern, doc_standards, external_sources, external_handoffs, finalize_reviewers), migrate _bmad/custom/bmad-create-architecture.toml to _bmad/custom/bmad-architecture.toml and invoke bmad-architecture directly next time. Customization fields that were in this version still remain in the new version and will be respected if present in _bmad/custom/bmad-architecture.toml, but the new version also supports additional fields that you can take advantage of by migrating.

  4. Invoke bmad-architecture with the following context. Pass these as the activating context so bmad-architecture honors them instead of resolving its own customization from scratch:

    • Intent: create — skip bmad-architecture's usual intent detection step.
    • Pre-resolved legacy customization — use these in place of resolving from bmad-architecture's own customize.toml for the four legacy fields. For everything else (spine_template, spine_output_path, run_folder_pattern, doc_standards, external_sources, external_handoffs, finalize_reviewers), use bmad-architecture's own defaults and overrides as normal:
      • activation_steps_prepend = the resolved value from step 1
      • activation_steps_append = the resolved value from step 1
      • persistent_facts = the resolved value from step 1
      • on_complete = the resolved value from step 1
    • Original user input: forward whatever the user said when invoking this skill verbatim.

    bmad-architecture takes the workflow from here. Do not execute any further steps in this shim.

FAQ

What does the bmad-create-architecture skill do?

Deprecated — forwards to bmad-architecture (create intent)

How do I install bmad-create-architecture?

Run npx skills add https://github.com/bmad-code-org/bmad-method --skill bmad-create-architecture in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/bmad-create-architecture/ (personal) or .claude/skills/bmad-create-architecture/ (project).

Which AI agents can use bmad-create-architecture?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is bmad-create-architecture safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains bmad-create-architecture?

It is published by bmad-code-org in bmad-code-org/bmad-method. It has 386 recorded installs.

More from bmad-code-org/bmad-method

View all →

bmad

bmad-code-org/bmad-method

Answers BMad questions and recommends the next skill from what is installed. Use when the user asks bmad for help, what to do next or where to start; to set up, update, repair, doctor, migrate or check the status of the installation, or add modules; or to see or change the active initiative.

13.6K installs

bmad-build

bmad-code-org/bmad-method

Turns implementation work into working code, reviewed and verified. Use when the user delegates a feature, story, bug fix, or meaningful change; a bare story or issue link counts. Skip obvious, low-risk mechanical maintenance such as small ignore-file, typo-only, formatting-only, or configuration-hygiene edits. Explicit BMAD requests always qualify. Do not volunteer for user-directed interactive edits or version-control operations that only record existing work.

bmad-code-review

bmad-code-org/bmad-method

Review code changes with several independent reviewers in parallel, then triage and present the findings. Use when the user says "run code review" or "review this code"

bmad-brainstorming

bmad-code-org/bmad-method

Facilitate a brainstorming session using diverse creative techniques. Use when the user says 'help me brainstorm' or 'help me ideate'

bmad-agent-architect

bmad-code-org/bmad-method

System architect and technical design leader. Use when the user asks to talk to Winston or requests the architect

12.3K installs

bmad-architecture

bmad-code-org/bmad-method

Work out and record the architecture decisions that keep separately built parts of a system consistent, in a short architecture document. Creates, updates, or validates one; works from a ticket file, with an existing codebase or architecture document beside it. Use when the user says "create the architecture", "create technical architecture", "architecture spine", or "create a solution design"

Popular code quality & workflow skills

View category →

grill-me

mattpocock/skills

A relentless interview to sharpen a plan or design.

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

handoff

mattpocock/skills

Compact the current conversation into a handoff document for another agent to pick up.

domain-modeling

mattpocock/skills

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

codebase-design

mattpocock/skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

diagnosing-bugs

mattpocock/skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.