cd /news/ai-agents/global-agents-md · home › topics › ai-agents › article
[ARTICLE · art-172271] src=gist.github.com ↗ pub= topic=ai-agents verified=true sentiment=· neutral

Global Agents.md

A developer published a global Agents.md file specifying autonomous coding-agent conventions, including merging loose branches into a single working tree, banning back-compat refactors and dead code, minimizing third-party dependencies, and targeting full coverage through use-case end-to-end tests. The file also prescribes per-model routing across GLM, DeepSeek and Kimi models by task type, a three-phase PR CI pipeline, and routine cleanup of caches and owned processes.

recommendation

Adopt a repo-level Agents.md that fixes autonomy rules, model routing per task type, and a build-analyze-test CI order so coding agents act without asking and commit after each step.

more in playbook: Working with AI coding agents
by read2 min views2 publishedNov 18, 2026

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](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-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
── more in #ai-agents 4 stories · sorted by recency
── more on @claude 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
→ Live at https://your-agent.zahid.host ✓
Get free account → Pricing
from €0/mo · no card required
LIVE [news/global-agents-md] indexed:0 read:2min 2026-11-18 · —