Skip to content

docs(agents): explain the render_skill.py vs resolve_customization.py split - #2892

Draft
gmoncor wants to merge 1 commit into
bmad-code-org:devfrom
gmoncor:docs/s01-06-explain-render-resolve-coexistence
Draft

gmoncor wants to merge 1 commit into
bmad-code-org:devfrom
gmoncor:docs/s01-06-explain-render-resolve-coexistence

Conversation

@gmoncor

@gmoncor gmoncor commented Sep 17, 2026

Copy link
Copy Markdown

What: Add a short paragraph to AGENTS.md stating that render_skill.py is the current canonical activation path for build/build-auto/code-review/retrospective/walkthrough, while bmad-correct-course, bmad-review and bmad-deep-recon still call resolve_customization.py + resolve_config.py directly as a legacy two-step path pending migration.

Why: Two coexisting activation patterns exist with no documentation explaining why; CHANGELOG.md already has the rationale for render_skill.py that can be adapted into this note.

How:

  • Add the paragraph to AGENTS.md, adapting the existing CHANGELOG.md rationale rather than writing new text.
  • State explicitly that new skills should default to render_skill.py.

Testing: Read-through diff; doc-only, no migration performed.

🤖 Generated with Claude Code

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant