Harness Product Monorepo

The Harness product monorepo is the repository shape that holds the Harness Intelligence product surfaces while preserving the existing CLI.

Boundaries

• apps/cli owns the executable hi/hint application.
• apps/api is the backend/control-plane app boundary and implements the shared Effect contract.
• apps/wiki is the private Fumadocs-backed wiki app and canonical routed docs owner.
• apps/web is the parked public web surface.
• packages/* hold shared contracts or infrastructure only when reuse is required.

Invariants

• Root task orchestration delegates through Turborepo package tasks.
• Consumer-repo business logic stays out of the CLI.
• Shared contracts move into packages only after more than one app needs them.
• The CLI remains the local executor for scaffold setup and update. Backend work can provide metadata and control-plane truth without taking over local filesystem mutation.

Validation Shape

The foundation is valid when root bun run check, bun run check-types, bun run test, and bun run build pass, and when the wiki app renders the Harness and CLI routes rather than default scaffold sample content. See Monorepo Foundation Validation for the evidence flow.