Commit Graph

28 Commits

Author SHA1 Message Date
Serhii 2ad49efd1e
Merge upstream/v6-alpha into feat/bmvcs-dev
Brings feat/bmvcs-dev up to date with latest v6-alpha:
- TEA agent workflows (#660)
- SubAgents organization in subfolders
- Installer improvements (hash checking, v4→v6 upgrade)
- v6 flow documentation
- BMM Flow document

No conflicts expected - path fix already applied.
BMVCS module files untouched by upstream changes.

Related: #661
2025-10-01 22:29:26 +03:00
Serhii fa0115dfa3
fix(bmm): correct VCS config path in Architect/PM/Dev agents
ISSUE: Path Inconsistency
BMM agents were looking for VCS config at wrong path:
- Old: bmad-core/vcs-config.yaml (incorrect)
- New: .bmad/vcs-config.yaml (correct per BMVCS spec)

IMPACT:
VCS integration failed without manual workaround

FIX:
Updated 3 agent files to use correct path:
- src/modules/bmm/agents/architect.md (line 17)
- src/modules/bmm/agents/pm.md (line 17)
- src/modules/bmm/agents/dev.md (line 22)

TESTING:
Discovered during BMVCS Alpha Phase 2 testing
- Workaround documented, now properly fixed in source
- Test results: ~/test-bmvcs-install/testing/

AFFECTED AGENTS:
 Architect - VCS-aware documentation generation
 PM - VCS-aware requirements planning
 Dev - VCS-aware implementation guidance

This fix enables seamless VCS integration without manual intervention.

Related: #661
Testing: Alpha Phase 2 complete (2025-10-01)
2025-10-01 22:28:52 +03:00
Serhii e09ec31b32
docs(bmvcs): add KB Mode research, path fix plan, and TODO to module docs
RESEARCH FINDINGS:
- KB Mode exists in BMAD v6 (interactive agent guide from v4)
- Command: *kb-mode provides guided exploration
- 8 topic areas including "Agents" discovery
- Can be extended with BMVCS awareness

KEY DISCOVERY:
- Don't create new agent discovery mechanism
- Extend existing KB Mode with VCS-aware agent info
- Add to .bmad-core/data/bmad-kb.md
- Leverage official pattern for user guidance

PATH FIX PLAN:
- Issue: BMM agents look for bmad-core/vcs-config.yaml
- Should be: .bmad/vcs-config.yaml
- Affects: 3 agents (Architect, PM, Dev)
- Ready for execution in Session 4

FILES ADDED:
src/modules/bmvcs/docs/
├── KB_MODE_RESEARCH_FINDINGS.md (10k)
│   - Full KB Mode analysis
│   - Integration opportunities
│   - Phase 3 strategy
├── BMM_AGENTS_VCS_CONFIG_PATH_FIX.md (12k)
│   - 5-phase execution plan
│   - 15-25 min estimated time
│   - Fixes 3 agent files
└── TODO.md
    - Phase 3 tasks (Documentation & Quality)
    - Path fix checklist
    - Future enhancements
    - Documentation standards tasks

IMPLICATIONS:
- Phase 3.1 can start NOW (planning, no path fix needed)
- Path fix required before implementation/testing (Session 4)
- All BMVCS documentation now in module docs/

NEXT STEPS:
1. Design BMVCS KB Mode additions (Session 3 continues)
2. Execute path fix (Session 4)
3. Implement Phase 3.1 documentation (Session 5+)

Context: Alpha testing complete, Phase 3 planning started
Research validates "fail to plan - plan to fail" principle

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-01 17:15:08 +03:00
Brian Madison 25c3d50673 SubAgents in sub folders. installer improvements. BMM Flow document added 2025-10-01 09:12:21 -05:00
Brian Madison 56e7a61bd3 v6 flow documented and subagent organization 2025-10-01 08:50:16 -05:00
Serhii 84920e1bfc
chore(bmvcs): remove testing notes from development branch
NEXT_SESSION.md is useful for testing but should not be in the
development branch. Can be recreated in a separate testing branch
if needed.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-01 06:04:57 +03:00
Serhii bf2ad272fd
docs(bmvcs): add alpha testing plan and session roadmap
- Add comprehensive testing checklist for VCS Discovery Flow
- Document installer testing requirements
- Define success metrics (MVP, Target, Stretch)
- Add integration testing with BMM module
- Include documentation validation tasks

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-01 05:58:49 +03:00
Brian Madison 05a3b4f3f1 hash file change checking integrated 2025-09-30 21:20:13 -05:00
Murat K Ozcan df0c3e4bae
Port TEA commands into workflows and preload Murat knowledge (#660)
* Port TEA commands into workflows and preload Murat knowledge

* Broke the giant knowledge dump into curated fragments under src/modules/bmm/testarch/knowledge/

* Broke the giant knowledge dump into curated fragments under src/modules/bmm/testarch/knowledge/

* updated the web bunles for tea, and spot updates for analyst and sm

* Replaced the old TEA brief with an indexed knowledge system: the agent now loads topic-specific
  docs from knowledge/ via tea-index.csv, workflows reference those fragments, and risk/level/
  priority guidance lives in the new fragment files

---------

Co-authored-by: Murat Ozcan <murat@mac.lan>
2025-09-30 15:19:55 -05:00
Serhii 4d06ec718f
fix(bmvcs): fix markdown formatting in validate-vcs-config
- Add blank line before list in Error Handling section
- Improve markdown compliance

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-30 20:47:23 +03:00
Serhii fd16dab3c5
docs(bmvcs): add development approach analysis
- Add comprehensive DEVELOPMENT_APPROACH.md document
- Document direct development vs BMB create-module comparison
- Include compliance matrix with BMAD v6 standards
- Add recommendations for future module development
- Fix markdown formatting and URL links in README
- Add new doc to Documentation section

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-30 20:46:29 +03:00
Serhii 3f79f1f80a
feat(bmvcs): add VCS integration and BMM agent updates
Add VCS setup workflow and integrate with BMM agents:

BMVCS Workflows:
- workflows/setup-vcs/instructions.md: Comprehensive VCS discovery guide
  with auto-detection, clarifying questions, and edge case handling
- workflows/setup-vcs/checklist.md: Pre/during/post setup validation
- workflows/setup-vcs/workflow.yaml: Machine-readable workflow definition

BMM Agent Integration:
- architect.md: Added VCS-aware architecture documentation adaptation
- pm.md: Added VCS-aware requirements and release planning
- dev.md: Added VCS-aware code delivery and commit practices

Agents now check bmad-core/vcs-config.yaml and adapt their output to
the configured workflow (GitHub Flow, GitFlow, Trunk-Based, No VCS, etc.)
without imposing new processes on teams.

Part 5/5 of BMVCS migration (#661)
Completes VCS-agnostic module integration

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-30 20:12:03 +03:00
Serhii 29d4dc030c
feat(bmvcs): add VCS adaptation examples
Add practical examples demonstrating VCS-agnostic adaptation:
- vcs-adaptation-examples.md: 6 real-world scenarios (GitHub Flow,
  GitFlow, No VCS, SVN, Trunk-Based, Multi-VCS)
- vcs-detection-implementation.py: Reference implementation of Git
  workflow auto-detection with confidence scoring
- examples/README.md: Guide to using examples and integration

Examples demonstrate "Detection as a HINT, not a DECISION" principle
with evidence-based suggestions and user confirmation.

Part 4/5 of BMVCS migration (#661)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-30 20:07:04 +03:00
Serhii bccfe9d651
feat(bmvcs): add VCS-agnostic documentation
Add comprehensive documentation for VCS-agnostic approach:
- VCS_AGNOSTIC_PRINCIPLES.md: Core philosophy and 10 principles
- VCS_AGNOSTIC_PROPOSAL.md: Implementation approach and examples
- VCS_DETECTION_CONFIDENCE.md: Auto-detection confidence scoring
- docs/README.md: Documentation overview and quick start

Documentation explains how BMAD adapts to any VCS (Git, SVN, Perforce,
or no VCS) with appropriate terminology and workflow patterns.

Part 3/5 of BMVCS migration (#661)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-30 20:01:03 +03:00
Serhii 8d342f3bd7
feat(bmvcs): add VCS workflow templates
Add 5 VCS adaptation templates for different workflows:
- git-github-flow.yaml: Simple feature branches (40% of users)
- git-gitflow.yaml: Structured releases (20% of users)
- git-trunk-based.yaml: Continuous deployment (15% of users)
- no-vcs.yaml: Prototypes and one-time scripts (5% of users)
- custom-generic.yaml: Custom/legacy VCS systems (10% of users)

Templates support VCS-agnostic artifact generation across all BMAD agents.

Part 2/5 of BMVCS migration (#661)
Completes core VCS discovery functionality

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-30 19:57:25 +03:00
Serhii 2137a7790b
feat(bmvcs): add VCS discovery tasks and installer
- Port discover-vcs.md from PR #582 (187 lines)
- Port create-vcs-adapted-doc.md from PR #583 (165 lines)
- Add validate-vcs-config.md task (73 lines new)
- Add installer.js for module setup (26 lines)

Part 2/5 of BMVCS migration (#661) - Tasks Complete
Note: VCS templates to be added in next commit after proper extraction

Next: Manually create 5 VCS templates with valid YAML
2025-09-30 19:49:22 +03:00
Serhii 9571a2f332
feat(bmvcs): add module foundation structure
- Create BMVCS module directory structure
- Add installer configuration (install-menu-config.yaml)
- Add VCS Adapter agent with command structure
- Add module README with overview and usage
- Foundation for VCS-agnostic workflow adaptation

Part 1/5 of BMVCS migration (#661)
Supersedes legacy PRs #582, #583, #584
2025-09-30 19:22:13 +03:00
Brian Madison 30fb0e67e1 analyst command fix 2025-09-30 01:41:09 -05:00
Brian Madison e1fac26156 all agent bundles working 2025-09-30 01:38:39 -05:00
Brian Madison 108e4d8eb4 feat: add web activation instructions to bundled agents
- Created agent-activation-web.xml with bundled file access instructions
- Updated web-bundler to inject web activation into all agent bundles
- Agents now understand how to access <file> elements instead of filesystem
- Includes workflow execution instructions for bundled environments
- Generated new web bundles with activation blocks
2025-09-30 00:32:20 -05:00
Brian Madison 688a841127 missed a workflow update 2025-09-30 00:24:27 -05:00
Brian Madison c26220daec installer and bundler progress 2025-09-30 00:24:27 -05:00
Brian Madison ae136ceb03 web_bundle info added to workflow yamls 2025-09-30 00:24:27 -05:00
Brian Madison 9934224230 workflows indicate web_bundle file inclusions 2025-09-30 00:24:27 -05:00
Murat Ozcan 24b3a42f85 docs: improved tea wording 2025-09-29 17:01:50 -05:00
Murat Ozcan bf24530ba6 docs: spot update test architect 2025-09-29 16:58:44 -05:00
Murat K Ozcan 9645a8ed0d
Docs/update test architect for brian (#655)
Update Docs for TestArch

---------

Co-authored-by: Murat Ozcan <murat@mac.lan>
2025-09-29 16:43:20 -05:00
Brian Madison 0a6a3f3015 feat: v6.0.0-alpha.0 - the future is now 2025-09-28 23:17:07 -05:00