{"id":"072ca12b-4255-43ce-a098-5420b265dc83","shortId":"ADBQcJ","kind":"skill","title":"bmad-developer","tagline":"Implementation skill for BMAD. Use for bmad:dev-story and bmad:code-review to deliver tested code from story specs.","description":"# BMAD Developer\n\n## Trigger Intents\n\n- `bmad:dev-story`\n- `bmad:code-review`\n\n## Workflow Variants\n\n1. `dev-story`\n- Implement one story to completion with tests.\n\n2. `code-review`\n- Review implementation quality against story acceptance criteria.\n\n## Inputs\n\n- target story file `docs/stories/STORY-*.md`\n- architecture constraints from `docs/bmad/architecture.md` when present\n- repository coding and testing standards\n\n## Language Guard (Mandatory)\n\nEnforce language selection separately for chat responses and generated artifacts.\n\nChat language (`communication_language`) fallback order:\n\n1. `language.communication_language` from `bmad/project.yaml`\n2. `English`\n\nRules for chat responses:\n\n- Use the resolved chat language for all assistant responses (questions, status updates, summaries, and handoff notes).\n- Do not switch chat language unless the user explicitly requests a different language in the current thread.\n\nArtifact language (`document_output_language`) fallback order:\n\n1. `language.document_output_language` from `bmad/project.yaml`\n2. `English`\n\nRules for generated artifacts:\n\n- Use the resolved artifact language for all generated BMAD documents and structured artifacts.\n- write prose and field values in the resolved document language\n- avoid mixed-language requirement clauses with English modal verbs (for example, `System shall` followed by non-English text)\n- allow English acronyms/abbreviations in non-English sentences (for example, `API`, `SLA`, `KPI`, `OAuth`, `WCAG`)\n- Keep code snippets, CLI commands, file paths, and identifiers in their original technical form.\n\n## Mandatory Reference Load\n\nBefore executing `dev-story` or `code-review`, read `REFERENCE.md` first and treat it as required context. Then load focused details from:\n- `resources/clean-code-checklist.md`\n- `resources/testing-standards.md`\n\nArchitecture Guardrails = `Architecture Compliance Guardrails` section\n(source of truth for architecture constraints).\n\nWhen `docs/bmad/architecture.md` exists, apply Architecture Guardrails.\n\n## Output Contract\n\n- code and test changes in repository\n- optional review artifact `docs/bmad/code-review.md`\n- clear pass/fail status against acceptance criteria\n- for architecture-constrained stories: concise note on how key constraints were handled\n\n## Core Workflow\n\n1. Read story scope and acceptance criteria.\n2. Implement minimal complete solution.\n3. Add or update tests.\n4. Run quality checks and summarize outcomes.\n5. Report residual risks and follow-up items.\n6. If architecture constraints are clearly violated, return `Needs changes`; otherwise report residual risks and follow-up items.\n\n## Implementation Approach\n\n### 1. Understand Story and Constraints\n\n- Parse acceptance criteria into explicit checks.\n- Identify touched modules, dependencies, and data contracts.\n- Load architecture constraints from `docs/bmad/architecture.md` when present.\n- Apply Architecture Guardrails.\n- Flag ambiguities and assumptions before implementation.\n\n### 2. Plan Before Coding\n\n- Break work into small slices:\n  - data and schema changes\n  - business logic\n  - interfaces and adapters\n  - test updates\n- Define edge cases, failure modes, and rollback-safe behavior.\n\n### 3. Implement Incrementally\n\n- Prefer small, reviewable changes over large rewrites.\n- Preserve existing project conventions and architecture boundaries.\n- Handle errors explicitly and keep behavior deterministic.\n- Avoid hidden scope expansion; if scope grows, record it in the summary.\n\n### 4. Test to Match Risk\n\n- Add unit tests for new logic and edge cases.\n- Add integration tests where component boundaries are crossed.\n- Add end-to-end tests for critical user-facing flows when applicable.\n- Verify acceptance criteria with test evidence, not assumptions.\n\n### 5. Run Hard Quality Gates\n\n- Run lint and static checks:\n  ```bash\n  bash scripts/lint-check.sh\n  ```\n- Run pre-commit checks:\n  ```bash\n  bash scripts/pre-commit-check.sh\n  ```\n- Run coverage validation (default 80% minimum unless project requires higher):\n  ```bash\n  bash scripts/check-coverage.sh\n  ```\n- Do not mark complete with unresolved failing checks unless explicitly approved.\n\n### 6. Close with Traceable Outcome\n\n- Map each acceptance criterion to code and test evidence.\n- Summarize relevant architecture constraints and where they are addressed in code/tests.\n- Summarize changed files, key decisions, and residual risks.\n- For `code-review`, record findings using `templates/code-review.template.md`.\n\n## Script Selection\n\n- Lint checks:\n  ```bash\n  bash scripts/lint-check.sh\n  ```\n- Pre-commit quality checks:\n  ```bash\n  bash scripts/pre-commit-check.sh\n  ```\n- Coverage checks:\n  ```bash\n  bash scripts/check-coverage.sh\n  ```\n\n## Template Map\n\n- `templates/code-review.template.md`\n- Why: structured review output for quality and risk communication.\n\n## Reference Map\n\n- `REFERENCE.md`\n- Must read first for developer workflow and implementation discipline.\n\n- `resources/clean-code-checklist.md`\n- Use when reviewing maintainability and readability.\n\n- `resources/testing-standards.md`\n- Use when validating test completeness and quality.\n\n## Quality Gates\n\n- acceptance criteria are explicitly verified\n- architecture constraints are explicitly verified (storage, auth, idempotency when applicable)\n- tests and lint pass, or failures are reported clearly\n- no hidden scope expansion without note\n- implementation remains maintainable and reviewable","tags":["bmad","developer","codex","skills","xmm","agent-skills","agentic-ai","agentic-workflow","agile","ai-coding-agent","ai-skills","analysis"],"capabilities":["skill","source-xmm","skill-bmad-developer","topic-agent-skills","topic-agentic-ai","topic-agentic-workflow","topic-agile","topic-ai-coding-agent","topic-ai-skills","topic-analysis","topic-bmad","topic-code-reviews","topic-codex","topic-codex-cli","topic-developer-tool"],"categories":["codex-bmad-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/xmm/codex-bmad-skills/bmad-developer","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add xmm/codex-bmad-skills","source_repo":"https://github.com/xmm/codex-bmad-skills","install_from":"skills.sh"}},"qualityScore":"0.465","qualityRationale":"deterministic score 0.47 from registry signals: · indexed on github topic:agent-skills · 30 github stars · SKILL.md body (5,458 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-01T07:01:06.903Z","embedding":null,"createdAt":"2026-04-18T22:22:55.709Z","updatedAt":"2026-05-01T07:01:06.903Z","lastSeenAt":"2026-05-01T07:01:06.903Z","tsv":"'1':40,98,149,312,366 '2':51,103,155,319,400 '3':324,430 '4':329,466 '5':336,510 '6':345,555 '80':535 'accept':60,295,317,372,503,562,657 'acronyms/abbreviations':206 'adapt':417 'add':325,471,480,488 'address':577 'allow':204 'ambigu':395 'api':214 'appli':276,391 'applic':501,671 'approach':365 'approv':554 'architectur':68,261,263,271,277,299,347,385,392,445,571,662 'architecture-constrain':298 'artifact':91,142,160,164,173,289 'assist':116 'assumpt':397,509 'auth':668 'avoid':184,454 'bash':520,521,528,529,541,542,600,601,608,609,613,614 'behavior':429,452 'bmad':2,7,10,15,26,30,34,169 'bmad-develop':1 'bmad/project.yaml':102,154 'boundari':446,485 'break':404 'busi':413 'case':422,479 'chang':284,354,412,436,581 'chat':87,92,107,112,128 'check':332,376,519,527,551,599,607,612 'claus':189 'clear':291,350,680 'cli':222 'close':556 'code':17,22,36,53,75,220,243,281,403,565,590 'code-review':16,35,52,242,589 'code/tests':579 'command':223 'commit':526,605 'communic':94,627 'complet':48,322,547,652 'complianc':264 'compon':484 'concis':302 'constrain':300 'constraint':69,272,307,348,370,386,572,663 'context':253 'contract':280,383 'convent':443 'core':310 'coverag':532,611 'criteria':61,296,318,373,504,658 'criterion':563 'critic':495 'cross':487 'current':140 'data':382,409 'decis':584 'default':534 'defin':420 'deliv':20 'depend':380 'detail':257 'determinist':453 'dev':12,32,42,239 'dev-stori':11,31,41,238 'develop':3,27,635 'differ':136 'disciplin':639 'docs/bmad/architecture.md':71,274,388 'docs/bmad/code-review.md':290 'docs/stories/story-':66 'document':144,170,182 'edg':421,478 'end':490,492 'end-to-end':489 'enforc':82 'english':104,156,191,202,205,210 'error':448 'evid':507,568 'exampl':195,213 'execut':237 'exist':275,441 'expans':457,684 'explicit':133,375,449,553,660,665 'face':498 'fail':550 'failur':423,677 'fallback':96,147 'field':177 'file':65,224,582 'find':593 'first':247,633 'flag':394 'flow':499 'focus':256 'follow':198,342,361 'follow-up':341,360 'form':232 'gate':514,656 'generat':90,159,168 'grow':460 'guard':80 'guardrail':262,265,278,393 'handl':309,447 'handoff':123 'hard':512 'hidden':455,682 'higher':540 'idempot':669 'identifi':227,377 'implement':4,44,56,320,364,399,431,638,687 'increment':432 'input':62 'integr':481 'intent':29 'interfac':415 'item':344,363 'keep':219,451 'key':306,583 'kpi':216 'languag':79,83,93,95,100,113,129,137,143,146,152,165,183,187 'language.communication':99 'language.document':150 'larg':438 'lint':516,598,674 'load':235,255,384 'logic':414,476 'maintain':644,689 'mandatori':81,233 'map':560,617,629 'mark':546 'match':469 'md':67 'minim':321 'minimum':536 'mix':186 'mixed-languag':185 'modal':192 'mode':424 'modul':379 'must':631 'need':353 'new':475 'non':201,209 'non-english':200,208 'note':124,303,686 'oauth':217 'one':45 'option':287 'order':97,148 'origin':230 'otherwis':355 'outcom':335,559 'output':145,151,279,622 'pars':371 'pass':675 'pass/fail':292 'path':225 'plan':401 'pre':525,604 'pre-commit':524,603 'prefer':433 'present':73,390 'preserv':440 'project':442,538 'prose':175 'qualiti':57,331,513,606,624,654,655 'question':118 'read':245,313,632 'readabl':646 'record':461,592 'refer':234,628 'reference.md':246,630 'relev':570 'remain':688 'report':337,356,679 'repositori':74,286 'request':134 'requir':188,252,539 'residu':338,357,586 'resolv':111,163,181 'resources/clean-code-checklist.md':259,640 'resources/testing-standards.md':260,647 'respons':88,108,117 'return':352 'review':18,37,54,55,244,288,435,591,621,643,691 'rewrit':439 'risk':339,358,470,587,626 'rollback':427 'rollback-saf':426 'rule':105,157 'run':330,511,515,523,531 'safe':428 'schema':411 'scope':315,456,459,683 'script':596 'scripts/check-coverage.sh':543,615 'scripts/lint-check.sh':522,602 'scripts/pre-commit-check.sh':530,610 'section':266 'select':84,597 'sentenc':211 'separ':85 'shall':197 'skill':5 'skill-bmad-developer' 'sla':215 'slice':408 'small':407,434 'snippet':221 'solut':323 'sourc':267 'source-xmm' 'spec':25 'standard':78 'static':518 'status':119,293 'storag':667 'stori':13,24,33,43,46,59,64,240,301,314,368 'structur':172,620 'summar':334,569,580 'summari':121,465 'switch':127 'system':196 'target':63 'technic':231 'templat':616 'templates/code-review.template.md':595,618 'test':21,50,77,283,328,418,467,473,482,493,506,567,651,672 'text':203 'thread':141 'topic-agent-skills' 'topic-agentic-ai' 'topic-agentic-workflow' 'topic-agile' 'topic-ai-coding-agent' 'topic-ai-skills' 'topic-analysis' 'topic-bmad' 'topic-code-reviews' 'topic-codex' 'topic-codex-cli' 'topic-developer-tool' 'touch':378 'traceabl':558 'treat':249 'trigger':28 'truth':269 'understand':367 'unit':472 'unless':130,537,552 'unresolv':549 'updat':120,327,419 'use':8,109,161,594,641,648 'user':132,497 'user-fac':496 'valid':533,650 'valu':178 'variant':39 'verb':193 'verifi':502,661,666 'violat':351 'wcag':218 'without':685 'work':405 'workflow':38,311,636 'write':174","prices":[{"id":"d3b21d97-0bea-440e-b2ee-82f2ec9f8f12","listingId":"072ca12b-4255-43ce-a098-5420b265dc83","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"xmm","category":"codex-bmad-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:22:55.709Z"}],"sources":[{"listingId":"072ca12b-4255-43ce-a098-5420b265dc83","source":"github","sourceId":"xmm/codex-bmad-skills/bmad-developer","sourceUrl":"https://github.com/xmm/codex-bmad-skills/tree/main/skills/bmad-developer","isPrimary":false,"firstSeenAt":"2026-04-18T22:22:55.709Z","lastSeenAt":"2026-05-01T07:01:06.903Z"}],"details":{"listingId":"072ca12b-4255-43ce-a098-5420b265dc83","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"xmm","slug":"bmad-developer","github":{"repo":"xmm/codex-bmad-skills","stars":30,"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"],"license":"other","html_url":"https://github.com/xmm/codex-bmad-skills","pushed_at":"2026-04-20T10:20:30Z","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.","skill_md_sha":"60115dfe7ab4e7de7154838406448c8849e7ca9b","skill_md_path":"skills/bmad-developer/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/xmm/codex-bmad-skills/tree/main/skills/bmad-developer"},"layout":"multi","source":"github","category":"codex-bmad-skills","frontmatter":{"name":"bmad-developer","description":"Implementation skill for BMAD. Use for bmad:dev-story and bmad:code-review to deliver tested code from story specs."},"skills_sh_url":"https://skills.sh/xmm/codex-bmad-skills/bmad-developer"},"updatedAt":"2026-05-01T07:01:06.903Z"}}