Skip to content

Instantly share code, notes, and snippets.

@MelbourneDeveloper
Created November 18, 2026 20:48
Show Gist options
  • Select an option

  • Save MelbourneDeveloper/4e3d96b98ac345d0a45d1808973e709e to your computer and use it in GitHub Desktop.

Select an option

Save MelbourneDeveloper/4e3d96b98ac345d0a45d1808973e709e to your computer and use it in GitHub Desktop.
Global Agents.md
  • 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, generate code from them, consider tdbin for wire protocol
  • 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 in pi --list-models (today zai/glm-5.3-flash repetitive/fixtures/tests, zai/glm-5.3 scoped code/reviews, deepseek/deepseek-flash code/oracles, kimi-coding/k3.1-pro-highspeed UI, deepseek/deepseek-v4-pro narrow 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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment