Skip to content

Service to Doc Ownership

Date: 2026-02-08 Status: Draft

This document maps service ownership to the current documentation structure. It is the fast path for understanding what each doc governs and which service it applies to.

Repository Map (Top Level)

  • docs/: Source of truth for product, architecture, contracts, ADRs, and specs.
  • infra/: Terraform and environment configuration for AWS deployments.
  • services/: Microservices implementation (integrations, discovery, audit, iam).
  • packages/: Shared libraries and SDKs used by services and connectors.
  • tests/: Test suites for system behavior and contracts.

Service Alignment (Current)

  • Integrations service: 05-specs/slices/slice-001-integrations-and-connections.md, 04-contracts/integrations-api-and-data.md, 04-contracts/connector-spec.md, 06-decisions/0002-integration-vs-connector-terminology.md, 03-architecture/engineering-principles.md, 02-domain/glossary.md.
  • Discovery service: 05-specs/slices/slice-002-discovery-runs.md, 05-specs/discovery-onboarding.md, 04-contracts/canonical-model.md, 04-contracts/connector-spec.md, 06-decisions/0001-canonical-entities-and-relationships.md, 06-decisions/0003-canonical-id-and-evidence-storage.md, 06-decisions/0004-discovery-execution-architecture.md, 03-architecture/engineering-principles.md.
  • Access Explorer UI and APIs: 05-specs/slices/slice-003-access-explorer.md, 04-contracts/canonical-model.md, 06-decisions/0001-canonical-entities-and-relationships.md, 01-vision/product-principles.md.
  • Audit service: 05-specs/slices/slice-000-audit-platform.md, 06-decisions/0005-audit-platform-and-action-inventory.md, 03-architecture/engineering-principles.md.
  • IAM service: 05-specs/authentication-iam.md, 05-specs/iam-roadmap.md, 03-architecture/engineering-principles.md.
  • Global control plane: 05-specs/global-control-plane-registry-and-licensing.md, 03-architecture/tenancy-model.md, 03-architecture/deployment-aws.md, 03-architecture/engineering-principles.md.

Future Service Alignment (Planned)

  • IAM service: 05-specs/authentication-iam.md, 05-specs/iam-roadmap.md, 03-architecture/engineering-principles.md.

Package Alignment (Current)

  • packages/audit-client: Client library used by services to emit audit events.
  • packages/connectors: Connector implementations or scaffolding (provider-specific).
  • packages/contracts: Shared TypeScript contracts mirroring docs/04-contracts/.
  • packages/discovery-sdk: SDK for connector authors; mirrors canonical model and connector contracts.
  • packages/http-middleware: Shared authn/authz middleware and request tooling for services.