feat: migrate repo releases to manual release-please#293
Merged
Conversation
- Add Quick Start and Directory Layout sections to root AGENTS.md - Fold "When to Add a Provider" into the checklist preamble - Expand Repository Docs Convention to cover all docs/ subdirectories - Add "Adding Components" section to plugin AGENTS.md - Slim beta skills section to a summary with doc pointer - Reduce both CLAUDE.md files to @AGENTS.md import pointers
This was referenced Mar 18, 2026
Closed
Closed
Merged
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
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.
Problem
Today the repo has one automated release path for the npm CLI, but the real release story is split across CI, manual maintainer workflows, stale docs, and multiple version surfaces.
That creates a few concrete problems:
mainis too close to a release, which makes batching awkwardrelease-docsWhat This PR Solves
This PR moves the repo to a manual
release-pleasemodel with one standing release PR for the whole repo.After this lands:
mainwithout immediately publishing anythingcli,compound-engineering,coding-tutor, andmarketplaceCHANGELOG.mdremains the one canonical changelogResulting Release Process
The intended workflow after merge is:
main.Release PRworkflow updates one standing release PR for the repo.Release Previewworkflow to inspect what would release.clicomponent is part of that release.Example Scenarios
1. One merge lands, but we do not want to release yet
fix:PR merges tomain2. More work lands before the release is cut
feat:PR merges tomain3. A plugin-only change ships without dragging unrelated components
plugins/coding-tutor/**coding-tutorshould bumpcompound-engineering,marketplace, andclistay untouchedcliis also part of that release4. Marketplace changes stay marketplace-scoped
marketplacebumps5. An exceptional bump is needed
What Changed
release-pleaseconfig and manifest forcli,compound-engineering,coding-tutor, andmarketplacemainand a manual release preview workflowrelease-pleaseworkflow path instead of publishing on every merge.releaserc.jsonand.claude/commands/release-docs.mdCHANGELOG.mdsrc/release/andscripts/release/AGENTS.mdcanonical and reduce rootCLAUDE.mdto a compatibility shimAGENTS.mdwithCLAUDE.mdfallbackVerification
bun testbun run release:validatebun run release:preview --title 'fix: adjust ce:plan-beta wording' --file plugins/compound-engineering/skills/ce-plan-beta/SKILL.mdbun test tests/kiro-converter.test.tsPre-Merge Limitation
Release Previewworkflow is defined in this PR, butworkflow_dispatchworkflows may not appear in this repo's Actions UI until the workflow exists onmainrelease-pleasebehavior on the default branchFirst Validation After Merge
Release PRworkflow run onmainmaindo not publish npm directlyclicomponent is actually released