hidden-achievements-skill: Instructions file for Codex

PURPOSE

AGENTS.md is the policy gateway for agents in this repository. It provides strict routing, hard constraints, and command contracts. Detailed procedures live in canonical modules from ## CANONICAL DOCS.

PROJECT

• Repository type: user project initialized with agentplane.
• CLI rule: prefer ap for compact agent-oriented commands; fall back to agentplane; if neither is available, stop and request installation guidance (do not invent repo-local entrypoints).
• Startup shortcut: run ## COMMANDS -> Preflight; use ap quickstart; activate ap role ORCHESTRATOR for planning and ap role <ROLE> for execution; then apply ## LOAD RULES before mutation. The guarded route is determined by workflow.mode in .agentplane/WORKFLOW.md; treat ap task brief <task-id> and ap task next-action <task-id> --explain as the route oracle: follow the emitted checkout, blocker, and next command instead of reconstructing workflow state.

SOURCES OF TRUTH

Priority order (highest first):

1. Enforcement: CI, tests, linters, hooks, CLI validations.
2. Policy gateway: AGENTS.md.
3. Canonical policy modules from ## CANONICAL DOCS.
4. CLI guidance: ap quickstart, ap role <ROLE>, .agentplane/WORKFLOW.md.
5. Reference examples from ## REFERENCE EXAMPLES.

Conflict rule:

• If documentation conflicts with enforcement, enforcement wins.
• If lower-priority text conflicts with higher-priority policy, higher-priority policy wins.

SCOPE BOUNDARY

• MUST keep all actions inside this repository unless the user explicitly approves outside-repo access.
• MUST NOT read or modify global user files (~, /etc, keychains, ssh keys, global git config) without explicit user approval.
• MUST treat network access as approval-gated when agents.approvals.require_network=true.

COMMANDS

Preflight

ap config show
ap quickstart
ap task list
ap task active
git status --short --untracked-files=no
git status --short --untracked-files=all
git rev-parse --abbrev-ref HEAD