shift: onboarding (shift init) + opt-in self-generated work + docs#3
Merged
Conversation
… + CLAUDE.md) - shift init: scaffold queue/ + a template brief + gitignore .shift/ — the highest- leverage 'easier to get going' lever (idempotent, never clobbers). +cli test. - Self-generated/dynamic work: re-discovery already picks up new queue/NN-*.md mid-run (inherent). New config allowSelfQueue (default false) makes the brief invite the agent to queue genuine follow-ups, bounded by maxIterations + branch isolation. +brief test. - README: 'Writing bins' (brief anatomy + Definition-of-done discipline), self-generated work, and 'Using shift with your CLAUDE.md' (paste-in house-style block; the optional SessionStart nudge hook documented but not shipped — nag risk). SPEC §13 updated. 120 shift tests green.
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.
Follow-up to the merged shift module, addressing three questions: is it documented enough, how do you queue work, and can it work on self-generated work.
shift init
Scaffolds a repo for shift —
queue/+ a template brief (the bin anatomy) +.shift/gitignored. Idempotent, never clobbers. The highest-leverage 'easier to get going' lever.Self-generated / dynamic work
Re-discovery of source folders on every cycle already means any
queue/NN-*.mdan agent writes mid-run becomes a pending bin (inherent, always on). NewallowSelfQueueconfig (default false) makes the brief invite the agent to queue genuine follow-ups — bounded bymaxIterations+ branch isolation + review. Opt in for 'grow your own backlog'.Docs
Definition of donediscipline.CLAUDE.md— a paste-in house-style block for unattended runs (commit/test/scope discipline), deliberately NOT restating the brief's safety rules; plus how CLAUDE.md can make sessions suggest shift. The only required hook staysStop; aSessionStartnudge is documented as an optional recipe, not shipped (nag risk).120 shift tests (+2: init, self-queue invite); CI runs both modules.