← Về thư mục
📄 / / academic-research-skills / shared / contracts / README.md

ARS Shared Contracts

Schema files for cross-skill contracts: reviewer sprint contracts, Material Passport ports, and (v3.6.7+) cross-model audit artifact pipelines.

Sprint contracts (v3.6.2+)

Sprint contract templates for reviewer hard-gate orchestration.

Schema: shared/sprint_contract.schema.json (Schema 13). Validator: scripts/check_sprint_contract.py. Spec: docs/design/2026-04-23-ars-v3.6.2-sprint-contract-design.md. Protocol: academic-paper-reviewer/references/sprint_contract_protocol.md.

Shipped templates

v3.6.2 (reviewer family):

v3.6.6 / suite v3.6.8 (generator-evaluator family):

Both writer + evaluator templates ship under Schema 13.1 (allOf branches 11/12 require pre_commitment_artifacts for writer_full and disagreement_handling for evaluator_full; branches 5/6 pin failure_conditions[].action to mode-specific enums; branches 8/9 pin F0 contains to the mode's accept variant). Orchestration block lives in academic-paper/SKILL.md § "v3.6.6 Generator-Evaluator Contract Protocol" + the writer/evaluator agent files.

Reserved reviewer modes without shipped templates

reviewer_re_review, reviewer_calibration, reviewer_guided are in the schema enum but ship without templates in v3.6.2. Those modes continue to operate in their existing form (no contract, no hard-gate) until a follow-up patch release adds their templates.

How to add a new template

  1. Add the file under shared/contracts/<domain>/<mode>.json.
  2. Run python scripts/check_sprint_contract.py <path> --ars-version vX.Y.Z; expect zero errors and zero soft warnings.
  3. If expression strings use new phrasing, update sprint_contract_protocol.md and the synthesizer prompt's recognised-pattern list in the same PR.

Passport contracts (v3.6.4+)

Schemas for Material Passport input ports.

Audit artifact contracts (v3.6.7 Step 6)

The audit/ directory carries the three wrapper-emitted artifact schemas that pair with the passport-side audit_artifact_entry.schema.json above. Together they form the four-schema contract that scripts/run_codex_audit.sh (Phase 6.1) writes and the orchestrator agent reads at every per-agent audit gate.

Spec: docs/design/2026-04-30-ars-v3.6.7-step-6-orchestrator-hooks-spec.md §3.