feat: reduce mandatory agent context and install reference docs - #116
Merged
Merged
Conversation
vsem-azamat
added a commit
that referenced
this pull request
Sep 6, 2026
## Summary Prepare `@stdd/cli` and `@stdd/plugin` 0.11.0 in a release-only PR. - Align package/lock/plugin/runtime versions and regenerate all host stamps and manifest hashes with existing hook targets preserved. - Refresh README doctor proof and agent-context report version stamp; retain historical baseline and measurements. - No new runtime behavior in this PR. ## Included since 0.10.0 Merged changes cover intent-first instructions and consistent worktrees (#113), consequence-based reviews and persistent follow-up context (#114), consistent exhausted-budget guidance (#115), reduced mandatory context and installed reference documents (#116). ## Verification - Coordinator rerun `npm test`: 829 tests, 825 passed, 4 skipped, 0 failed. - `npm run check`: exit 0, existing 14 warnings / 1 info. - `npm run selfcheck`: OK; `git diff --check`: passed. - Independent read-only release review: no material blockers; version, manifest targets, runtime mirror and preserved measurement baseline checked. Review conducted outside the STDD review runner. - Implementer also exercised linux-x64 native workflow scenario, native prebuild checks and npm package dry runs for CLI/plugin. - Live model-backed contract harness not run; no publishing or consumer installation performed. Docs not applicable: release 0.11.0 version bump: generated stamps regenerated per CONTRIBUTING Releases, no behavior change ## Upgrade and release boundary After upgrading, consumers must re-run `stdd init` with their existing tools/hook flags to receive `.stdd/reference/`. This PR does not update any consumer project. Merge this preparation PR before tagging. A separately authorized `v0.11.0` tag on the merged commit triggers the repository release workflow for npm packages and GitHub Release. No tag or publication has been performed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
.stdd/reference/and rewrite paths at generated-render boundaries for consumer skills, method and plugin skills.Measured normal-path reading (UTF-8 bytes)
Cumulative start → implement → finish, deduplicated under the documented repository-profile assumptions:
See
docs/agent-context.mdandscripts/measure-agent-context.mjsfor pinned baseline, phase/incremental counts, conditional reads and reproduction. These are text-volume measurements, not token counts or evidence of model speed/cost improvements. Dynamic session-hook output and project-specific documents are excluded; plugin is not separately benchmarked.Verification
npm test— 829 tests, 825 passed, 4 skipped, 0 failed.npm run check: exit 0, 14 warnings and 1 informational diagnostic.npm run selfcheck:stdd check: OK.git diff --check: passed.Documentation evidence
Docs updated first: method/README.md, method/reference-commands.md, method/reference-generated-state.md, method/reference-integration.md, playbooks/finish-change.md, playbooks/implement.md
Upgrade and boundaries
Re-run
stdd initafter upgrading so existing consumers receive.stdd/reference/. Plugin adoption retains the existing init prerequisite; updating only a plugin against an old initialized checkout does not install the new references.Runtime gates, schema, verdicts, budget accounting and worker/native integrations are unchanged. No release, deployment or consumer installation performed.