Glossary
Scope note: this page is the portal-maintenance vocabulary (how the portal is built). The authoritative ecosystem glossary — with owner, related concepts, where-used, and first-class status per term — is the Portfolio Glossary. Where they overlap, the Portfolio Glossary is canonical.
Shared vocabulary for the portal. Use these terms consistently across all pages.
| Term | Definition |
|---|---|
| Portal | This repository — the markdown-first system-of-systems layer. |
| Repo digest | A one-page factual summary of a single source repository, living in portal/repos/. |
| Venture / system | A grouping of one or more repos that together deliver a product, service, or capability. Documented in portal/ventures/. |
| Registry | The canonical index of every repo, in portal/registry/repo-registry.md. |
| System of systems | The whole ecosystem viewed as interacting ventures and repos, rather than any single app. |
| Showcase | The future public-facing presentation layer (Phase C), in showcase/. |
| ADR | Architecture Decision Record — an immutable record of a significant decision. |
| Orchestrator | The future portfolio-portal-orchestrator skill that will automate digest and diagram generation. |
| Capability | A distinct function a repo provides (e.g. “auth”, “vector search”, “billing”). Used to detect duplication across repos. |
| Digest | Generic term for a summary page (repo digest or venture digest). |
| Layer | One of the three explanation levels: repo-level docs, portfolio portal, public showcase. |
| Generated region | A block wrapped in <!-- GENERATED --> markers that the orchestrator owns. |
| Human region | A block wrapped in <!-- HUMAN --> markers that automation must preserve. |
TODO: Extend with venture-specific and domain-specific terms as the ecosystem is mapped.