agentprism-workflows: Instructions file for Codex

Repository Agent Instructions

These instructions apply across this repository. A nested AGENTS.md may add package-specific guidance, but it does not override the root monorepo, delivery, or release rules.

Start here

Before changing code, read the relevant parts of:

• CONTRIBUTING.md — development, tests, generated artifacts, dependency gates, attribution, PRs, and releases.
• README.md — product surface and package map.
• docs/api.md — supported integration APIs.
• docs/authoring/ — canonical workflow authoring documentation shipped through MCP.

Then read the code. The source and its tests are the current state; prose describes it and never governs it. When prose and code disagree, fix the prose.

docs/archive/ holds historical design records from past implementation trains. They are not maintained, not an authority, and may be wrong. Do not read them unless the user points you at one.

Existing implementations are not the design authority

Design from first principles for the user's request. The current code, its tests, and its docs describe what exists, not what must remain. Changing existing architecture, contracts, and the tests that enshrine them is expected whenever it produces a better outcome.

• Read the code, not a description of it, before proposing a design.
• Never treat a document, a test, or an existing structure as a reason to reject or contort a better design. The only fixed constraints are the user's request, the package dependency direction below, the compatibility policy below, and published SDK and wire surfaces, which need an explicit scope decision to change.
• When you change something that was previously documented or tested as a contract, say so plainly in the plan and the PR: what changed, why, and what was migrated. Land the migration, tests, and docs in the same change.
• Nothing in this repository is "frozen". A task that says "implement this document" still requires you to check it against the code and first principles, and to raise problems rather than build them.