- 1 feature branch, 1 working tree: merge all loose branches/stashes/uncommitted files into it & push. Delete branches already merged into it
- ❌ ask user questions. Decide, act, report. Act autonomously
- Duplication = bug. Use deslop
- Important lints → error. Run static analysis routinely
- 🧹 After work: delete safe system caches & unneeded build files, kill your owned processes that eat CPU or memory and check disk space
- Refactors: violent, immediate, no back-compat. Legacy code banned → delete now
- Minimize code; decide toward less. Delete dead code now
- 📦 Minimize 3rd-party deps: routinely delete unused packages/crates, add none without need, consolidate overlapping deps into one, avoid those with a vulnerability history
- Reply ≤2 sentences, emojis for emphasis. Don't stream responses
- ✅ Tick mandatory plan checklist items as you work
- Website docs, blogs = prose classes, CSS BUDGET 2K LOC default
- ❌ self as git commit coauthor
- PR CI Phases = Build/Analyze/Cache Build -> Run tests parallel with coverage (on cached build) -> Coverage checks
- Declare all models with [typeDiagram](https://typediagram.dev/docs/language-reference.html) , generate code from them, consider[tdbin for wire protocol](https://typediagram.dev/docs/tdbin.html)
- Specs: hierarchical non-numeric IDs, cross-ref'd across code/tests/plans/artifacts
- Repo structure: AgentPMO . Deploy structure:Shipwright
- Aim 💯 coverage via use-case E2E tests. Unit tests banned unless isolation needed
- 💰 Watch spend (GH Actions, agents, cloud: GCP/Supabase…). Minimize & prevent unneeded future spend
- Tests: many input permutations & assertions. Prefer long tests: many user interactions, many assertions each
- Offload simple work to pi; pick models per
/Users/christianfindlay/Documents/Code/PiNotes/MODEL-COMPARISON.md, always each family's newest id inpi --list-models(todayzai/glm-5.3-flashrepetitive/fixtures/tests,zai/glm-5.3scoped code/reviews,deepseek/deepseek-flashcode/oracles,kimi-coding/k3.1-pro-highspeedUI,deepseek/deepseek-v4-pronarrow audits only); bounded tasks, verify results, record model/date/results in PiNotes - ❌ Claude artifacts: reports/docs → markdown in repo
- Commit after each step; don't let uncommitted files pile up
- 🔒 Close issues only after testing the LATEST release's own binaries 📦. ❌ Never close via PRs