Say that the blocks and the pin are not editable - #43
Merged
Conversation
Two rules a consuming repository has to follow were written only in the pull requests that deliver a release. Those are read once and scrolled past; `AGENTS.md` is what an agent loads before touching anything, and it said neither. The pin is the sharper half. It is the one file the drift check cannot do without, and it looks like tool output to anyone who has not read where it comes from -- five of the thirteen consumers already ignore `.claude/`, so the reflex is there. It lived in `.agents/` until it moved, and two of those repositories turn out to track a hundred files each under `.agents/skills/`, which they populate deliberately. The pin had been sitting inside someone else's directory, unnoticed, in both. Cut as 0.3.0 with the pin move's entries folded in. That move changed a file this repository expects to find in a consumer, which the version scheme makes MAJOR on its own and MINOR below 1.0.0. It is also what makes the release cuttable: the surface guard refuses a tag whose blocks and roster match the previous release, and the move touched neither, so this block change is what gives 0.3.0 something to carry. Closes #42
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.
Adds a
## Shared instruction blockssection to theworkflowblock, and cuts 0.3.0.The rules
Both were written only in the pull requests that deliver a release — read once, then scrolled past.
AGENTS.mdis the file an agent loads before touching anything, and it said neither..agent-instructions.tomlis source, not tool output. Never ignore it, never untrack it — a repository whose pin cannot be read fails the check outright rather than being read as carrying no blocks.The second is the sharper one, and it stopped being hypothetical while the seven onboarding pull requests were being rebuilt on the new path:
aice-web-nextandaimer-webeach track 107 files under.agents/skills/, a directory they populate deliberately for agent skills. The pin had been living inside someone else's directory in two repositories, unnoticed. A generic name attracts that; a file that looks generated attracts a.gitignoreentry.Why this is 0.3.0
The entries under
[Unreleased]from the pin move fold into this section. That move changed a file this repository expects to find in a consumer, which the version scheme makes MAJOR on its own — MINOR below1.0.0.It is also what makes the release cuttable at all.
check_release_surface.shrefuses a tag whoseblocks/andrepos.jsonmatch the previous release, and the pin move touched neither, somaincould not be tagged before this. The block change gives 0.3.0 something a consumer actually applies.Verification
lint_blocks.pypasses with the new section: within 76 columns,-bullets, andShared instruction blockscollides with no heading in another block.blocks/workflow.mddiffers from 0.2.1, so the surface guard has something to compare.[Unreleased]heading or link reference is left behind.After the merge
git tag 0.3.0 && git push origin 0.3.0Closes #42