Artifact 4ac7acccb2844759b752906f43acc30a6e9cd596ba1a73ead98d83cf9eb167cc:
- File AGENTS.md — part of check-in [255e105745] at 2026-07-07 15:28:24 on branch trunk — Make project-pack and harness onboarding explicit (user: dmestas, size: 3886) [annotate] [blame] [check-ins using]
RFC Workflow Agent Entry
Use this repo as a neutral workflow pack, not as a harness-specific runner.
Load order
- Read
workflow.contract.yamlfirst. It is the canonical source for stage order, gates, outputs, role visibility, and the public/evidence split. - Read the neutral workflow docs under
core/in this order:core/controller.mdcore/source-authority.mdcore/deliverables.mdcore/style-and-provenance.mdcore/validation-gates.mdcore/context-engineering.md
- Read any reusable role briefs under
briefs/, toolchain guidance undertoolchains/, and templates needed for the active stage. - Select exactly one project pack under
projects/and read that pack'sREADME.mdplus its suite, corpus, references, metadata, document briefs, and examples. - Run
prompts/translate-workflow-for-harness.mdto map the neutral contract into the active harness's own primitives. - Run
prompts/run-selected-project.mdto execute the selected project pack.
Non-negotiable operating rules
- Do not reinterpret workflow semantics during translation. Map names and mechanics into native primitives; preserve the contract.
- Do not draft public RFC prose from memory, orientation notes, or project summaries alone.
- Do not admit public technical or normative claims without accepted evidence according to the workflow contract and source-authority rules.
- Keep public deliverables separate from evidence artifacts.
- Keep provenance, prompts, agent names, tool transcripts, and internal IDs out of public RFC text.
- Keep
core/reusable. Put source-specific material only in the selected project pack.
Harness expectation
A compatible harness should be able to:
- load repo files as instructions,
- allocate native execution units for the contract's roles and stages,
- enforce or emulate stage gates and recursive correction,
- and keep run-local output outside the reusable repo surface.
Harness translation checklist
Before running prompts/translate-workflow-for-harness.md, write down the active harness answers to all of the following:
- Controller primitive — what native unit acts as the run controller, owns stage order, and decides whether the run advances or recurses.
- Stage execution primitive — how one workflow stage becomes runnable work in this harness (task, job, worker, agent, prompt, pipeline step, or equivalent).
- Role/lane + visibility mapping — how contract roles, review lanes, and visibility boundaries map onto native execution units or permissions so the harness does not collapse distinct responsibilities together.
- Gate/checkpoint mechanism — how the harness blocks advancement until the required artifacts, reviews, or approvals for a stage exist.
- Recursive correction mechanism — how a failed review or clean-room check routes work back to the earliest faulty artifact/stage instead of patching only the latest draft.
- Evidence workspace — where internal evidence artifacts live during the run: claim ledgers, notes, review packets, matrices, validation captures, and other non-public outputs.
- Public-output workspace — where public drafts and final publishable outputs live, separate from the evidence workspace.
- Escalation path — how blocked workers raise questions or failures to the controller/operator, and how those decisions return to the blocked stage.
- Repo-file instruction loading — exactly how the harness loads repo files as instructions (ordered file bundle, prompt attachments, injected text, staged context, or similar) so
workflow.contract.yaml,core/, reusable materials, and the selected project pack remain authoritative inputs.
If any item above is still vague, stop and resolve it before translation. The translation prompt should receive concrete answers, not placeholders.