Skip to content

docs: clarify ADC constraints for 0.2.0 - #5

Merged
dbrattli merged 2 commits into
mainfrom
agent/clarify-quickstart-constraints
Aug 12, 2026
Merged

docs: clarify ADC constraints for 0.2.0#5
dbrattli merged 2 commits into
mainfrom
agent/clarify-quickstart-constraints

Conversation

@dbrattli

@dbrattli dbrattli commented Aug 12, 2026

Copy link
Copy Markdown
Owner

Summary

  • Condense the quickstart guidance into a short active-constraints policy.
  • Require explicit justification when changing an invariant:.
  • Keep the directive-by-directive rules in the existing-comments section as the single source of truth.
  • Bump the specification version from 0.1.1 to 0.2.0.

Motivation

The previous quickstart language was vague, while copying the detailed rules there would duplicate the canonical guidance. This gives adopters the core idea without maintaining the same policy in two places.

Versioning impact

Minor release. The change adds compatible guidance without changing existing directive semantics, consistent with the specification's Semantic Versioning policy.

Validation

  • npx --yes markdownlint-cli2@0.23.2 --config .markdownlint.jsonc "**/*.md"
  • git diff --check

@dbrattli
dbrattli marked this pull request as ready for review August 12, 2026 05:36
@dbrattli dbrattli changed the title docs: clarify ADC quickstart constraints docs: clarify ADC constraints for 0.2.0 Aug 12, 2026
@dbrattli
dbrattli marked this pull request as draft August 12, 2026 05:43
@dbrattli
dbrattli marked this pull request as ready for review August 12, 2026 05:44
@dbrattli
dbrattli merged commit bd86092 into main Aug 12, 2026
2 checks passed
@dbrattli
dbrattli deleted the agent/clarify-quickstart-constraints branch August 12, 2026 05:44
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