Skip to content

AGENTS.md

Latest commit

 

History

History
68 lines (47 loc) · 2.56 KB

AGENTS.md

File metadata and controls

68 lines (47 loc) · 2.56 KB
Raw

AGENTS.md

Operational instructions for agents working in this repository.

Project identity

CompText is a local AI orchestration platform for software engineering.

Use these names consistently:

  • Product name: CompText
  • Repository, package, and CLI name: comptext
  • Constants and document titles: COMPTEXT

Current status

This repository is local dry-run MVP only. Do not present docs, schemas, contracts, or scaffolding as production-ready features.

Branch policy

main is canonical. New work branches from latest main.

Branch prefixes:

  • codex/<task>
  • fix/<bug>
  • docs/<topic>
  • plugin/<feature>

Review policy

  • Inspect all review and Gemini threads.
  • Fix actionable comments.
  • Resolve every completed thread.
  • Do not resolve ambiguous, unfixed, or out-of-scope comments.

Safety policy

  • Do not perform provider calls unless explicitly configured and requested.
  • Do not store secrets, API keys, raw environment variables, hidden chain-of-thought, or unredacted provider payloads in Evidence or logs.
  • Do not execute destructive commands without explicit approval.
  • Do not auto-push or auto-merge unless the user explicitly asks.
  • Do not create pull requests, merge, or release unless repository policy is explicitly changed.

Codex local autonomous mode

  • Use local autonomous mode only when explicitly requested.
  • Start with Token Saver/project state before broad repo reads.
  • Do not push, open PRs, merge, enable auto-merge, call GitHub APIs, perform provider calls, or read secrets unless explicitly instructed.
  • If local main is stale, stop and ask before git fetch.
  • Local commits are allowed in autonomous mode.
  • Required validation is python -m pytest and git diff --check.
  • Keep final reports compact: branch, local commit SHA, changed files, validation, blockers, and next action.
  • Detailed playbook: docs/CODEX_LOCAL_AUTONOMY.md.

Validation policy

  • Run relevant local tests or checks for the changed surface.
  • Documentation-only PRs may use markdown checks and git diff --check.
  • Keep provider states limited to not_configured, disabled, or experimental.

Navigation