ros/BMAD-METHOD
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: addressed review comments from manjaroblack, round 1

Browse Source
This commit is contained in:
Murat Ozcan
2025-08-14 10:03:55 -05:00
parent 147d444aeb
commit 2a18c33c7f
1 changed files with 25 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
docs/working-in-the-brownfield.md
View File

@@ -254,7 +254,7 @@ Brownfield changes should:
- Include migration scripts - Include migration scripts
- Maintain backwards compatibility - Maintain backwards compatibility
### 4. Test Integration with the Test Architect ### 4. Test Integration Thoroughly
#### Why the Test Architect is Critical for Brownfield #### Why the Test Architect is Critical for Brownfield
@@ -264,14 +264,14 @@ In brownfield projects, the Test Architect (Quinn) becomes your safety net again
The Test Architect addresses unique brownfield complexities: The Test Architect addresses unique brownfield complexities:
| **Challenge** | **How Test Architect Helps** | **Command** | | **Challenge** | **How Test Architect Helps** | **Command** |
|--------------|------------------------------|-------------| | --------------------------- | ------------------------------------------------- | ------------------- |
| **Regression Risks** | Identifies which existing features might break | `*risk` | | **Regression Risks** | Identifies which existing features might break | `*risk` |
| **Legacy Dependencies** | Maps integration points and hidden dependencies | `*trace` | | **Legacy Dependencies** | Maps integration points and hidden dependencies | `*trace` |
| **Performance Degradation** | Validates no slowdown in existing flows | `*nfr` | | **Performance Degradation** | Validates no slowdown in existing flows | `*nfr` |
| **Coverage Gaps** | Finds untested legacy code that new changes touch | `*design` | | **Coverage Gaps** | Finds untested legacy code that new changes touch | `*design` |
| **Breaking Changes** | Detects API/contract violations | `*review` | | **Breaking Changes** | Detects API/contract violations | `*review` |
| **Migration Safety** | Validates data transformations and rollback plans | `*risk` + `*review` | | **Migration Safety** | Validates data transformations and rollback plans | `*risk` + `*review` |
#### Complete Test Architect Workflow for Brownfield #### Complete Test Architect Workflow for Brownfield
@@ -284,14 +284,14 @@ The Test Architect addresses unique brownfield complexities:
@qa *risk {brownfield-story} @qa *risk {brownfield-story}
# Identifies: Legacy dependencies, breaking changes, integration points # Identifies: Legacy dependencies, breaking changes, integration points
# Output: docs/qa/assessments/{epic}.{story}-risk-{YYYYMMDD}.md # Output: docs/qa/assessments/{epic}.{story}-risk-{YYYYMMDD}.md
# Brownfield Focus: # Brownfield Focus:
# - Regression probability scoring # - Regression probability scoring
# - Affected downstream systems # - Affected downstream systems
# - Data migration risks # - Data migration risks
# - Rollback complexity # - Rollback complexity
# 2. TEST DESIGN (After risk assessment) # 2. TEST DESIGN (After risk assessment)
@qa *design {brownfield-story} @qa *design {brownfield-story}
# Creates: Regression test strategy + new feature tests # Creates: Regression test strategy + new feature tests
# Output: docs/qa/assessments/{epic}.{story}-test-design-{YYYYMMDD}.md # Output: docs/qa/assessments/{epic}.{story}-test-design-{YYYYMMDD}.md
# Brownfield Focus: # Brownfield Focus:
@@ -335,7 +335,7 @@ The Test Architect addresses unique brownfield complexities:
# 5. FULL REVIEW (When development complete) # 5. FULL REVIEW (When development complete)
@qa *review {brownfield-story} @qa *review {brownfield-story}
# Performs: Deep analysis + active refactoring # Performs: Deep analysis + active refactoring
# Outputs: # Outputs:
# - QA Results in story file # - QA Results in story file
# - Gate file: docs/qa/gates/{epic}.{story}-{slug}.yml # - Gate file: docs/qa/gates/{epic}.{story}-{slug}.yml
``` ```
@@ -366,12 +366,12 @@ The review specifically analyzes:
The Test Architect uses enhanced risk scoring for brownfield: The Test Architect uses enhanced risk scoring for brownfield:
| **Risk Category** | **Brownfield Factors** | **Impact on Gate** | | **Risk Category** | **Brownfield Factors** | **Impact on Gate** |
|------------------|------------------------|-------------------| | ---------------------- | ------------------------------------------ | ------------------- |
| **Regression Risk** | Number of integration points × Age of code | Score ≥9 = FAIL | | **Regression Risk** | Number of integration points × Age of code | Score ≥9 = FAIL |
| **Data Risk** | Migration complexity × Data volume | Score ≥6 = CONCERNS | | **Data Risk** | Migration complexity × Data volume | Score ≥6 = CONCERNS |
| **Performance Risk** | Current load × Added complexity | Score ≥6 = CONCERNS | | **Performance Risk** | Current load × Added complexity | Score ≥6 = CONCERNS |
| **Compatibility Risk** | API consumers × Contract changes | Score ≥9 = FAIL | | **Compatibility Risk** | API consumers × Contract changes | Score ≥9 = FAIL |
#### Brownfield Testing Standards #### Brownfield Testing Standards
@@ -387,13 +387,13 @@ Quinn enforces additional standards for brownfield:
#### Quick Reference: Brownfield Test Commands #### Quick Reference: Brownfield Test Commands
| **Scenario** | **Commands to Run** | **Order** | **Why Critical** | | **Scenario** | **Commands to Run** | **Order** | **Why Critical** |
|-------------|-------------------|-----------|------------------| | --------------------------------- | ---------------------------------------------------- | ---------- | ----------------------------- |
| **Adding Feature to Legacy Code** | `*risk` → `*design` → `*trace` → `*review` | Sequential | Map all dependencies first | | **Adding Feature to Legacy Code** | `*risk` → `*design` → `*trace` → `*review` | Sequential | Map all dependencies first |
| **API Modification** | `*risk` → `*design` → `*nfr` → `*review` | Sequential | Prevent breaking consumers | | **API Modification** | `*risk` → `*design` → `*nfr` → `*review` | Sequential | Prevent breaking consumers |
| **Performance-Critical Change** | `*nfr` early and often → `*review` | Continuous | Catch degradation immediately | | **Performance-Critical Change** | `*nfr` early and often → `*review` | Continuous | Catch degradation immediately |
| **Data Migration** | `*risk` → `*design` → `*trace` → `*review` → `*gate` | Full cycle | Ensure data integrity | | **Data Migration** | `*risk` → `*design` → `*trace` → `*review` → `*gate` | Full cycle | Ensure data integrity |
| **Bug Fix in Complex System** | `*risk` → `*trace` → `*review` | Focused | Prevent side effects | | **Bug Fix in Complex System** | `*risk` → `*trace` → `*review` | Focused | Prevent side effects |
#### Integration with Brownfield Scenarios #### Integration with Brownfield Scenarios