Skip to content

docs: add an architecture page with the package layers - #21

Merged
mbalazy merged 4 commits into
mainfrom
docs/architecture-diagram
Oct 10, 2026
Merged

mbalazy merged 4 commits into
mainfrom
docs/architecture-diagram

Conversation

@mbalazy

@mbalazy mbalazy commented Oct 10, 2026

Copy link
Copy Markdown
Owner

Stacked on #20.

Adds docs/architecture.md, linked from docs/README.md. It holds one Mermaid diagram of the package layers: storage at the bottom, the service layer, the front ends (CLI, board, MCP server, web server) and the executor beside them. A short page explains each box and where the boundaries are.

Every solid arrow is an import listed by go list -f '{{.ImportPath}}: {{join .Imports " "}}' ./.... The dashed arrows mark process boundaries, where the board and the cockpit start pm as a child process instead of importing the executor. The leaf helpers are listed in text to keep the picture on one screen.

Docs only.

@mbalazy
mbalazy changed the base branch from refactor/move-executor-package to main October 10, 2026 16:47
@mbalazy
mbalazy merged commit 3260e06 into main Oct 10, 2026
2 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.

1 participant