Skip to content

Install BMAD Method (core + BMM) and add Codex skills#6

Open
JT5D wants to merge 1 commit into
mainfrom
codex/install-bmad
Open

Install BMAD Method (core + BMM) and add Codex skills#6
JT5D wants to merge 1 commit into
mainfrom
codex/install-bmad

Conversation

@JT5D

@JT5D JT5D commented Jun 5, 2026

Copy link
Copy Markdown
Member

Motivation

  • Add the BMAD Method tooling and the BMM module to provide Codex-facing agent skills and project-level workflows for product, UX, architecture, research, and developer flows.
  • Provide an on-repo, opinionated set of agent skill definitions and templates so AI agents can be run locally against this project with consistent behavior.

Description

  • Installed BMAD Core + BMAD Method (v6.8.0) into _bmad/ and generated the Codex skill catalog under .agents/skills/, adding many workflow skill definitions, templates, and helper scripts (project context, PRD, epics/stories, architecture, brainstorming, code-review, investigate, document-project, market/domain research, party-mode, and more).
  • Added the BMAD installer integration and helper tooling including _bmad/scripts/ and an executable scanner bmad-customize/scripts/list_customizable_skills.py with unit tests and related test helpers.
  • Updated repository defaults by adding .gitignore entries to exclude Python bytecode and caches and created a number of templates/assets for workflows (PRD templates, validation skeletons, research templates, deep-dive templates, etc.).
  • Installer run used to generate the files: npx bmad-method install --directory . --modules bmm --tools codex --yes, which produced _bmad/ and .agents/skills/ content and configuration manifests.

Testing

  • Ran the unit test suite for the installer helpers with python3 -m pytest _bmad/scripts/tests which passed: 1 passed.
  • Performed local checks and validations while generating/cleaning files (whitespace and template fixes) prior to preparing this PR.

Codex Task

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 53d4401d00

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

else:
output = merged

sys.stdout.write(json.dumps(output, indent=2, ensure_ascii=False) + "\n")

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Write resolve_config output as UTF-8

On Windows shells or any environment with a non-UTF-8 stdout (for example PYTHONIOENCODING=cp1252), resolving the agent roster now fails because the merged config contains emoji icons and this write emits raw Unicode via ensure_ascii=False. The companion customization resolver already reconfigures stdout for this exact scenario; without the same handling here, bmad-party-mode and bmad-advanced-elicitation cannot load agents in those environments.

Useful? React with 👍 / 👎.

BMad Method,bmad-checkpoint-preview,Checkpoint,CK,Guided walkthrough of a change from purpose and context into details. Use for human review of commits branches or PRs.,,,4-implementation,,,false,,
BMad Method,bmad-qa-generate-e2e-tests,QA Automation Test,QA,Generate automated API and E2E tests for implemented code. NOT for code review or story validation — use CR for that.,,,4-implementation,bmad-dev-story,,false,implementation_artifacts,test suite
BMad Method,bmad-retrospective,Retrospective,ER,Optional at epic end: Review completed work lessons learned and next epic or if major issues consider CC.,,,4-implementation,bmad-code-review,,false,implementation_artifacts,retrospective
BMad Method,bmad-document-project,Document Project,DP,Analyze an existing project to produce useful documentation.,,,anytime,,,false,project-knowledge,*

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Use the actual project_knowledge variable name

Rows that use project-knowledge cannot be resolved by bmad-help, because the installed config keys are project_knowledge in both _bmad/config.toml and _bmad/bmm/config.yaml (neighboring catalog rows also use the underscore form). For this row the output location is only project-knowledge, so BMad Help will miss existing project documentation and completion artifacts for Document Project instead of checking the configured docs folder.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant