Skip to content

docs(skills): add project-level upstream-rotation skill - #307

Merged
Gaubee merged 1 commit into
mainfrom
docs/skill-upstream-rotation
Oct 16, 2026
Merged

Gaubee merged 1 commit into
mainfrom
docs/skill-upstream-rotation

Conversation

@Gaubee

@Gaubee Gaubee commented Oct 16, 2026

Copy link
Copy Markdown
Contributor

Adds .agents/skills/upstream-rotation/ — the OpenSpec CLI upgrade-following workflow distilled from the 1.13.2 (13.0.2) and 1.14.2 (14.0.2) rotations.

  • SKILL.md (156 lines): six gated phases P0-P6 (detect/triage → env → evidence report → change + dual-channel remix review → slice implementation + vision walkthrough → gates/PR → release/cleanup), plus a 10-row iron-rules table where every rule carries the incident that paid for it.
  • references/ (4 files, on-demand): investigation (triage commands, mirror-surface table, report format), review-remix (herdr startup, Codex provider-sandbox probing incl. the inline-material mode, dual-channel convergence, round protocol), implementation (slice topology, subagent brief template, vitest v4 gate traps, whole-repo version-literal audit list, ego-browser walkthrough recipe), delivery (gates, anti-fake-merge, CI flake triage, four-fold release evidence, cleanup audit, visual-acceptance waiver criteria).

Quality: independent subagent review scored 9/10 — one blocker (a lexicographic ls | tail -1 silently pointing at the v9-era report template — ironically violating the skill's own rule 10) plus seven non-blocking suggestions, all folded before this commit. Docs-only; no code paths touched.

Encodes the OpenSpec CLI upgrade-following workflow distilled from the
1.13.2 (13.0.2) and 1.14.2 (14.0.2) rotations into six gated phases
(P0 detect/triage -> P6 release/cleanup) with four on-demand references
(investigation, review-remix, implementation, delivery). The iron-rules
table carries the tuition behind each rule (version-literal whole-repo
audit, glob-escape, vitest v4 filter traps, mergedAt verification, CI
zero-change-rerun triage, per-package npm propagation, gitlink regression
check, Codex provider sandbox modes).

Review: independent subagent audit 9/10 — the one blocker (lexicographic
ls tail -1 silently pointing at the v9-era report template) and seven
non-blocking suggestions folded before commit.
@Gaubee
Gaubee merged commit e4894a4 into main Oct 16, 2026
6 checks passed
@Gaubee
Gaubee deleted the docs/skill-upstream-rotation branch October 16, 2026 16:03
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