docs(plan-rollout): SYSTEM.md schema spec (focused slice of #1192)#1417
Closed
mastermanas805 wants to merge 1 commit into
Closed
docs(plan-rollout): SYSTEM.md schema spec (focused slice of #1192)#1417mastermanas805 wants to merge 1 commit into
mastermanas805 wants to merge 1 commit into
Conversation
Schema spec for the SYSTEM.md primitive — human-declared role contracts between components, distinct from the package/import graph (which is discovered at runtime). This PR is doc-only: 214 lines, no code, no tests, no dependencies. Library code (parser, reconciler, scaffolder) and consuming skills follow in subsequent PRs gated on the primitive landing first. Refs: garrytan#1192 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
mastermanas805
force-pushed
the
feat/plan-rollout-foundation
branch
from
26d605b to
d007682
Compare
mastermanas805
changed the title
Author
|
Closing. On reflection, doc-only is the wrong shape — a format spec with no consumer is just literature, and the original deferral on #1192 still stands. Will only revisit with a shipping artifact. |
6 tasks
mastermanas805
added a commit
to mastermanas805/gstack
that referenced
this pull request
May 11, 2026
Match the SCREAMING_SNAKE_CASE convention used by other topic docs in docs/ (ADDING_A_HOST.md, OPENCLAW.md, REMOTE_BROWSER_ACCESS.md, ON_THE_LOC_CONTROVERSY.md). The hyphenated form was carried over from closed PR garrytan#1417 and matched no existing convention in this directory. No content changes — pure rename. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Author
|
Superseded by #1424. That PR ships the schema together with its consumer ( |
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.
Doc-only slice of #1192. 215 lines, single file (
docs/SYSTEM-MD.md). Draft.The primitive: SYSTEM.md is human-declared role contracts between components — what each one is, what it owns, and what breaks if a contract changes (auth mints session tokens; middleware enforces; format change without coordinated deploy breaks the contract). Distinct from the package/import graph, which is discovered at runtime.
What this PR is: the schema spec only. No code, no tests, no dependency changes.
What it isn't: the parser, reconciler, scaffolder, and consuming skills (
/plan-rollout,/spill-check) all live downstream of this. They land in follow-up PRs only if the primitive itself fits gstack.If the shape's wrong:
git rm docs/SYSTEM-MD.mdis the entire revert.Refs #1192