Skip to content

docs: add living architecture guidance#242

Merged
zfields merged 36 commits into
blues:masterfrom
zakoverflow:docs/living-architecture-docs
May 22, 2026
Merged

docs: add living architecture guidance#242
zfields merged 36 commits into
blues:masterfrom
zakoverflow:docs/living-architecture-docs

Conversation

@zakoverflow
Copy link
Copy Markdown
Contributor

@zakoverflow zakoverflow commented May 18, 2026

Summary

  • Add a repository-level ARCHITECTURE.md for note-c's core boundaries, data flow, public contracts, runtime model, and update triggers.
  • Add docs/architecture/architecture.html as an interactive single-file visual architecture map with layer bands, dependency arrows, clickable nodes, view filters, source paths, contracts, and architecture hotspots.
  • Add docs/architecture/architecture.json as a structured architecture map for future AI agents and tooling.
  • Add docs/architecture/ maintenance rules, an initial ADR, and a reusable architecture template.
  • Add AI tool entrypoints for Codex/OpenClaw, Claude, Gemini, Copilot, and Cursor so future agents read and update architecture docs alongside architecture-relevant changes.

Verification

  • Validated docs/architecture/architecture.json with jq.
  • Checked generated HTML for unresolved placeholders and obvious generated-token errors.
  • Could not render a browser/canvas screenshot in this environment because no supported browser is installed and the canvas renderer reported node required.
  • Documentation-only change; no build or unit tests run.

@zfields zfields merged commit eba4fd5 into blues:master May 22, 2026
13 checks passed
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