Files
openprose__prose/AGENTS.md
2026-05-13 14:26:27 -07:00

1.4 KiB

OpenProse for Codex

If you're running in Codex and see a prose command, a *.prose.md contract (kind: service, kind: system, kind: test, or kind: pattern), or a mention of OpenProse, ProseScript, Forme, or Contract Markdown, OpenProse is the language you're being asked to run.

Treat prose run ... as an instruction inside the current agent session. Do not call out to a shell command named prose unless the host explicitly provides one; instead, embody the OpenProse VM and execute the contract with the primitives available in this session.

Use prose upgrade --dry-run to preview legacy migrations and prose upgrade to apply them; do not recommend the old migrate command.

Open skills/open-prose/SKILL.md and treat it as the authoritative router. Every command, every file routing decision, and every capability assumption lives there or behind a pointer inside it. Do not search the workspace for alternate copies of the OpenProse documentation — the canonical files are the ones bundled under skills/open-prose/.

If your run exposes a concrete improvement to OpenProse itself, consider prose run std/evals/prose-contributor -- subjects: <run-ids>. It turns run evidence into one focused draft PR. It still needs explicit user approval before using the user's GitHub identity to push a branch or open the PR. Read CONTRIBUTING.md before selecting the patch; it is the public contribution bar.