Repository navigation
chore(claude): write down how the work is done - #35
Merged
Merged
Conversation
Seven skills cover checkpoints, pushing, review, model routing, RFC drafting, fact-checking and skill upkeep. CLAUDE.md gains a list of things never to do, including leaving anything behind. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ting TODO.md becomes the one place for where the work stands. model-routing gains routing by lens, the case against maximum effort, a queue limit and a usage log kept outside the repository. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
/review and /checkpoint are Claude Code aliases, so they become /pr-review and /handoff. The handoff is now committed, gates re-run after review fixes, and CI watches the pull-request workflow by name. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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.
Summary
Writes down how the work is done, where a session reads it. Seven skills,
TODO.md, andCLAUDE.md§ Never do these. Documents and instructions only; no code.Explanation for the maintainer
/handoffreplaces one-off handoff files: one "resume here" block inTODO.md, overwritten from commands rather than memory, and committed by the branch that merges next./pre-pushis the path from finished work to an open pull request, ending with this commit's CI watched to green./pr-reviewsets reviewers by risk, fixed lenses, what a reviewer is told, severity, and a stop rule./model-routingrecords your Opus-at-medium trial, the three-agent limit, and a token log kept outside the repository./rfc-draft,/fact-check,/stewardcover drafting RFCs, verifying claims and keeping skills true.CLAUDE.md§ Never do these gathers the rules, including no littering, which is owned there.Worth your eye:
CLAUDE.mdnow tells a session to start fromgit show origin/main:TODO.md, because the working tree may be behind.TODO.md's order of work is the one you agreed: demo parts first, the executable model as the real Pool crate, and x86_64 booted early.Which pillar does this serve?
Toil: process and tooling.
If this changes a document or the constitution
The constitution is untouched.
/check-coherence)docs/CHANGELOG.mdrecords it: not an amendmentBorrow Ledger
unsaferegisterunsafeblocks: Noneunsafeblock carries a// SAFETY:commentunsafeblock is inside a module CLAUDE.md designates for itChecklist
CHANGELOG.mdupdated under[Unreleased]CONTRIBUTING.md)Reviews
Ordinary tier: two reviewers, Opus at medium, one round. Between them, 2 high, 14 medium and the rest low or nit.
/reviewand/checkpointare Claude Code aliases, so typing one would not have run the skill; renamed/pr-reviewand/handoff. The handoff record was never committed, so it could not reach a cold session.TODO.mdparaphrasing the RFCs, and citations that did not say what was claimed.TODO.mdcarries the fix.These fixes have not been reviewed again.
🤖 Generated with Claude Code