Skip to main content

Cross-project development rules

Source ownership​

  • Product repositories own facts about their own code, docs, metadata, and runtime.
  • Meridian core owns generic tooling, standards, schemas, validators, shared packages, scripts, and agent guidance.
  • Meridian Hub owns live operational visibility and recent provider state.
  • Product Compass owns synthesis and strategy.

Editing boundaries​

For Product Compass work:

  • Write only inside meridian-product-compass/.
  • Do not edit source product repositories while synthesising knowledge.
  • Do not edit Meridian core to store product strategy.
  • If source material is stale or missing, document the gap in Product Compass.

Client boundary​

Do not include client-specific information in Product Compass. If a client project demonstrates a reusable generic pattern, describe the pattern generically without naming the client or leaking details.

Reuse rules​

  • Do not extract a package just because code exists.
  • Prefer pattern first, blueprint second, package third.
  • A shared package should have at least two real consumers, a clear owner, a small API, isolated tests, and no product-specific domain knowledge.
  • Product-specific business rules stay in product repos.

Evidence rules​

  • Use "Fact" for directly supported source material.
  • Use "Inference" for reasoned cross-source conclusions.
  • Use "Opportunity" for future ideas.
  • Include "Sources consulted" in major docs.
  • Do not claim a source was inspected unless it was.

Safety rules for product ideas​

  • SiteIntel: preserve SSRF, crawl, paid API, and evidence boundaries.
  • DataStitcher: respect region/publication policy and human-reviewed AI suggestions.
  • BigQuery Atlas: never brute-force project IDs.
  • Bollocks Radar: no-match never means true.
  • Trackpal: do not expose OAuth tokens, service-role keys, or raw secrets.
  • Codex Sessions Analyser: raw session logs stay local by default.

Sources consulted​

  • docs/architecture/meridian-compass-knowledge-space.md
  • docs/architecture/meridian-works-shared-platform.md
  • meridian-product-compass/docs/compass/repository-boundaries.md
  • Product dossiers under meridian-product-compass/docs/projects/*/overview.md