Skip to content

docs: Document minimal dependency architecture as reference pattern#183

Merged
kcenon merged 2 commits into
mainfrom
docs/182-minimal-dependency-architecture
Dec 26, 2025
Merged

docs: Document minimal dependency architecture as reference pattern#183
kcenon merged 2 commits into
mainfrom
docs/182-minimal-dependency-architecture

Conversation

@kcenon

@kcenon kcenon commented Dec 26, 2025

Copy link
Copy Markdown
Owner

Summary

  • Document container_system's minimal dependency architecture as a reference pattern
  • Add Dependency Philosophy section to ARCHITECTURE.md explaining why minimal dependencies matter
  • Update README with dependency diagram showing clean architecture

Changes

docs/ARCHITECTURE.md (and _KO.md)

  • Add new "Minimal Dependency Architecture" section
  • Document dependency philosophy and isolation principles
  • Add integration patterns showing unidirectional dependencies
  • Document external vs ecosystem dependencies
  • Include build configuration examples
  • Add minimal dependency checklist for other modules
  • Document dependency tier system

README.md (and _KO.md)

  • Add Dependencies section with visual diagram
  • Show minimal architecture benefits
  • Link to detailed architecture documentation

Test plan

  • Verify all links work correctly
  • Check documentation renders properly in GitHub
  • Ensure Korean translations are accurate

Closes #182

- Add Dependency Philosophy explaining why minimal dependencies matter
- Document how container_system achieves isolation (only common_system)
- Add integration patterns showing unidirectional dependencies
- Document external vs ecosystem dependencies distinction
- Add build configuration examples for different scenarios
- Include minimal dependency checklist for other modules
- Document dependency tier system for ecosystem
- Add Dependencies section showing minimal architecture
- Document single ecosystem dependency (common_system)
- Explain benefits of minimal dependency approach
- Link to detailed ARCHITECTURE documentation
@kcenon kcenon merged commit da9d10b into main Dec 26, 2025
25 checks passed
@kcenon kcenon deleted the docs/182-minimal-dependency-architecture branch December 26, 2025 15:10
kcenon added a commit that referenced this pull request Apr 13, 2026
…183)

* docs(architecture): add minimal dependency architecture section

- Add Dependency Philosophy explaining why minimal dependencies matter
- Document how container_system achieves isolation (only common_system)
- Add integration patterns showing unidirectional dependencies
- Document external vs ecosystem dependencies distinction
- Add build configuration examples for different scenarios
- Include minimal dependency checklist for other modules
- Document dependency tier system for ecosystem

* docs(readme): add dependency diagram and minimal architecture info

- Add Dependencies section showing minimal architecture
- Document single ecosystem dependency (common_system)
- Explain benefits of minimal dependency approach
- Link to detailed ARCHITECTURE documentation
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: Document minimal dependency architecture as reference pattern

1 participant