architecture-catalog
Centralizes architecture decisions and system metadata in version-controlled Markdown, eliminating scattered documentation and enabling AI tools to query org…
Schema-driven, white-label architecture catalog that turns Markdown files with YAML frontmatter into an interactive static site: dashboards, domain maps, element details, context graphs, event flows, and health scores. Define the schema in one YAML mapping and the Astro/React UI renders everything with no custom code. Includes validation tools and Claude skills for AI-assisted authoring.
- Query ADR history to understand why a service uses a particular pattern
- Generate architecture decision summaries for new team members from Git history
- Validate proposed changes against documented architectural constraints
Centralizes architecture decisions and system metadata in version-controlled Markdown, eliminating scattered documentation and enabling AI tools to query organizational patterns programmatically.
Enterprise architecture teams and platform engineers documenting system topology and decision records at scale.
https://github.com/ea-toolkit/architecture-catalog
By ea-toolkit
How to Get It
git clone https://github.com/ea-toolkit/architecture-catalog.git && cd architecture-catalog/catalog-ui && npm install && npm run dev — then open http://localhost:4321
Tip: Paste this into a Claude Code conversation. Verify command matches your Claude Code version.
After installing, paste this into Claude:
Help me query ADR history to understand why a service uses a particular pattern
Trust Signals Auto-scanned
Community Pulse Active
Discussed on Hacker News, Reddit
- The National Builder's Album of Beautiful Homes is an architectural pattern book — Reddit · 103 pts
- Enterprise Architecture Reference Catalog — Reddit · 42 pts
- I built an open-source, Git-native architecture catalog — context maps, event fl — Reddit · 3 pts
3 mentions across 1 sources
Reviewer notes
Auto-scanned review. These are observations, not a security certification.
Auto-assessment from April sweep — baseline scores pending hands-on review.
2026-04-18: Approved in April sweep: New and small but has a clear description and recent commits — worth tracking.
Things to check
- Effectiveness depends on disciplined Markdown authoring and team adoption; no built-in enforcement that decisions stay synchronized with actual code. Schema validation happens at query time, not commit time, so stale entries can accumulate.
How to evaluate tools before deploying →
Data shown here comes from public APIs and automated scanning. Reviewer notes reflect one person's experience. This is not a security certification or legal recommendation. Always evaluate tools according to your own organization's policies.