{
  "meta": {
    "agent": "planner",
    "task_id": "249",
    "title": "Document skip-quality-gate directive and refine pre-validation in AGENTS.md",
    "created_at": "2026-04-02T12:00:00Z"
  },
  "inputs": [
    {
      "name": "issue-249",
      "type": "context",
      "ref": "https://github.com/AgentSDE/agent-core/issues/249",
      "notes": "Documentation gap for two shipped behaviors"
    },
    {
      "name": "AGENTS.md",
      "type": "file",
      "ref": "AGENTS.md",
      "notes": "Existing codebase knowledge base — target file for updates"
    },
    {
      "name": "PR #231",
      "type": "link",
      "ref": "https://github.com/AgentSDE/agent-core/pull/231",
      "notes": "skip-quality-gate directive implementation"
    },
    {
      "name": "PR #237",
      "type": "link",
      "ref": "https://github.com/AgentSDE/agent-core/pull/237",
      "notes": "refine pre-validation implementation"
    }
  ],
  "outputs": [
    {
      "name": "updated-agents-md",
      "type": "diff",
      "format": "md",
      "content": "Two new subsections added to AGENTS.md Directive System section"
    }
  ],
  "files": [
    {
      "path": "AGENTS.md",
      "action": "modify",
      "reason": "Add documentation for skip-quality-gate directive and refine pre-validation behavior"
    }
  ],
  "steps": [
    {
      "id": "S1",
      "summary": "Add skip-quality-gate and refine pre-validation documentation to AGENTS.md Directive System section",
      "acceptance": [
        "AGENTS.md documents skip-quality-gate directive: purpose (one-time bypass of pre-PR quality checks for deliver phase), usage, one-time consumption behavior, and guardrails against misuse",
        "AGENTS.md documents refine pre-validation: eligibility requirement (task must be gated), rejection error behavior for terminal and non-gated states, and specific remediation steps",
        "Remediation steps are specific: check task status, resolve underlying reason it is not gated, retry once gated",
        "Documentation integrated into existing Directive System section, not new top-level sections"
      ],
      "depends_on": []
    }
  ],
  "risks": [
    {
      "risk": "Documentation may drift from implementation if directive behavior changes",
      "mitigation": "Reference source files (directive.service.ts, phase-router.service.ts) so future changes can be cross-checked"
    }
  ],
  "assumptions": [
    "AGENTS.md Directive System section (starting ~line 36) is the appropriate location for both additions",
    "Bullet-point style with subsection headers matches existing AGENTS.md conventions"
  ],
  "open_questions": []
}