Conversation
Regenerate the three community submission locks with Copilot CLI 1.0.80 and the compiler defaults. Preserve submission instructions and file allowlists, and cover runtime compatibility and output guards. Assisted-by: GitHub Copilot (model: GPT-6 Astra, autonomous) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…ithub#4609) Document authoritative ownership, versioned sharing, bilateral verification, and compatible evolution across component boundaries. Add self-contained checkout and control-plane examples and link the guide from the documentation site. Assisted-by: GitHub Copilot (model: gpt-6-astra, autonomous) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
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
2 participants
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.
Description
Fixes github#4609.
Add a self-contained Contract-Driven Development guide and link it from the SDD overview, monorepo guide, and documentation navigation.
The guide starts with interacting components and their externally observable obligations, not repository coordination. It covers defining missing contracts, one authoritative owner with consumer participation, direct references within a repository, pinned artifacts or synchronized copies across repositories, verification on both sides, and deliberate compatible evolution.
Includes standalone website/orders/inventory and control-plane/data-plane/integration-tests examples. No new CLI commands, core template changes, mandatory umbrella repository, dependency resolver, or release orchestrator.
Context and credit
Testing
uv run specify --helpuv sync && uv run pytestThe CLI and sample-project checks above are not applicable to this documentation-only change; the Python suite was not run.
Passed on this branch:
npx --no-install markdownlint-cli2 docs/guides/contract-driven-development.md docs/guides/monorepo.md docs/concepts/sdd.mdgit diff --check upstream/main...HEADA full DocFX build and rendered-site visual inspection were not performed.
AI Disclosure
AI disclosure: GitHub Copilot using GPT-6 Astra (model ID:
gpt-6-astra) drafted, revised, reviewed, checked, and committed this documentation on behalf of @mnriem in the source interactive session. The user supplied the architectural direction and requested refinements; the documentation edits and checks were performed autonomously by the agent, without a claim of line-by-line human review. In this follow-up session, the same agent/model transferred the existing documentation commit unchanged onto current upstreammain, reran focused documentation checks, pushed the branch, and prepared this submission at the user's request. Reasoning-effort configuration is not exposed to the agent. AI involvement is documentation and PR-text generation only, not production code changes.