{
  "schema": "vedokrok.public-item.v1",
  "release_id": "MHC-RPUB-20260920-75ad787a",
  "url": "/knowledge/use-versioned-artifacts-as-the-meeting-place-for-humans-and-agents",
  "id": "MHC-D-RESEARCH-0723",
  "version": "0.1.0",
  "title": "Use versioned artifacts as the meeting place for humans and agents",
  "summary": "Shared chat is a poor substitute for shared state.",
  "kind": "principle",
  "body": "Coordinate through artifacts that can be inspected and versioned: pull requests, issues, decision records, test results or change sets. Let agents post work where humans and other agents can review it asynchronously. Keep the artifact self-contained enough that a reviewer does not need the originating chat to understand the change, rationale and checks.",
  "limits": [
    "Not every task belongs in Git; choose an equivalent versioned or auditable artifact for documents, data or operations."
  ],
  "topics": [
    "union-ai-eval-learning-workflow"
  ],
  "intents": [],
  "source_ids": [
    "RS-3DB1894302E64FC3"
  ],
  "evidence": [
    {
      "claim": "AI Engineer harness guidance presents pull requests as an asynchronous shared interface where human and agent contributors can review and coordinate without sharing one live conversation.",
      "source_id": "RS-3DB1894302E64FC3",
      "role": "supports",
      "note": "This pattern fits version-controlled work; other domains may need a different shared artifact.",
      "locator": "GitHub pull requests as broadcast domain"
    }
  ],
  "use_when": [
    "Humans and several agents need to coordinate work without staying in one synchronous conversation."
  ],
  "avoid_when": [
    "Not every task belongs in Git; choose an equivalent versioned or auditable artifact for documents, data or operations."
  ],
  "example": "An agent opens a pull request with the diff, test evidence and remaining risk; a second agent or human reviews that artifact rather than joining the first agent's context.",
  "check": "A new reviewer can take useful action from the shared artifact alone.",
  "sources": [
    {
      "id": "RS-3DB1894302E64FC3",
      "title": "Harness Engineering: How to Build Software When Humans Steer, Agents Execute",
      "url": "https://ai.engineer/talks/am_oeAoUhew-harness-engineering"
    }
  ],
  "relations": [
    {
      "from": "MHC-D-RESEARCH-0723",
      "to": "MHC-D-RESEARCH-0954",
      "type": "useful_with",
      "url": "/knowledge/let-subagents-write-durable-artifacts-instead-of-relaying-everything-through-the-coordinator"
    }
  ],
  "collections": [
    {
      "id": "RC-ABC17A288CB87C85",
      "title": "Make AI work improve from failures instead of accumulating rituals",
      "url": "/collections/make-ai-work-improve-from-failures-instead-of-accumulating-rituals"
    }
  ]
}