| name | Architecture Remediation |
| description | Comprehensive architecture remediation module for systematic elimination of technical debt. Use this skill when addressing god stores (>300 lines), oversized components, TypeScript errors, test coverage gaps, workspace file system E2E issues, or sync strategy fragmentation. This module provides structured agents and workflows for foundation stabilization, workspace E2E implementation, and quality assurance. |
Architecture Remediation
This Skill provides Claude Code with specific guidance for executing systematic architecture remediation using the BMAD framework.
When to use this skill
- When eliminating god stores (>300 lines) by splitting into modular slices
- When refactoring oversized React components (>300 lines)
- When fixing TypeScript errors systematically (batch fixing, pattern identification)
- When improving test coverage to ≥80%
- When implementing workspace file system E2E (IDE, Notes, Knowledge)
- When consolidating sync strategies across workspaces
- When executing Epic ARC-1 through ARC-4 stories
- When applying facade patterns for backward compatibility
- When validating architecture changes with incremental TypeScript checking
Module Structure
The architecture remediation module consists of:
Agents (Specialists)
- store-refactorer: God store elimination and modularization
- component-splitter: Component size normalization and hook extraction
- typescript-fixer: Batch TypeScript error remediation
- test-writer: Test coverage improvement and quality assurance
- workspace-architect: Workspace E2E implementation specialist
- file-sync-specialist: Sync strategies and conflict resolution
Workflows (Structured Processes)
- eliminate-god-stores: Systematic store refactoring workflow
- normalize-components: Component splitting workflow
- workspace-file-system-e2e: Workspace end-to-end validation
- notes-sync-strategy: Notes workspace sync implementation
- knowledge-sync-strategy: Knowledge workspace sync implementation
Epics (Structured Work)
- ARC-1: Foundation Stabilization (P0 - Week 1)
- ARC-2: IDE Workspace E2E (P0 - Week 2)
- ARC-3: Notes Workspace E2E (P0 - Week 3)
- ARC-4: Knowledge Workspace E2E (P0 - Week 4)
Instructions
This skill loads all architecture remediation sub-skills. Use individual agent or workflow skills for specific tasks:
Governance Rules
Always follow these governance rules when executing architecture remediation:
- Post-Workflow Documentation: Update AGENTS.md, CLAUDE.md, sprint-status.yaml
- Repomix Cleanup: Delete repomix output files after analysis
- TypeScript Strategy: Ignore test file errors, use incremental checking
- File Size Limits: Stores ≤120 lines, components ≤300 lines
- Backward Compatibility: Use facade patterns, zero breaking changes
Quick Reference
Next Action: ARC-1.1 - Split dexie-db.ts (1,267 lines)
"Split dexie-db.ts using eliminate-god-stores workflow"
Sprint Status: _bmad-output/sprint-artifacts/arc-sprint-status.yaml
Epic Tracking: _bmad/modules/architecture-remediation/artifacts/epic-tracking.md
For detailed implementation guidance, refer to:
Architecture Remediation Module
