Skip to content

docs: add architecture terms to governance glossary#63

Merged
normenmueller merged 2 commits into
trunkfrom
docs/62-glossary-architecture-terms
May 7, 2026
Merged

docs: add architecture terms to governance glossary#63
normenmueller merged 2 commits into
trunkfrom
docs/62-glossary-architecture-terms

Conversation

@normenmueller
Copy link
Copy Markdown
Owner

Story

closes #62 (S3: Glossary Architecture Terms)
Parent Epic: #59

Changes

Adds an Architecture Terms section to adm/gdl/glossary.md with five canonical definitions:

Term Design Target?
Agent Host No (factual)
Cognitive Capability Composition (CCC) Yes
Collaboration Topology Yes
Materialization Yes
Team Declaration Yes

Review remediation

  • Fixed cross-document enumeration drift in ADR-001 and adm/gdl/README.md
  • Clarified materialization as first step of spawn lifecycle (distinct from activation)
  • Fixed tautological phrasing

AC Coverage

AC Status
AC-10: Architecture Terms section
AC-11: Five terms defined
AC-12: Design Target qualifier
AC-13: No contradictions

Add Architecture Terms section with five canonical definitions:
Agent Host, Cognitive Capability Composition (CCC), Collaboration
Topology, Materialization, and Team Declaration.

Terms describing not-yet-implemented structures carry a Design Target
qualifier per AC-12.

closes #62
- Fix cross-document enumeration drift in ADR-001 and adm/gdl/README
  to include Architecture Terms (MEDIUM-1)
- Clarify materialization as first step of spawn lifecycle,
  distinct from activation (MEDIUM-2)
- Fix tautological 'agentic AI agents' phrasing (LOW-1)
@normenmueller normenmueller merged commit 195c56e into trunk May 7, 2026
1 check passed
@normenmueller normenmueller deleted the docs/62-glossary-architecture-terms branch May 7, 2026 22:39
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.

S3: Glossary Architecture Terms

1 participant