Skip to content

docs: add architecture glossary for newcomers - #7

Open
VivekVRobo wants to merge 2 commits into
mainfrom
docs/architecture-glossary-2026-10
Open

VivekVRobo wants to merge 2 commits into
mainfrom
docs/architecture-glossary-2026-10

Conversation

@VivekVRobo

Copy link
Copy Markdown
Owner

Closes #2.

Summary

  • Add a discoverable architecture glossary for the core terms listed in the issue.
  • Define the Executive Kernel, Executive Model/model lease, EAP, Alignment Contract, canonical state, Intelligence Fabric, Tool Gateway, action classes, durable missions, worker leases/fencing, evidence gates, and remediation/rollback in plain technical language.
  • Link each definition to the repository's existing specification, invariant, requirement, or ADR rather than introducing new architecture.
  • Add the glossary to the README's top navigation and Start Here table.

Scope and evidence

  • Documentation-only; no runtime behavior, authority rules, or release gates changed.
  • Checked every relative link in the new glossary against the current repository tree.
  • Definitions preserve the repository's distinction between implemented checkpoint capabilities and target-environment evidence.

Validation

  • Initial branch diff was empty against main at a006b241a3caf604ba72062dc639c1d01f7b6273.
  • Final compare contains only docs/architecture/GLOSSARY.md and two README link additions.
  • GitHub Actions CI will be checked after the PR-triggered run starts.

Copilot AI balanced review requested due to automatic review settings October 30, 2026 03:18

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.

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.

Add a newcomer glossary for core Universal Brain architecture terms

2 participants