Repository Documentation
Engineering documentation
for AI-assisted repositories
Repository governance systems, migration workflows, architecture constraints and engineering standards.
24 documentsUpdated 2 days agov0.4.2
Architecture
Repository architecture
Repositories are organized around feature boundaries instead of technical layers.
apps/
packages/
shared/
validators/
workflows/
migration-notes/
packages/
shared/
validators/
workflows/
migration-notes/
Repository Files
Governance files
AI Constraints
AI engineering constraints
- avoid large rewrites
- preserve migration consistency
- avoid duplicated business logic
- preserve package boundaries
- reduce architecture drift
- preserve migration consistency
- avoid duplicated business logic
- preserve package boundaries
- reduce architecture drift
Testing Workflow
Repository testing workflow
1. validate architecture boundaries
2. run validation tests
3. verify migration compatibility
4. execute repository integration tests
5. confirm PR consistency
2. run validation tests
3. verify migration compatibility
4. execute repository integration tests
5. confirm PR consistency
PR Governance
Pull request standards
- preserve repository boundaries
- avoid duplicated validation
- verify migration safety
- review architectural consistency
- avoid duplicated validation
- verify migration safety
- review architectural consistency
Migration Notes
Active repository migrations
- dashboard validation migration in progress
- old analytics hooks pending cleanup
- billing services require standardization
- old analytics hooks pending cleanup
- billing services require standardization
Technical Debt
Known repository issues
- duplicated dashboard hooks
- inconsistent validator naming
- oversized shared utility modules
- inconsistent validator naming
- oversized shared utility modules
Incident Log
Recent repository incidents
2026-05-08
- duplicated auth hooks introduced during billing migration
2026-05-04
- analytics service bypassed validation layer
2026-04-28
- migration workflow broke shared server boundaries
- duplicated auth hooks introduced during billing migration
2026-05-04
- analytics service bypassed validation layer
2026-04-28
- migration workflow broke shared server boundaries
Related Engineering Standards
Explore AI-safe coding standards, repository constraints and engineering conventions.
View AI Coding Standards →