mirror of
https://github.com/bmadcode/BMAD-METHOD.git
synced 2025-12-29 16:14:59 +00:00
cfedecbd53
## 📚 Complete Documentation Restructure **BMM Documentation Hub Created:** - New centralized documentation system at `src/modules/bmm/docs/` - 18 comprehensive guides organized by topic (7000+ lines total) - Clear learning paths for greenfield, brownfield, and quick spec flows - Professional technical writing standards throughout **New Documentation:** - `README.md` - Complete documentation hub with navigation - `quick-start.md` - 15-minute getting started guide - `agents-guide.md` - Comprehensive 12-agent reference (45 min read) - `party-mode.md` - Multi-agent collaboration guide (20 min read) - `scale-adaptive-system.md` - Deep dive on Levels 0-4 (42 min read) - `brownfield-guide.md` - Existing codebase development (53 min read) - `quick-spec-flow.md` - Rapid Level 0-1 development (26 min read) - `workflows-analysis.md` - Phase 1 workflows (12 min read) - `workflows-planning.md` - Phase 2 workflows (19 min read) - `workflows-solutioning.md` - Phase 3 workflows (13 min read) - `workflows-implementation.md` - Phase 4 workflows (33 min read) - `workflows-testing.md` - Testing & QA workflows (29 min read) - `workflow-architecture-reference.md` - Architecture workflow deep-dive - `workflow-document-project-reference.md` - Document-project workflow reference - `enterprise-agentic-development.md` - Team collaboration patterns - `faq.md` - Comprehensive Q&A covering all topics - `glossary.md` - Complete terminology reference - `troubleshooting.md` - Common issues and solutions **Documentation Improvements:** - Removed all version/date footers (git handles versioning) - Agent customization docs now include full rebuild process - Cross-referenced links between all guides - Reading time estimates for all major docs - Consistent professional formatting and structure **Consolidated & Streamlined:** - Module README (`src/modules/bmm/README.md`) streamlined to lean signpost - Root README polished with better hierarchy and clear CTAs - Moved docs from root `docs/` to module-specific locations - Better separation of user docs vs. developer reference ## 🤖 New Agent: Paige (Documentation Guide) **Role:** Technical documentation specialist and information architect **Expertise:** - Professional technical writing standards - Documentation structure and organization - Information architecture and navigation - User-focused content design - Style guide enforcement **Status:** Work in progress - Paige will evolve as documentation needs grow **Integration:** - Listed in agents-guide.md, glossary.md, FAQ - Available for all phases (documentation is continuous) - Can be customized like all BMM agents ## 🔧 Additional Changes - Updated agent manifest with Paige - Updated workflow manifest with new documentation workflows - Fixed workflow-to-agent mappings across all guides - Improved root README with clearer Quick Start section - Better module structure explanations - Enhanced community links with Discord channel names **Total Impact:** - 18 new/restructured documentation files - 7000+ lines of professional technical documentation - Complete navigation system with cross-references - Clear learning paths for all user types - Foundation for knowledge base (coming in beta) Co-Authored-By: Claude <noreply@anthropic.com>
129 lines
2.9 KiB
YAML
129 lines
2.9 KiB
YAML
# GitLab CI/CD Pipeline for Test Execution
|
|
# Generated by BMad TEA Agent - Test Architect Module
|
|
# Optimized for: Playwright/Cypress, Parallel Sharding, Burn-In Loop
|
|
|
|
stages:
|
|
- lint
|
|
- test
|
|
- burn-in
|
|
- report
|
|
|
|
variables:
|
|
# Disable git depth for accurate change detection
|
|
GIT_DEPTH: 0
|
|
# Use npm ci for faster, deterministic installs
|
|
npm_config_cache: "$CI_PROJECT_DIR/.npm"
|
|
# Playwright browser cache
|
|
PLAYWRIGHT_BROWSERS_PATH: "$CI_PROJECT_DIR/.cache/ms-playwright"
|
|
|
|
# Caching configuration
|
|
cache:
|
|
key:
|
|
files:
|
|
- package-lock.json
|
|
paths:
|
|
- .npm/
|
|
- .cache/ms-playwright/
|
|
- node_modules/
|
|
|
|
# Lint stage - Code quality checks
|
|
lint:
|
|
stage: lint
|
|
image: node:20
|
|
script:
|
|
- npm ci
|
|
- npm run lint
|
|
timeout: 5 minutes
|
|
|
|
# Test stage - Parallel execution with sharding
|
|
.test-template: &test-template
|
|
stage: test
|
|
image: node:20
|
|
needs:
|
|
- lint
|
|
before_script:
|
|
- npm ci
|
|
- npx playwright install --with-deps chromium
|
|
artifacts:
|
|
when: on_failure
|
|
paths:
|
|
- test-results/
|
|
- playwright-report/
|
|
expire_in: 30 days
|
|
timeout: 30 minutes
|
|
|
|
test:shard-1:
|
|
<<: *test-template
|
|
script:
|
|
- npm run test:e2e -- --shard=1/4
|
|
|
|
test:shard-2:
|
|
<<: *test-template
|
|
script:
|
|
- npm run test:e2e -- --shard=2/4
|
|
|
|
test:shard-3:
|
|
<<: *test-template
|
|
script:
|
|
- npm run test:e2e -- --shard=3/4
|
|
|
|
test:shard-4:
|
|
<<: *test-template
|
|
script:
|
|
- npm run test:e2e -- --shard=4/4
|
|
|
|
# Burn-in stage - Flaky test detection
|
|
burn-in:
|
|
stage: burn-in
|
|
image: node:20
|
|
needs:
|
|
- test:shard-1
|
|
- test:shard-2
|
|
- test:shard-3
|
|
- test:shard-4
|
|
# Only run burn-in on merge requests to main/develop or on schedule
|
|
rules:
|
|
- if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
|
|
- if: '$CI_PIPELINE_SOURCE == "schedule"'
|
|
before_script:
|
|
- npm ci
|
|
- npx playwright install --with-deps chromium
|
|
script:
|
|
- |
|
|
echo "🔥 Starting burn-in loop - detecting flaky tests"
|
|
for i in {1..10}; do
|
|
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
echo "🔥 Burn-in iteration $i/10"
|
|
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
npm run test:e2e || exit 1
|
|
done
|
|
echo "✅ Burn-in complete - no flaky tests detected"
|
|
artifacts:
|
|
when: on_failure
|
|
paths:
|
|
- test-results/
|
|
- playwright-report/
|
|
expire_in: 30 days
|
|
timeout: 60 minutes
|
|
|
|
# Report stage - Aggregate results
|
|
report:
|
|
stage: report
|
|
image: alpine:latest
|
|
needs:
|
|
- test:shard-1
|
|
- test:shard-2
|
|
- test:shard-3
|
|
- test:shard-4
|
|
- burn-in
|
|
when: always
|
|
script:
|
|
- |
|
|
echo "## Test Execution Summary"
|
|
echo ""
|
|
echo "- Pipeline: $CI_PIPELINE_ID"
|
|
echo "- Shards: 4"
|
|
echo "- Branch: $CI_COMMIT_REF_NAME"
|
|
echo ""
|
|
echo "View detailed results in job artifacts"
|