
Cw Orient
Use at the start of any Codewhale work session, or when unsure whether the canonical...
Install
npx skills add codewhale-hq/Codewhale --skill cw-orient -g -a claude-code -y- Repository
- codewhale-hq/Codewhale41.2k
- Category
- Engineering
- Updated
- 3d ago
- License
- MIT
- Context cost
- Lightabout 1,029 tokens
- Runs scripts
- No, instructions only
What it does
Use at the start of any Codewhale work session, or when unsure whether the canonical checkout is on current `main` and what is dirty in it: establish live repo truth before reading a plan or editing a file.
cw-orient
Open every session on live truth, not on a handoff note, a directory name, or
what was true last time. Several agents share this one checkout on main; the
cheapest bug to avoid is committing a live writer's half-written edit.
This is stage 1 of the loop: orient → cw-slice → cw-gates → cw-dogfood → cw-land → cw-handoff.
When to use
- Starting a session, resuming one, or taking over from another agent.
- A handoff, issue, or plan tells you the state of the repo, verify before trusting it.
- You are about to edit and are not certain what is dirty or who is writing.
Workflow
-
Locate yourself. Checkout, branch, dirt, and how far you are from the remote:
git rev-parse --show-toplevel && git branch --show-current git status --short --branch git log --oneline --decorate -10Agent work happens on
main. A detached HEAD or another branch here is a state to reconcile (preserve dirt and stranded commits, compare withorigin/main, return tomain) before editing; seeAGENTS.md§ Working rules. -
Look for stranded work, not lanes.
git worktree listand recent branches tell you what may hold unlanded commits. Inventory them; do not start work in one, and do not create one.git worktree list git branch --sort=-committerdate --format='%(committerdate:short) %(refname:short)' | head -20 -
Dirt in this checkout is yours (
AGENTS.md, founder 2026-10-22).git status --porcelain git diff --statCheck mtimes: a file changed in the last 15 minutes, or one a live session is editing, is mid-edit, ask that writer to commit, and commit the rest yourself in coherent verified groups (cw-land). Never stash,
checkout --, reset or clean it.
