Articles Domain

2026-03-04

Purpose

This folder defines information intents for article-domain objects and article collections persisted behind the marketing BFF and, behind that, the CMS system.

The article domain currently includes:

• article objects
• article collections
• editorial metadata and registries

This folder should not be treated as a permanent local CMS replica.

Operating Model

The intended article lifecycle is:

1. article and collection intent is authored locally in this repo
2. local artifacts are reviewed and normalized against the BFF contract
3. those artifacts are persisted into the CMS system via BFF mutations
4. sites and assistants retrieve article-domain objects from BFF

So local article artifacts are staging artifacts, not the final system of record.

Current Article-Domain Documents

• Article Object Intents
• Article Collection Intents
• CMS Persistence Workflow
• Publish and Sync Procedure

Design Rule

Site documents under docs/sites/ express which article collections a site uses and how they are presented.

This folder expresses the article-domain objects and collection objects themselves.