Skip to content

docs: add ADR 006 documenting VEDA2 architecture refactor#1952

Merged
vgeorge merged 1 commit intomainfrom
docs/veda2-architecture-refactor-adr
Dec 11, 2025
Merged

docs: add ADR 006 documenting VEDA2 architecture refactor#1952
vgeorge merged 1 commit intomainfrom
docs/veda2-architecture-refactor-adr

Conversation

@vgeorge
Copy link
Contributor

@vgeorge vgeorge commented Dec 10, 2025

Summary

Add ADR 006 to document the VEDA2 architecture work executed in 2024. This captures the current hybrid state of the VEDA UI library and provides context for future architectural decisions.

Changes

Context

This documentation addresses the confusion around the "veda2" term that appears in code comments and discussions. It serves as a permanent record of:

  • What veda2 represents (next-generation architecture)
  • What was accomplished in 2024
  • The current state of the codebase
  • Relationship to ongoing strategic discussions

The ADR follows the established format and is positioned as ADR 006 to account for pending ADRs (004-005).

Files Changed

  • docs/adr/006-veda2-architecture-refactor.md (new)
  • docs/development/ARCHITECTURE.md (updated)

- Add comprehensive ADR documenting 2024 VEDA2 work
- Capture current hybrid state (legacy + VEDA2 patterns)
- Reference implementation PRs and strategic discussions
- Update ARCHITECTURE.md to link to new ADR
@netlify
Copy link

netlify bot commented Dec 10, 2025

Deploy Preview for veda-ui ready!

Name Link
🔨 Latest commit c11755e
🔍 Latest deploy log https://app.netlify.com/projects/veda-ui/deploys/6939637b4de7ed0008ddb6ac
😎 Deploy Preview https://deploy-preview-1952--veda-ui.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@vgeorge
Copy link
Contributor Author

vgeorge commented Dec 10, 2025

For more context, I created this ADR after @ifsimicoded raised questions about VEDA2 in #1950 (comment).

I was only partially involved in that refactor effort, so it would be great to get feedback from current team member more directly engaged at the time, which I think are @aboydnw, @dzole0311, and @snmln.

Copy link
Contributor

@ifsimicoded ifsimicoded left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you so much for this @vgeorge! This sums up so much that I circuitously arrived at over weeks -- months! It's great to have links to core issues and PRs

@vgeorge
Copy link
Contributor Author

vgeorge commented Dec 11, 2025

Thanks for the review, Simi! I'll merge this and we can update if the need arises.

@vgeorge vgeorge merged commit f603daf into main Dec 11, 2025
10 checks passed
@vgeorge vgeorge deleted the docs/veda2-architecture-refactor-adr branch December 11, 2025 09:07
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.

2 participants