Skip to content

[8/8] Add optional context maintenance tooling - #14969

Draft
JanProvaznik wants to merge 1 commit into
janprovaznik/context-07-healthfrom
janprovaznik/context-08-maintenance
Draft

JanProvaznik wants to merge 1 commit into
janprovaznik/context-07-healthfrom
janprovaznik/context-08-maintenance

Conversation

@JanProvaznik

@JanProvaznik JanProvaznik commented Sep 7, 2026

Copy link
Copy Markdown
Member

Part 8 of 8

Introduce the shared routing guide, context-maintenance skill, task briefs and structural checker only after the guidance chapters. Size targets remain opt-in, not default contribution limits.

Depends on #14968. Last chapter. Full index: #14961.

This PR is based on janprovaznik/context-07-health. Files changed shows only this chapter. Review bottom-up; after the preceding chapter lands, retarget this PR to main before merging. Do not merge later chapters into temporary stack-base branches.

Scope and evidence

The complete tree matches the prepared final content exactly. Structural validation and the offline collector suite pass. The checker does not enforce optional size targets by default.

Agentic-workflow changes remain separate. This stack does not include personal plugin overrides, plugin auto-activation changes, or SDK/feed version changes. The public descriptions use public repository evidence, not internal discussions or proprietary source.

What the context numbers do and do not show

Git-blob bytes against the stack baseline:

Surface Before Complete stack
AGENTS.md, with orientation restored 10,554 8,259
Expert-reviewer entry 32,677 4,658
Skill entry points 198,073 (18) 48,348 (20)
Context Markdown including references 287,121 339,889

The full corpus grows 18.4%. The measurable change is 75.6% less text in skill entry bodies and conditional retrieval of detailed references, not deletion of all that material. If every reference is loaded, the loading advantage disappears. No controlled token-cost, latency, or task-quality improvement has been established.

Introduce the shared routing guide, context-maintenance skill, task briefs and structural checker only after the guidance chapters. Size targets remain opt-in, not default contribution limits.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 5e665c32-8412-4c24-bf55-55680480d04d
@github-actions

github-actions Bot commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

🔍 Skill Validator Results

⚠️ Warnings or advisories found

Scope Checked
Skills 1
Agents 0
Total 1
Severity Count
--- ---:
❌ Errors 0
⚠️ Warnings 1
ℹ️ Advisories 0

Summary

Level Finding
ℹ️ Found 1 skill(s)
ℹ️ [maintaining-agent-context] 📊 maintaining-agent-context: 411 BPE tokens [chars/4: 597] (detailed ✓), 4 sections, 0 code blocks
ℹ️ [maintaining-agent-context] ⚠ No code blocks — agents perform better with concrete snippets and commands.
ℹ️ ✅ All checks passed (1 skill(s))
Full validator output ```text Found 1 skill(s) [maintaining-agent-context] 📊 maintaining-agent-context: 411 BPE tokens [chars/4: 597] (detailed ✓), 4 sections, 0 code blocks [maintaining-agent-context] ⚠ No code blocks — agents perform better with concrete snippets and commands. ✅ All checks passed (1 skill(s)) ```

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