{"id":44938643,"url":"https://github.com/xmm/codex-bmad-skills","last_synced_at":"2026-04-20T12:04:05.967Z","repository":{"id":337716750,"uuid":"1153935146","full_name":"xmm/codex-bmad-skills","owner":"xmm","description":"BMAD skills and workflows for OpenAI Codex (App, CLI, Web): intent-based execution, YAML project state, and reusable skill packs for planning, architecture, sprint delivery, development, and code review.","archived":false,"fork":false,"pushed_at":"2026-02-18T06:11:11.000Z","size":363,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-18T10:43:10.966Z","etag":null,"topics":["agent-skills","agentic-ai","agentic-workflow","agile","ai-coding-agent","ai-skills","analysis","bmad","code-reviews","codex","codex-cli","developer-tool","openai-codex","product-management","prompt-engineering","software-architecture","workflow"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xmm.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-09T20:49:28.000Z","updated_at":"2026-02-18T06:10:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/xmm/codex-bmad-skills","commit_stats":null,"previous_names":["xmm/codex-bmad-skills"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/xmm/codex-bmad-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xmm%2Fcodex-bmad-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xmm%2Fcodex-bmad-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xmm%2Fcodex-bmad-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xmm%2Fcodex-bmad-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xmm","download_url":"https://codeload.github.com/xmm/codex-bmad-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xmm%2Fcodex-bmad-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29980913,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T16:35:47.903Z","status":"ssl_error","status_checked_at":"2026-03-01T16:35:44.899Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","agentic-ai","agentic-workflow","agile","ai-coding-agent","ai-skills","analysis","bmad","code-reviews","codex","codex-cli","developer-tool","openai-codex","product-management","prompt-engineering","software-architecture","workflow"],"created_at":"2026-02-18T08:00:56.859Z","updated_at":"2026-03-01T19:04:46.088Z","avatar_url":"https://github.com/xmm.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BMAD Skills for OpenAI Codex\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![OpenAI Codex](https://img.shields.io/badge/OpenAI%20Codex-Native-orange.svg)](https://openai.com/codex/)\n\nBMAD Skills for OpenAI Codex adds a structured, intent-driven workflow to Codex for **product discovery, planning, architecture, and implementation.**\n\nIt installs reusable BMAD skills, introduces `bmad:*` intents, and keeps project workflow state in explicit YAML files inside your repository.\n\nOriginal GitHub project: [xmm/codex-bmad-skills](https://github.com/xmm/codex-bmad-skills)\n\n## What This Project Does\n\nThis repository provides:\n\n- BMAD skills that can be installed into Codex\n- intent-based workflow routing via `bmad:*`\n- project-local workflow state in `bmad/*.yaml`\n- a repeatable path from idea to implementation\n\nUse it when you want Codex to guide work through defined phases instead of relying on ad-hoc prompts.\n\n## Who This Is For\n\nThis project is for:\n\n- developers using OpenAI Codex as a primary coding assistant\n- teams that want a consistent AI-assisted delivery workflow\n- projects that need explicit planning and traceable workflow state\n\n## Quick Start\n\n### Requirements\n\n- `yq` v4+\n- `python3` (or `python`)\n\nThe installers validate both dependencies before install.\n\n### Install\n\n#### Install to the default global path\n\n```bash\n./installers/install-codex.sh\n```\n\n#### Install to a custom path (example: project-local)\n\n```bash\n./installers/install-codex.sh --dest \"\u003cproject\u003e/.agents/skills\"\n```\n\n#### Windows PowerShell\n\n```powershell\n./installers/install-codex.ps1\n./installers/install-codex.ps1 -Dest \"\u003cproject\u003e\\.agents\\skills\"\n```\n\nNotes:\n\n- `--dest` and `-Dest` are optional\n- the default destination is `$HOME/.agents/skills`\n- restart Codex after installation so it reloads newly installed skills\n\n### Start Codex\n\n```bash\ncodex\n```\n\n### Initialize BMAD in a Project\n\n```text\nbmad:init name \"My Project\" communication language is English documentation language is English\n```\n\n### Check Current Status\n\n```text\nbmad:status\nbmad:next\n```\n\nFor a guided walkthrough, see [Getting Started](docs/getting-started.md).\n\n## What Gets Created\n\nAfter initialization, the project contains:\n\n- `bmad/project.yaml` - project settings and language preferences\n- `bmad/workflow-status.yaml` - current workflow phase and progress\n- `bmad/sprint-status.yaml` - sprint and delivery tracking\n- `docs/bmad/` - generated BMAD documents\n- `docs/stories/` - implementation stories\n\n## How The Workflow Works\n\nBMAD in Codex is organized into four main phases.\n\n### 1. Analysis\n\nUse this phase to explore the problem space and define direction.\n\nTypical intents:\n\n- `bmad:product-brief`\n- `bmad:research`\n- `bmad:brainstorm`\n\nTypical outputs:\n\n- `docs/bmad/product-brief.md`\n- `docs/bmad/research-report.md`\n- `docs/bmad/brainstorm.md`\n\n### 2. Planning\n\nUse this phase to turn discovery into scoped plans and product documentation.\n\nTypical intents:\n\n- `bmad:prd`\n- `bmad:tech-spec`\n- `bmad:prioritize`\n- `bmad:ux-design`\n\nTypical outputs:\n\n- `docs/bmad/prd.md`\n- `docs/bmad/tech-spec.md`\n- `docs/bmad/prioritization.md`\n- `docs/bmad/ux-design.md`\n\nPlanning rules:\n\n- level 0-1 projects require `tech-spec`\n- level 2-4 projects require `prd` and `architecture`\n\n### 3. Solutioning\n\nUse this phase to define architecture and validate readiness before implementation.\n\nTypical intents:\n\n- `bmad:architecture`\n- `bmad:gate-check`\n\nTypical outputs:\n\n- `docs/bmad/architecture.md`\n- `docs/bmad/gate-check.md`\n\n### 4. Implementation\n\nUse this phase to plan delivery, create stories, build, and review.\n\nTypical intents:\n\n- `bmad:sprint-plan`\n- `bmad:create-story`\n- `bmad:dev-story`\n- `bmad:code-review`\n\nTypical outputs:\n\n- `docs/bmad/sprint-plan.md`\n- `docs/stories/STORY-*.md`\n- implemented code and tests in the repository\n- optional `docs/bmad/code-review.md`\n\n### Extension and Innovation\n\nThese intents are optional and can be used in any phase:\n\n- `bmad:create-skill`\n- `bmad:create-workflow`\n- `bmad:ideate`\n- `bmad:research-deep`\n- `bmad:user-flow`\n\n## Core Intents\n\n### Orchestration\n\n- `bmad:init`\n- `bmad:status`\n- `bmad:next`\n\n### Discovery\n\n- `bmad:product-brief`\n- `bmad:research`\n- `bmad:brainstorm`\n\n### Planning\n\n- `bmad:prd`\n- `bmad:tech-spec`\n- `bmad:prioritize`\n\n### Architecture\n\n- `bmad:architecture`\n- `bmad:gate-check`\n\n### Delivery\n\n- `bmad:sprint-plan`\n- `bmad:create-story`\n- `bmad:dev-story`\n- `bmad:code-review`\n\n### UX and Extensions\n\n- `bmad:ux-design`\n- `bmad:user-flow`\n- `bmad:ideate`\n- `bmad:research-deep`\n- `bmad:create-skill`\n- `bmad:create-workflow`\n\n## Repository Layout\n\n```text\n.\n├── AGENTS.md\n├── installers/\n├── skills/\n│   ├── bmad-orchestrator/\n│   ├── bmad-analyst/\n│   ├── bmad-product-manager/\n│   ├── bmad-architect/\n│   ├── bmad-scrum-master/\n│   ├── bmad-developer/\n│   ├── bmad-ux-designer/\n│   ├── bmad-creative-intelligence/\n│   ├── bmad-builder/\n│   └── bmad-shared/\n└── docs/\n```\n\nKey directories:\n\n- `skills/` - the BMAD skills used by Codex\n- `installers/` - install scripts for supported environments\n- `docs/` - documentation and examples\n\n## Current Status\n\nThe core Codex workflow is already usable today.\n\nCurrent implementation focus:\n\n- Codex-native skill installation\n- intent-based orchestration\n- YAML-backed project workflow state\n- migration-safe preference for project-local skills over global collisions\n\n## Learn More\n\n- [Getting Started](docs/getting-started.md)\n- [Contributing](CONTRIBUTING.md)\n- [Changelog](CHANGELOG.md)\n\n## Attribution\n\nThe BMAD Method (Breakthrough Method for Agile AI-Driven Development) is created and maintained by the BMAD Code Organization.\n\nThis repository is an implementation and adaptation of BMAD for OpenAI Codex. The methodology, core workflow patterns, and BMAD concepts remain the intellectual property of the BMAD Code Organization.\n\nThis OpenAI Codex adaptation was initially based on [BMAD Method v6 for Claude Code](https://github.com/aj-geddes/claude-code-bmad-skills).\n\nOriginal sources:\n\n- BMAD Code Organization: https://github.com/bmad-code-org\n- Original BMAD Method: https://github.com/bmad-code-org/BMAD-METHOD\n- Website: https://bmadcodes.com/bmad-method/\n- YouTube: https://www.youtube.com/@BMadCode\n- Discord: https://discord.gg/gk8jAdXWmj\n\n## License\n\nMIT License. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxmm%2Fcodex-bmad-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxmm%2Fcodex-bmad-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxmm%2Fcodex-bmad-skills/lists"}