Skip to content

docs: fix stale references, add missing tools to configs and docs#6

Merged
e6qu merged 1 commit intodevfrom
docs/review-fixes
Mar 15, 2026
Merged

docs: fix stale references, add missing tools to configs and docs#6
e6qu merged 1 commit intodevfrom
docs/review-fixes

Conversation

@e6qu
Copy link
Copy Markdown
Owner

@e6qu e6qu commented Mar 15, 2026

Issue for this PR

Fixes 5 documentation issues found during review.

Type of change

  • Bug fix
  • New feature
  • Refactor / code improvement
  • Documentation

What does this PR do?

Fixes all issues found during comprehensive doc review:

  1. Missing tools in permission examples — Added classifier_threads and distill_threads to README global config example and .opencode/opencode.jsonc disable comments.

  2. Stale feature flag references — Removed all OPENCODE_EXPERIMENTAL_FOCUS_AGENT references from WHAT_WE_DID.md and DO_NEXT.md (flag was removed in v2, replaced by config-based control).

  3. Incomplete operation list in PLAN.md — Added mark to the operation list (was missing since lifecycle markers were added in v2).

  4. Stale post-turn focus hook in PLAN.md — Replaced the automatic post-turn hook section (never implemented in v2) with a note that focus is on-demand via /focus command.

  5. Missing sweeper documentation — Added deterministic sweeper explanation to docs/context-editing.md (how it works, when it runs, default turn counts).

  6. AGENTS.md incomplete — Added lifecycle markers (mark operation with hints), classifier_threads, and distill_threads to the context editing section.

  7. WHAT_WE_DID.md and DO_NEXT.md rewritten — Reflect the actual final state, not the phased plan.

How did you verify your code works?

Documentation-only change. All 1313 tests pass. Pre-commit hooks pass.

Checklist

  • I have tested my changes locally
  • I have not included unrelated changes in this PR

- Remove all OPENCODE_EXPERIMENTAL_FOCUS_AGENT references (flag removed in v2)
- Add classifier_threads and distill_threads to permission examples and config
- Add mark operation to PLAN.md operation list
- Replace stale post-turn focus hook section with on-demand note
- Add sweeper documentation to docs/context-editing.md
- Add lifecycle markers and classifier/distill tools to AGENTS.md
- Rewrite WHAT_WE_DID.md to reflect final state (no stale phase details)
- Update DO_NEXT.md with current status and remaining work
@e6qu e6qu merged commit b0422e4 into dev Mar 15, 2026
1 check passed
@e6qu e6qu deleted the docs/review-fixes branch March 15, 2026 21:50
e6qu added a commit that referenced this pull request Mar 18, 2026
- Remove all OPENCODE_EXPERIMENTAL_FOCUS_AGENT references (flag removed in v2)
- Add classifier_threads and distill_threads to permission examples and config
- Add mark operation to PLAN.md operation list
- Replace stale post-turn focus hook section with on-demand note
- Add sweeper documentation to docs/context-editing.md
- Add lifecycle markers and classifier/distill tools to AGENTS.md
- Rewrite WHAT_WE_DID.md to reflect final state (no stale phase details)
- Update DO_NEXT.md with current status and remaining work

Co-authored-by: Adrian Mârza <adi11235 at gmail dot 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