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

Gito Project Rules

Language

• User-facing final answers default to Korean.
• Code identifiers, paths, commands, and commit scopes stay in the language used by the project.

Project Summary

Gito is a platformless Git control plane for agent-driven development. It owns repo registry, workspace leases, Git operations, agent-shell execution, provider-neutral change requests, provider adapters, and normalized events.

Main Structure

• services/core/ - Go server, worker, shell, core domain, storage, adapters.
• apps/client/ - Flutter control surface.
• packages/contracts/ - proto-socket, REST, event, and DTO contract notes.
• bin/ - root test/lint/build helpers.
• docs/ - architecture and operation documents.
• agent-ops/ - agent rules.
• agent-test/ - local validation rules.

Stack

• Backend: Go, PostgreSQL, optional Redis.
• Client: Flutter/Dart.
• Internal transport: proto-socket first.
• REST: health/readiness, provider callbacks, smoke/curl, bootstrap.
• gRPC: excluded from the initial design.

Conventions

• Prefer bin/test, bin/lint, and bin/build from the repository root.
• Keep Git operations platformless unless a provider adapter is explicitly in scope.
• Provider APIs belong behind adapter boundaries.
• Agent-shell owns local command execution; control plane and core should not run arbitrary workspace commands directly.
• Credential values must be referenced by credential_ref or local secret files, never stored in tracked docs.

Domain Map

Path	Domain	Rules
services/core/**	core	agent-ops/rules/project/domain/core/rules.md
apps/client/**	client	agent-ops/rules/project/domain/client/rules.md
packages/contracts/**	contracts	agent-ops/rules/project/domain/contracts/rules.md
bin/**, docs/**, AGENTS.md, README.md, agent-ops/**, agent-test/**	workspace-ops	agent-ops/rules/project/domain/workspace-ops/rules.md