Operating model
Product Compass separates facts, strategy, and synthesis.
| Type | Description | Editing rule |
|---|---|---|
| Generated facts | Pulled from project repositories, Hub exports, or generated metadata. | Do not edit manually. Fix the source or generator. |
| Curated strategy | Human-authored product notes, opportunity analysis, and capability interpretation. | Edit directly in Product Compass. |
| Synthesised intelligence | Generated from facts plus curated strategy, often for AI or executive summaries. | Regenerate when inputs change. |
Recommended first implementation
Start simple:
- List project sources in
data/sources.meridian.jsonc. - Fetch project-owned dossiers from GitHub or local checkouts.
- Validate the fetched metadata.
- Generate Docusaurus pages.
- Generate AI-readable Markdown and JSON.
- Add curated notes only where synthesis is needed.
Avoid object storage, databases, and submodules until the GitHub/local-file model is not enough.
Maturity model for reuse
| Stage | Meaning |
|---|---|
| Local implementation | Built inside one project because that is where the need first appears. |
| Repeated pattern | Similar code or structure appears in more than one place. |
| Documented pattern | The approach is described so humans and agents can follow it consistently. |
| Extracted component | The reusable piece becomes a package, template, helper, or generator. |
| Governed package | The reusable asset has ownership, versioning, validation, and documented consumers. |