bmad-agent-architect

To convert a PRD and UX into technical architecture, you need a system that maps product requirements to concrete architecture decisions with explicit trade-offs and implementation guidance. This ensures code generation stays aligned with your original product vision and prevents churn.

Claude Code misaligns with product requirements when it drafts code without a durable, reviewable architecture record tied to your PRD and UX. Establishing a decision-oriented architecture record ensures implementation consistently follows documented technical decisions.

Documenting technical architecture decisions is best handled by generating a decision record that converts PRD and UX inputs into concrete architecture choices with explicit trade-offs. This durable record keeps implementation on track and reviewable across the workflow.

Aligning epics and stories with technical architecture requires a workflow that resolves layered configurations and maps PRD and UX artifacts directly to technical design decisions. This alignment ensures all development tasks follow the documented architectural constraints.

Architecture generation behavior can be customized using layered TOML files that define agent blocks and activation steps. The system resolves these configurations to load persistent facts and dispatch the relevant architecture workflows with minimal friction.