菜单
Repository layout for the pacman Go PostgreSQL HA cluster manager.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| 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.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.