Skip to content

docs(#5138): context composition breakdown — PRD §5.6 + roadmap Phase-3#246

Open
Skobeltsyn wants to merge 1 commit into
mainfrom
docs/5138-context-breakdown
Open

docs(#5138): context composition breakdown — PRD §5.6 + roadmap Phase-3#246
Skobeltsyn wants to merge 1 commit into
mainfrom
docs/5138-context-breakdown

Conversation

@Skobeltsyn

Copy link
Copy Markdown
Contributor

Captures the Context Usage feature (Cursor-style per-category token accounting of the model window) in the PRD and the development plan, per request.

What lands

  • PRD §5.6 — new Context Composition Breakdown subsection, placed right after Budget Controls / Observability (its natural companion: budget caps the window, the breakdown shows what fills it). Includes the rendered example table, the category taxonomy (each slice → the framework construct that emitted it), the typed ContextBreakdown surface (agent.contextBreakdown(input) dry-run + PipelineEvent.ContextComposed live), and the rationale (cost/latency, caching, compaction, audit).
  • Roadmap Phase 3 — a planned [ ] dev-plan point alongside the observability foundation, cross-linking PRD §5.6, prompt-caching (#2655), and compaction.
  • Ticket #5138 — filed as the tracking item (planned; not yet scheduled to a release).

Framing

Positioned as the runtime companion to the permission manifest: the manifest says what can enter context (capability graph), the breakdown says what did, per turn, joinable to the manifest hash — on the boundaries-you-can-measure line. Docs-only; DocsConsistencyTest + InternalsAgentTest green.

🤖 Generated with Claude Code

…-3 point

Adds the planned 'Context Usage' feature (Cursor-style per-category token accounting of the model
window) to the PRD (§5.6, after Budget/Observability — the natural companion to budget) and the
development plan (roadmap Phase-3, alongside the observability foundation). Typed ContextBreakdown +
agent.contextBreakdown(input) dry-run + PipelineEvent.ContextComposed; category taxonomy mapped to
each framework construct; feeds prompt-caching (#2655) + compaction. Tracking: #5138 (planned).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant