agentic-resources/session_memory/catalog/sp-problem-file_not_read-edit.json

{
  "covers": [
    "file has not been read",
    "modified since read",
    "file_not_read"
  ],
  "created_at": "2026-06-07T13:26:25Z",
  "distribution_ready": true,
  "id": "sp-problem-file_not_read-edit",
  "name": "Read before you Edit",
  "polarity": "problem",
  "problem": "Agents call Edit/Write on a file they have not read in the current session, or after it changed under them. The edit tools reject this ('File has not been read yet' / 'File has been modified since read'), and the retry burns a turn. Top recurring error in the corpus (12/27 sessions, 8 repos).",
  "provenance": {
    "detected_at": null,
    "evidence": {
      "frequency": 32,
      "origin": "AGENTIC-WP-0006 error mining / ASSESSMENT-infra-friction.md",
      "polarity": "problem",
      "repos": 8,
      "sessions": 12
    },
    "promoted_at": null,
    "source_key": "problem:file_not_read:edit"
  },
  "rendering_hints": {
    "claude": {
      "target": "CLAUDE.md"
    },
    "codex": {
      "target": "AGENTS.md"
    },
    "grok": {
      "target": ".grok/instructions.md"
    }
  },
  "resolutions": [
    {
      "detail": "Never blind-write a file you haven't read this session.",
      "steps": [
        "Read the target file",
        "Then Edit/Write"
      ],
      "summary": "Read the file (or the region you'll touch) before Edit/Write"
    },
    {
      "detail": "A stale read means the file changed under you; refresh, don't loop.",
      "steps": [
        "Re-Read the file",
        "Re-apply the Edit"
      ],
      "summary": "On 'modified since read', re-Read then re-Edit"
    }
  ],
  "schema_version": 1,
  "scope": {
    "domains": [],
    "flavors": [],
    "repos": []
  },
  "status": "approved",
  "updated_at": "2026-06-07T19:06:45Z",
  "version": "1.0.1"
}