openspec-git-discipline
/openspec-git-discipline
Use when running OpenSpec propose, continue, apply, verify, archive, or worktree workflows where proposal artifacts, branches, merges, or archive timing affect git history.
- Author
- tommy-ca ↗
- Repository
- pstack ↗
- Licence
- MIT
- Last repository change
- 10.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 10.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Use when running OpenSpec propose, continue, apply, verify, archive, or worktree workflows where proposal artifacts, branches, merges, or archive timing affect git history.
Original author description
Use when running OpenSpec propose, continue, apply, verify, archive, or worktree workflows where proposal artifacts, branches, merges, or archive timing affect git history.
How it works
- Core Rule
- Gates
- Required Checks
- Red Flags
SKILL.md preview
--- name: openspec-git-discipline description: Use when running OpenSpec propose, continue, apply, verify, archive, or worktree workflows where proposal artifacts, branches, merges, or archive timing affect git history. license: MIT compatibility: Requires git and OpenSpec workflow artifacts. --- # OpenSpec Git Discipline ## Core Rule Every OpenSpec state change must cross `main` before the next lifecycle phase depends on it. - Propose/continue artifacts may be drafted on a branch, but must be committed and merged to `main` before apply starts. - Apply may run on `main`, a branch, or a worktree only if that exact proposal change is already available on `main`. - Archive may run only from `main` after implementation is merged back. Never create commits, branches, or merges unless the user explicitly asks. ## Gates | Moment | Gate | | --- | --- | | Before propose | Prefer `main`; if not, warn and ask whether to continue intentionally. | | During continue | Before creating the next artifact, ask the user to commit completed artifact changes or explicitly continue without that checkpoint. | | After propose | Ask the user to commit proposal artifacts; offer to create a PR branch for review. | | Before apply | Confirm the proposal change is committed on `main`; then apply may run from `main`, a branch, or a worktree. | | Before archive | Stop unless implementation is merged back to `main` and archive is running from `main`. | | After archive | Ask the user to commit archive/spec sync changes. | ## Required Checks Before apply: 1. Run `git status --short`. 2. Verify `openspec/changes/<change>/` has no uncommitted proposal files. 3. Verify the proposal change exists on `main` before applying from any branch/worktree. Use this language if the proposal has not reached `main`: > I should not apply this yet because the proposal change has not reached `main`. A proposal can be drafted on a branch, but apply must start only after that proposal state is available on `main`. Please merge or commit the proposal to `main` first, then I can apply from `main`, a branch, or a worktree. Before archive: 1. Run `git branch --show-current` and `git status --short`. 2. Stop if not on `main`. 3. Stop if implementation work has not been merged back to `main`. Use this language: > I should not archive this yet because archive must run from `main` after implementation is merged back. Verify makes a change eligible to merge; it does not replace the merge. ## Red Flags - Applying a proposal that exists only on the current branch/worktree. - Treating worktree visibility as proof that the proposal reached `main`. - Creating the next continue artifact without asking about committing the previous one. - Archiving from a feature branch or before implementation is merged to `main`. - Auto-committing, branching, or merging without explicit user approval. All of these mean: pause, explain the boundary, and ask the user to make the git state explicit.
Versions
The database has no other skills named openspec-git-discipline.
Database snapshot: 13.11.2026 · package version a3d4359d6f16 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100openspec-bulk-archive-change
Archive multiple completed OpenSpec changes at once. Use when archiving several parallel changes. Also use for a plural archive request - "openspec bulk-archive", "opsx bulk-archive", "openspec archive all", or "openspec archive these changes". - 96openspec-archive-change
Archive a completed OpenSpec change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete. Also use when the user says "openspec archive" or "opsx archive". - 100openspec-bulk-archive-change
Archive multiple completed OpenSpec changes at once. Use when archiving several parallel changes. Also use for a plural archive request - "openspec bulk-archive", "opsx bulk-archive", "openspec archive all", or "openspec archive these changes". - 96openspec-archive-change
Archive a completed OpenSpec change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete. Also use when the user says "openspec archive" or "opsx archive". - 96openspec-archive-change
Archive a completed OpenSpec change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete. Also use when the user says "openspec archive" or "opsx archive". - 96openspec-archive-change
Archive a completed OpenSpec change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete. Also use when the user says "openspec archive" or "opsx archive".