Skip to content

docs: add Draft Component term to glossary - #71

Merged
NTCoding merged 1 commit into
mainfrom
issue-39-m2-d2-4-add-draft-component-te
Jan 8, 2026
Merged

NTCoding merged 1 commit into
mainfrom
issue-39-m2-d2-4-add-draft-component-te

Conversation

@NTCoding

@NTCoding NTCoding commented Jan 8, 2026 •

Copy link
Copy Markdown
Owner

Closes #39

Summary

  • Add "Draft Component" term to domain glossary under Extraction concepts
  • Definition: A component in a minimal state that has not been added to a graph yet because it lacks information, possibly including required fields. Draft components are not validated against the schema because they will likely fail validation.

Test plan

  • Term exists in glossary
  • Definition is clear and accurate

Summary by CodeRabbit

  • Documentation
    • Added "Draft Component" to the architecture domain terminology glossary, describing a component in its minimal state awaiting addition to a graph.

✏️ Tip: You can customize this high-level summary in your review settings.

Add note explaining components are runtime collaborators, not static code units.

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@coderabbitai

coderabbitai Bot commented Jan 8, 2026 •

Copy link
Copy Markdown
📝 Walkthrough

Walkthrough

A new glossary term "Draft Component" has been added to the domain terminology glossary. This term defines components in a minimal state that lack required information and have not been added to a graph, with a note that they are not validated against the schema due to expected validation failures.

Changes

Cohort / File(s) Summary
Glossary Entry Addition
docs/architecture/domain-terminology/contextive/definitions.glossary.yml
Added new "Draft Component" term defining a component in minimal state with missing information, not yet added to a graph, and not validated against schema

Estimated Code Review Effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly Related PRs

Poem

🐰 A glossary grows with each new word,
"Draft Components" now clearly heard,
Minimal states before they fly,
To the graph where connections tie! ✨

🚥 Pre-merge checks | ✅ 4
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs: add Draft Component term to glossary' clearly and specifically describes the main change in the pull request.
Linked Issues check ✅ Passed The pull request successfully implements all coding requirements from issue #39, adding the Draft Component glossary entry with a definition aligned with PRD usage and extraction concepts.
Out of Scope Changes check ✅ Passed All changes are directly related to issue #39 objectives. The pull request adds only the Draft Component glossary term as specified, with no extraneous modifications.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Comment @coderabbitai help to get the list of available commands and usage tips.

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying living-architecture with  Cloudflare Pages  Cloudflare Pages

Latest commit: e1d7eae
Status: ✅  Deploy successful!
Preview URL: https://8716b496.living-architecture.pages.dev
Branch Preview URL: https://issue-39-m2-d2-4-add-draft-c.living-architecture.pages.dev

View logs

@sonarqubecloud

sonarqubecloud Bot commented Jan 8, 2026

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot 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.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In @docs/architecture/domain-terminology/contextive/definitions.glossary.yml:
- Around line 66-67: Update the "Draft Component" glossary entry so the
definition explicitly states that draft components have no connections and
therefore are not a valid Riviere graph; amend the existing text for the "Draft
Component" entry (the name: "Draft Component") to mention "no connections" and
the phrase "not a valid Riviere graph (no connections)" while retaining the
existing points about minimal state and lack of required fields and schema
validation.
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between a704389 and e1d7eae.

📒 Files selected for processing (1)
  • docs/architecture/domain-terminology/contextive/definitions.glossary.yml
🧰 Additional context used
🧠 Learnings (3)
📓 Common learnings
Learnt from: CR
Repo: NTCoding/living-architecture PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-08T17:19:05.921Z
Learning: When discussing domain concepts, clarify terminology with the user and add new terms to `docs/architecture/domain-terminology/contextive/definitions.glossary.yml`
📚 Learning: 2026-01-08T17:19:05.921Z
Learnt from: CR
Repo: NTCoding/living-architecture PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-08T17:19:05.921Z
Learning: When discussing domain concepts, clarify terminology with the user and add new terms to `docs/architecture/domain-terminology/contextive/definitions.glossary.yml`

Applied to files:

  • docs/architecture/domain-terminology/contextive/definitions.glossary.yml
📚 Learning: 2026-01-08T07:05:01.746Z
Learnt from: CR
Repo: NTCoding/living-architecture PR: 0
File: packages/riviere-extract-conventions/CLAUDE.md:0-0
Timestamp: 2026-01-08T07:05:01.746Z
Learning: Configure ESLint to enforce component decorators on classes using the `require-component-decorator` rule from `living-architecture/riviere-extract-conventions/eslint-plugin`

Applied to files:

  • docs/architecture/domain-terminology/contextive/definitions.glossary.yml
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: Cloudflare Pages

@NTCoding
NTCoding merged commit b4aca4c into main Jan 8, 2026
10 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.

[M2-D2.4] Add Draft Component term to glossary

1 participant