Skip to content

feat: intent-first instructions and consistent worktree placement - #113

Merged
vsem-azamat merged 2 commits into
mainfrom
improve/intent-first-spec
Sep 5, 2026
Merged

vsem-azamat merged 2 commits into
mainfrom
improve/intent-first-spec

Conversation

@vsem-azamat

Copy link
Copy Markdown
Owner

Summary

  • Specify observable outcomes, constraints, acceptance evidence, and scope rather than prescribing internal names and implementation details.
  • Keep governing architecture and committed handoff interfaces explicit; leave routine implementation choices to the executor.
  • Clarify that compliant internal implementation choices are not unrequested extras in review.
  • Default new worktrees to <primary-checkout>/.worktrees/<task>, with explicit user/project placement policy taking precedence over native host defaults. Preserve existing isolation and require authorization before cleanup.
  • Regenerate repository skills and plugin distributions and add focused regression checks.

Docs updated first: method/README.md, playbooks/planning.md, playbooks/implement.md, playbooks/delegate-slice.md, playbooks/worktrees.md

Verification

  • Final local full suite: 812 tests, 808 passed, 4 skipped, 0 failed (stdd verify -- npm test).
  • npm run check: exit 0, with warnings.
  • npm run selfcheck and git diff --check: passed.
  • Independent fresh-context Claude Code review, followed by a targeted re-review of the final worktree-policy corrections: no remaining material findings. This was an external coordinator review, not a recorded stdd review verdict.

Limits and scope

  • This is instruction-contract improvement, not a demonstrated agent-speed or token-cost improvement. Touched canonical prose is 57,849 UTF-8 bytes versus 57,896 before; the reduction is negligible.
  • Regression tests check generated instruction content and packaging, not real agent behavior.
  • No changes to review verdict/gate/budget mechanics, native filesystem, integration runners, or worker runtime.
  • No release, consumer-project installation, or merge is included.

@vsem-azamat
vsem-azamat merged commit b4b6fec into main Sep 5, 2026
13 checks passed
@vsem-azamat
vsem-azamat deleted the improve/intent-first-spec branch September 5, 2026 08:47
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.
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