docs(context): write advanced context strategy selection guide and benchmark results #8933

Open
opened 2026-04-14 04:04:18 +00:00 by HAL9000 · 1 comment
Owner

Background and Context

Epic #5172 (Advanced Context Strategies — Beyond Basic ACMS Pipeline) has implemented the adaptive context strategy selector (#5255) and semantic context search using embeddings (#5254). The final deliverable for this Epic is documentation that helps users understand which context strategy to choose for their use case, along with benchmark results that demonstrate the performance characteristics of each strategy.

Without documentation, users cannot make informed decisions about context strategy selection. The benchmark results also provide a baseline for future performance regression detection.

This issue blocks Epic #5172.

Acceptance Criteria

  • docs/reference/context-strategies.md is created with a strategy selection guide
  • Each strategy section covers: description, use case, configuration, and performance characteristics
  • A decision matrix is included to help users choose the right strategy
  • Benchmark results are included showing token efficiency and latency for each strategy on representative tasks
  • Documentation is linked from the main ACMS reference page
  • Documentation is reviewed and approved by a maintainer

Subtasks

  • Write strategy overview section (sliding window, semantic chunking, priority-based, recency-weighted, adaptive)
  • Write per-strategy sections with use case guidance and configuration examples
  • Create decision matrix (task type → recommended strategy)
  • Run benchmarks on representative tasks and document results
  • Write docs/reference/context-strategies.md
  • Link from docs/reference/acms.md to the new strategy guide

Definition of Done

  • All acceptance criteria met
  • Tests written and passing (coverage >= 97%)
  • Code reviewed and approved
  • Documentation updated if needed
  • No regressions introduced

Metadata

  • Commit message: docs(context): write advanced context strategy selection guide and benchmark results
  • Branch name: docs/context-strategy-selection-guide

Automated by CleverAgents Bot
Agent: new-issue-creator

## Background and Context Epic #5172 (Advanced Context Strategies — Beyond Basic ACMS Pipeline) has implemented the adaptive context strategy selector (#5255) and semantic context search using embeddings (#5254). The final deliverable for this Epic is documentation that helps users understand which context strategy to choose for their use case, along with benchmark results that demonstrate the performance characteristics of each strategy. Without documentation, users cannot make informed decisions about context strategy selection. The benchmark results also provide a baseline for future performance regression detection. This issue blocks Epic #5172. ## Acceptance Criteria - [ ] `docs/reference/context-strategies.md` is created with a strategy selection guide - [ ] Each strategy section covers: description, use case, configuration, and performance characteristics - [ ] A decision matrix is included to help users choose the right strategy - [ ] Benchmark results are included showing token efficiency and latency for each strategy on representative tasks - [ ] Documentation is linked from the main ACMS reference page - [ ] Documentation is reviewed and approved by a maintainer ## Subtasks - [ ] Write strategy overview section (sliding window, semantic chunking, priority-based, recency-weighted, adaptive) - [ ] Write per-strategy sections with use case guidance and configuration examples - [ ] Create decision matrix (task type → recommended strategy) - [ ] Run benchmarks on representative tasks and document results - [ ] Write `docs/reference/context-strategies.md` - [ ] Link from `docs/reference/acms.md` to the new strategy guide ## Definition of Done - [ ] All acceptance criteria met - [ ] Tests written and passing (coverage >= 97%) - [ ] Code reviewed and approved - [ ] Documentation updated if needed - [ ] No regressions introduced ## Metadata - **Commit message:** `docs(context): write advanced context strategy selection guide and benchmark results` - **Branch name:** `docs/context-strategy-selection-guide` --- **Automated by CleverAgents Bot** Agent: new-issue-creator
HAL9000 added this to the v3.6.0 milestone 2026-04-14 04:06:40 +00:00
Author
Owner

Triage Decision [AUTO-OWNR-2]

Verified

Advanced context strategy selection guide is part of the v3.6.0 advanced concepts milestone scope: 'Advanced context strategies (beyond basic ACMS pipeline)'.

  • Type: Documentation
  • MoSCoW: Should Have — advanced context documentation
  • Priority: Medium
  • Milestone: v3.6.0

Automated by CleverAgents Bot
Supervisor: Project Owner Pool | Agent: project-owner-pool-supervisor

## Triage Decision [AUTO-OWNR-2] **Verified** ✅ Advanced context strategy selection guide is part of the v3.6.0 advanced concepts milestone scope: 'Advanced context strategies (beyond basic ACMS pipeline)'. - **Type:** Documentation - **MoSCoW:** Should Have — advanced context documentation - **Priority:** Medium - **Milestone:** v3.6.0 --- **Automated by CleverAgents Bot** Supervisor: Project Owner Pool | Agent: project-owner-pool-supervisor
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
cleveragents/cleveragents-core#8933
No description provided.