Skip to content

Refactor: Replace BB5 terminology with M4 in methodology files #3

@tikankika

Description

@tikankika

Background

Per ADR-002, the naming convention changed from "Building Blocks" (BB1-BB6) to "Modules" (M1-M4 + Pipeline). However, the methodology files still contain old BB5 terminology.

Files to Update

methodology/m4/ (6 files)

  • m4_0_intro.md - ~15 occurrences of "BB5", "bb5a-bb5f"
  • m4_1_automated_validation.md - "Next File: bb5c"
  • m4_2_pedagogical_review.md - "Next File: bb5d"
  • m4_3_collective_analysis.md - "BB5", "Next File: bb5e"
  • m4_4_documentation.md - "Next File: bb5f"
  • m4_5_output_transition.md - ~20 occurrences of "BB5", "BB6"

methodology/m3/ (3 files)

  • m3_1_basic_generation.md - "that's BB5"
  • m3_3_finalization.md - "ready for BB5"
  • m3_4_process_guidelines.md - "BB5 validation", "Next: bb5"

What NOT to change

  • docs/adr/ - Historical documentation (OK to keep BB5 references)
  • docs/specs/mqg-to-questionforge-migration.md - Migration guide needs old names
  • docs/chat_claude_desctop/ - Historical chat logs

Terminology mapping

Old New
BB5 M4
BB6 Pipeline
Building Block 5 Module 4 (Quality Assurance)
bb5a m4_0
bb5b m4_1
bb5c m4_2
bb5d m4_3
bb5e m4_4
bb5f m4_5

Estimated changes

~40 replacements across 9 files

Related

  • ADR-002: Module naming convention

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions