# core

## Scope

The core domain covers the Go control plane, worker, core
models, platformless Git engine, provider adapters, storage, migrations, and
events.

## Included Paths

- `services/core/cmd/**`
- `services/core/internal/**`
- `services/core/migrations/**`
- `services/core/go.mod`

## Rules

- Keep provider-specific API details out of `internal/core`.
- Keep GitHub/GitLab/Gitea/Plane/Jira calls behind `internal/provider`.
- Keep platformless Git operations in `internal/gitengine`.
- Gito does not execute agent/shell commands directly; execution is delegated to the sibling ../iop project.
- Store durable state and audit trails in PostgreSQL first.
- Redis, if added, is an acceleration layer and not the source of truth.
- Large behavior changes require tests.