12 NFRs across 4 categories: performance (loading/LLM latency),
security (no data persistence, no logging), integration (Jus IA URL
format, overflow validation), compatibility (evergreen browsers,
mobile-first, WhatsApp OG tags). Lean approach - no SLAs.
https://claude.ai/code/session_01CvrcMDqfCKWV2hC3xpRbx3
MPA mobile-first, evergreen browsers, no SEO priority,
request-response with loading state for LLM calls,
no accessibility priority for MVP. Stateless architecture.
https://claude.ai/code/session_01CvrcMDqfCKWV2hC3xpRbx3
No breakthrough innovation detected. Product is smart execution of
existing concepts (dynamic forms + LLM + parameterized URL + verified
legal base). Innovation is in the approach, not the technology.
https://claude.ai/code/session_01CvrcMDqfCKWV2hC3xpRbx3
Legaltech high-complexity concerns (OAB ethics, data retention,
attorney-client privilege, court integration) don't apply to Start Kit:
no data persistence, no login, no court integration, redirect-only.
Only residual constraint: domain knowledge for prompt template creation.
https://claude.ai/code/session_01CvrcMDqfCKWV2hC3xpRbx3
Web App | Legaltech | Medium complexity (high domain knowledge) | Greenfield.
Party Mode revised complexity from High to Medium based on stateless/anonymous
architecture with no data retention or court integration.
https://claude.ai/code/session_01CvrcMDqfCKWV2hC3xpRbx3
- Updated all JusPrompt references to Jus IA Start Kit in product brief
- Updated Party Mode insights to reflect decisions made (name, AI in MVP)
- Created PRD document from template with Step 1 initialization complete
- Discovered and loaded 7 input documents (1 brief, 1 research, 1 brainstorm, 4 project docs)
https://claude.ai/code/session_01CvrcMDqfCKWV2hC3xpRbx3
Completed Step 4 with North Star metric (1000 redirects/month),
user success metrics, business objectives, and funnel KPIs.
Product is one-shot by design - no retention loop.
https://claude.ai/code/session_01CvrcMDqfCKWV2hC3xpRbx3
Completed Step 3 (Target Users Discovery) with three personas:
- Dra. Carla (never used AI, pragmatic resistor)
- Dr. Rafael (uses AI poorly, digital overload)
- Dr. Marcos (office owner, Shadow AI concerns)
Includes detailed user journey for labor law petition flow.
https://claude.ai/code/session_01CvrcMDqfCKWV2hC3xpRbx3
Completed Step 2 (Vision Discovery) of the BMAD product brief workflow
for JusPrompt - a conversational assistant that guides lawyers through
building optimized requests for Jus IA without prompt engineering knowledge.
Includes Party Mode insights on naming, URL limits, and MVP strategy.
https://claude.ai/code/session_01CvrcMDqfCKWV2hC3xpRbx3
Set up the product brief document with frontmatter tracking workflow state
and input documents discovered during Phase 1 Analysis (brainstorm, research,
and 4 detailed idea explorations).
https://claude.ai/code/session_01CvrcMDqfCKWV2hC3xpRbx3
Research covers:
- Prompt Library: 8+ BR competitors mapped, white space in verified-data-connected prompts
- Calculator: 10+ competitors including Jusfy (R$50M+ revenue, 118% YoY), gap in AI end-to-end
- Dashboard: No BR competitor exists but better as feature (80% don't measure AI ROI)
- Community: 4-5 paid communities exist (personality-driven), better absorbed as Library feature
Final prioritization: (1) Prompt Library, (2) Calculator, (3/4) Dashboard+Community as features
https://claude.ai/code/session_01CvrcMDqfCKWV2hC3xpRbx3
Incorporate proprietary survey data from Jusbrasil (Aug 2025, n=2861; Mar 2026, n=977)
covering adoption rates, tool usage, trust levels, non-user barriers, and conversion
factors. Add section 3 with data-driven implications for each of the 4 selected ideas.
Key findings: Prompt Library has highest relevance (ease of use +4.2pp as conversion
factor), Dashboard is more retention than acquisition, Community is better as a feature
than standalone product.
https://claude.ai/code/session_01CvrcMDqfCKWV2hC3xpRbx3
Add structured documentation for the Jus IA external tools brainstorming project:
- Research context on AI legal tools in Brazil and lawyer pain points
- Full brainstorm with 23 ideas across 5 categories
- 4 selected ideas with detailed descriptions: Prompt Library, Legal Calculator,
Productivity Dashboard, and Prompts Community
- README with project overview, principles, and next steps
https://claude.ai/code/session_01CvrcMDqfCKWV2hC3xpRbx3
Align documentation with the skills-based architecture migration by
replacing references to "commands", "slash commands", and legacy command
names with the new "skills" terminology and skill names.
* feat(i18n): add zh-cn locale support with Starlight routing
Reorganize Chinese translations from docs_cn/ into docs/zh-cn/
following Starlight's i18n content structure. Configure Starlight
with root locale (en, unprefixed) and zh-cn (/zh-cn/ prefix).
- Move 28 files from docs_cn/*_cn.md to docs/zh-cn/*.md
- Fix 21 internal links to remove _cn suffixes
- Add defaultLocale + locales config to astro.config.mjs
- Add .gitignore exception for docs/zh-cn/ (overrides z*/ rule)
- Language switcher activates automatically via existing Header
- hreflang tags auto-generated by Starlight on all pages
* feat(i18n): add zh-CN UI translations and sidebar labels
- Add website/src/content/i18n/zh-CN.json with Starlight UI strings
- Add sidebar group label translations (欢迎, 路线图, 教程, etc.)
- Register i18n collection in content config to fix deprecation warning
* fix(i18n): exclude 404 pages from sitemap
Custom 404 pages (root and zh-cn) were indexed as regular content in
the sitemap. Add a filter to the @astrojs/sitemap integration that
matches the /404 path segment precisely via regex on the URL pathname.
Update the BMAD acronym expansion from "Breakthrough Method of
Agile AI Driven Development" to "Build More Architect Dreams"
across README, docs homepage, and package.json description.
Co-authored-by: Brian <bmadcode@gmail.com>
- Add comprehensive public roadmap with In Progress, Getting Started, and Community sections
- Add roadmap callout to README.md and docs welcome page
- Add roadmap-specific card grid styles with equal-height cards
- Fix rehype-markdown-links plugin to detect docs directory in various project structures
- Rename roadmap.md to roadmap.mdx for proper Astro/Starlight rendering
- Update doc link validator to support .mdx files
Windsurf is no longer a preferred IDE. Only Claude Code and Cursor
are now recommended. Windsurf remains a supported platform (installer
still works, templates stay, reference tables stay).
- Set preferred: false in both platform-codes.yaml files
- Move windsurf entry to "Other IDEs" section in tools/platform-codes.yaml
- Fix codex.js hardcoding preferred: true in constructor
- Remove stale "3 preferred tools" count from ui.js JSDoc
- Update docs to list only Claude Code and Cursor as recommended
- Update docs/index.md popular tools to Claude Code, Cursor, Codex CLI
BMad-Help is one of V6's flagship features but was undersold in docs.
This update positions it properly as the intelligent guide that:
- Inspects project state and detects what's completed
- Understands natural language queries
- Varies options based on installed modules
- Auto-invokes after every workflow
- Recommends first required tasks
Changes:
- Add dedicated "Meet BMad-Help" section to getting-started
- Expand commands.md with full BMad-Help subsection and examples
- Reposition get-answers-about-bmad.md to start with BMad-Help
- Enhance install-bmad.md and established-projects.md with query examples
- Add index.md tip box promoting /bmad-help as quickest way to dive in
Adds a new "Extend and Customize" section with a link to the BMad Builder documentation for users interested in creating custom agents, workflows, or modules.
* fix(docs): comprehensive documentation site review fixes
Rehype plugins:
- Rewrite rehype-markdown-links for correct relative .md resolution
- Handle raw HTML base paths and bare .md links in rehype-base-paths
- Guard protocol-relative URLs (//...) in all link processors
- Use file.path instead of file.history[0] for vfile compatibility
- Fail build when content directory cannot be detected
- Export helpers for testability; add 107 unit tests
Build & CI:
- Revert cancel-in-progress to false to avoid mid-deploy cancellation
- Remove redundant link-validation CI step (build validates internally)
- Remove unnecessary fetch-depth:0 from docs deploy workflow
- Refuse docs build on Windows (platform guard)
- Remove dead build scripts and stale references
Tooling:
- Add DOCS_ROOT boundary check in validate-doc-links.js
- Handle directory paths and prefix stripping in link validator
- Remove dead regex and add // guard in fix-doc-links.js
Accessibility & CSS:
- Darken caution/danger aside title colors for WCAG AA 4.5:1 contrast
- Fix 100vw scrollbar overflow (banner width:100%, html overflow-x:clip)
- Add :focus-visible ring to banner link for keyboard navigation
- Remove dead CSS declaration and add missing code block lang
Documentation content:
- Convert /docs/ absolute links to relative paths and fix llms.txt URLs
- Correct command file paths and naming in commands reference
- Update stale shard-doc command to current /bmad-shard-doc format
- Fix incomplete sentence in install-bmad.md
- Add Quick Flow next steps and fix 404 link path
- Expand thin content pages with substantive detail
- Add sidebar ordering frontmatter to all content pages
- Remove BMGD docs (moved to dedicated repo)
- Remove unused assets and misleading diagram caption
- Add non-iframe fallback link to workflow map diagram
- Remove dead noscript block from workflow-map
- Standardize BMAD to BMad, fix spelling/grammar, normalize headings
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix(docs): add non-interactive installation to sidebar, rewrite and reorder how-to guides
- Move non-interactive-installation.md into how-to/ directory so it appears
in the sidebar navigation (was orphaned at docs root)
- Rewrite the page based on editorial review: consolidate redundant sections,
add missing how-to structure (prerequisites, "What You Get"), condense
installation modes from 5 subsections to a table, cut speculative examples
- Reorder how-to sidebar: Install (1), Non-Interactive (2), Upgrade to v6 (3),
then the rest following user journey order
- Fix README link to point to docs site instead of repo-internal markdown path
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix(docs): address documentation review findings
Fix broken directory tree, grammar errors, inconsistent naming,
missing admonition/headings, enable lastUpdated timestamps in CI,
and remove footer CSS that misapplied to the content footer.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix(docs): move bleeding-edge install command out of Verify Installation
The alternative npx command for installing from main was misplaced
inside the "Verify Installation" section. Move it to a tip admonition
under Step 1 where users look for install options.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
The downloads page offered bmad-sources.zip and bmad-prompts.zip, both
redundant: GitHub provides source archives for every tag natively, and
npx bmad-method install is the supported path for compiled prompts.
Remove the downloads page, all bundle generation code, the archiver
dependency, and nav links. The llms.txt and llms-full.txt files (the
genuinely useful artifacts) continue to be generated as before.
* docs: add official external modules reference page
* chore: remove obsolete docs and basement files
* fix: update robots.txt URLs to docs.bmad-method.org
* fix: generate robots.txt dynamically from site base URL
Replace static robots.txt with an Astro endpoint that uses the
configured site URL, so sitemap references are correct on both
fork deployments and production.
* fix: unify site URL resolution in build-docs.js
build-docs.js had its own hardcoded fallback URL
(bmad-code-org.github.io) instead of using the shared
getSiteUrl() function, causing URL mismatches between
robots.txt, llms.txt, and sitemaps. Now all components
resolve the site URL through the same function. Renamed
site-url.js to .mjs to avoid Node ESM detection warnings.
* fix: correct module names and relocate prompt file
- CIS: "Creative Innovation Suite" → "Creative Intelligence Suite"
- GDS: "Game Dev Suite" → "Game Dev Studio"
- Move _prompt-external-modules-page.md from docs/ to tools/docs/
* refactor: convert build-docs to ESM, eliminate mutable globals
- Convert build-docs.js to build-docs.mjs (CJS → ESM)
- Import getSiteUrl directly, remove async import workaround
- Kill mutable SITE_URL global, call getSiteUrl() where needed
- Clean up Banner.astro variable naming
- Update package.json and CI workflow for .mjs extension
* feat: add non-interactive installation support
Add command-line flags to support non-interactive installation for CI/CD
pipelines and automated deployments:
- --directory: Installation directory
- --modules: Comma-separated module IDs
- --tools: Tool/IDE IDs (use "none" to skip)
- --custom-content: Custom module paths
- --action: Action type for existing installations
- --user-name, --communication-language, --document-output-language, --output-folder: Core config
- -y, --yes: Accept all defaults
When flags are provided, prompts are skipped. Missing values gracefully
fall back to interactive prompts.
* fix: complete non-interactive installation support
- Fix validation checks using truthy instead of !== true
- Add skipPrompts flag to skip module config prompts with --yes
- Add getDefaultModules() for automatic module selection with --yes
- Fix IDE selection to use array check instead of length check
Co-Authored-By: AiderDesk <https://github.com/hotovo/aider-desk>
---------
Co-authored-by: Brian <bmadcode@gmail.com>
* docs: rename brownfield to established projects
Flatten how-to/brownfield/ subdirectory and replace jargon term
"brownfield" with more accessible "established projects" throughout.
- brownfield/index.md → established-projects.md
- brownfield/quick-fix-in-brownfield.md → quick-fixes.md
- brownfield-faq.md → established-projects-faq.md
- Update all internal links and references
* docs: remove redundant phrase from quick-fixes description
* docs: restore natural language in established-projects body
The getting-started tutorial referenced agents and workflows by name
(e.g., "Load the PM agent", "Run the prd workflow") without providing
the actual commands to type. This adds the exact slash commands inline
alongside the existing prose so new users know precisely what to run.
Apply Diataxis documentation framework to BMGD docs:
game-types.md:
- Convert to Reference format (austere, consistent structure)
- Add Examples field to all 24 game types
- Remove redundant Overview, GDD Section Mapping, Next Steps
- Condense Hybrid Game Types to reference table
- Remove Tags (no functional purpose for human readers)
quick-flow-workflows.md:
- Convert to How-to guide format
- Remove conceptual content (Step-File Architecture, Integration)
- Remove tutorial content (Examples section)
- Cut redundant Reference tables (steps already in how-to)
- Merge Self-Check and Adversarial Review into Validation Criteria
index.md:
- Fix broken link to Quick-Flow documentation
Both main files:
- Apply prose editorial fixes for clarity
- Reduce word count while preserving comprehension
Co-authored-by: Scott Jennings <scott.jennings+CIGINT@cloudimperiumgames.com>
- Remove duplicate "for" in README example command
- Fix "this is" to "thing is" in README
- Remove extra "at" in "star project icon at near" in README
- Fix "MEthod" to "Method" in customize-bmad.md
- Add CSS to break workflow diagram iframe out of content container
- iframe now spans full viewport width instead of max-width constraint
- Adjust iframe height to 700px for better fit
- Remove border/border-radius for seamless full-width look
Co-authored-by: Brian Madison <brianmadison@Brians-MacBook-Pro.local>
Claude
Alex Verkhovsky
cccczl
Brian Madison
Brian Madison
Vladimir Hrusovsky
murat
Murat K Ozcan
Chad Woolley
sjennings
The Chef