{
  "id": "page:docs-harness-features-backlog-gaps-performance-gap-perf-005",
  "_kind": "Page",
  "_file": "wiki/docs/harness-features-backlog/gaps/performance/gap-perf-005.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/harness-features-backlog/gaps/performance/GAP-PERF-005.md",
    "sourceKind": "repo-docs",
    "title": "GAP-PERF-005: Cache-Aware Prompt Assembly",
    "displayName": "GAP-PERF-005: Cache-Aware Prompt Assembly",
    "slug": "docs/harness-features-backlog/gaps/performance/gap-perf-005",
    "articlePath": "wiki/docs/harness-features-backlog/gaps/performance/GAP-PERF-005.md",
    "article": "\n# GAP-PERF-005: Cache-Aware Prompt Assembly\n\n| Field | Value |\n|-------|-------|\n| Category | performance |\n| Priority | High |\n| Effort | L |\n| Status | Missing |\n\n## Description\nStructure prompt assembly so stable segments come first and volatile segments come last, maximizing cache prefix reuse across iterations.\n\n## Current State\nThe prompts module has PromptContext and per-harness context factories, but prompt sections are assembled without considering cache hit optimization. Phase-specific prompts change between iterations.\n\n## Target State\nPrompt sections tagged with volatility levels and sorted by stability. Stable segments (system identity, tool definitions) precede runtime segments (workspace context) which precede turn-local segments (current task). Cache-break detection identifies which stratum changed.\n\n## Dependencies\n- [GAP-PROMPT-001](../prompt-engineering/GAP-PROMPT-001.md) -- strata model for volatility tagging\n- [GAP-PERF-001](../performance/GAP-PERF-001.md) -- caching infrastructure to benefit from\n\n## Key Files\n| Component | Path |\n|-----------|------|\n| Prompts module | `packages/sdk/src/prompts/` |\n| Instructions CLI | `packages/sdk/src/cli/` |\n\n## Recommendation\nPhase 2 implementation. Tag prompt sections with volatility levels and sort by stability during composition.\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-harness-features-backlog",
      "to": "page:docs-harness-features-backlog-gaps-performance-gap-perf-005",
      "kind": "contains_page"
    }
  ]
}