القائمة
Repository layout for the pacman Go PostgreSQL HA cluster manager.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Require a concrete change explanation and explicit user approval before modifying a repository, then implement and verify the approved scope. Use whenever Codex is asked to create, edit, delete, generate, format, refactor, fix, upgrade, or otherwise mutate repository files, dependencies, configuration, tests, documentation, build artifacts, or version-control state.
Use when inspecting GitHub Actions, CI failures, failed Go tests, workflow logs, or build/lint/test errors. Avoid reading full logs; summarize failed jobs and inspect only relevant snippets.
Maintain PACMAN-native and Patroni-compatible API contracts.
PACMAN domain rules for cluster state transitions and operation history.
Rules for PACMAN control-plane quorum, leases, epochs, fencing, and split-brain prevention.
Minimal Go build, test, debug, and lint workflow for pacman.
| name | repo-map |
| description | Repository layout for the pacman Go PostgreSQL HA cluster manager. |
Use this first when locating code. Prefer opening the narrow directory for the subsystem instead of loading broad docs.
Commit policy: do not create git commits unless the user explicitly asks for a commit in the current turn. Leave completed changes unstaged or staged as found so the user can review first.
cmd/pacmand, cmd/pacmanctl: binary entrypoints.internal/app/pacmand, internal/app/pacmanctl: CLI/application wiring.internal/controlplane: HA decisions, leader/source-of-truth, failover,
switchover, rejoin, epochs, and operation flow.internal/cluster: domain model: roles, members, status, maintenance,
operations, specs, and state-machine contracts.internal/agent: node agent orchestration around PostgreSQL and reporting.internal/postgres: PostgreSQL probes, commands, WAL/LSN, health, recovery,
standby, pg_rewind, and command wrappers.internal/dcs: DCS abstraction plus etcd, memory, and raft backends.internal/httpapi, internal/api: PACMAN-native and Patroni-compatible API
handlers/types/contracts.docs: architecture, API contract, OpenAPI, examples, demo, migration docs.docs/openapi: split OpenAPI source files; combined spec is
docs/openapi.yaml.test/integration, test/installintegration, test/testenv: integration
fixtures and end-to-end tests.jepsen, tools/jepsenctl: distributed-systems test matrix, harness,
checkers, and artifacts.deploy: lab, Patroni lab, Jepsen, Ansible, and systemd deployment assets.packaging, mk, tools/rpmctl, tools/pkglist: packaging and Make
automation.postgresql/pacman_agent: PostgreSQL extension code.