gito/agent-ops/rules/project/domain/core/rules.md

core

Scope

The core domain covers the Go control plane, worker, agent-shell command, 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.
• Agent command execution belongs in internal/agentshell.
• 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.