tmb_planning SKILL.md skillA

tmb_planning from trustmybot/plugin is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add trustmybot/plugin/tmb_planning@git:20261105.fd408a5

Pins git:20261105.fd408a5 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
trustmybot/plugin
Path
skills/tmb_planning/SKILL.md
Versions recorded
14
Latest version
git:20261105.fd408a5, committed Nov 5, 2026
First version recorded
Oct 18, 2026
Size
16,893 bytes
Repository stars
6
License
MIT

Bro's code-touching flow — verify world model, triage the requirement (reuse vs build), propose branch, write spec, dispatch SWE, verify on return, atomic-close. Loaded on the first code-touching ask of a session.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Planning — bro's code-touching flow

## 1. Verify the world model

`world_model_get(depth=2)` returns the project's directory tree with README-derived summaries. The main checkout shows only merged work — when `unmerged_work` is non-empty, those branch tips are part of the codebase too: read context from and base follow-up work on the newest relevant tip (`task_provision base=<branch_id>`). If the response carries `warning: 'world-model-empty'`, run `scan_run(source='bro_auto_initial')` to build it, then re-read.

Zoom-in: `world_model_get(path='src/api', depth=1)`. "Where does X live": `world_model_search(query='X', mode='hybrid')`.

## 2. Triage the requirement

With the world model in hand, before you commit to building — two quick questions (judgment, not a research project):

1. **Is it actionable?** Well-defined, testable, in scope? If it's vague hand-waving, surface the gap via `tmb_concerns-protocol` (or an AUQ) and pin it down *before* authoring a spec.
2. **Reuse or build?** Once the requirement is real and we'd build something, prefer reuse over reinventing — check two distinct axes before committing to from-scratch code:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add trustmybot/plugin/tmb_planning@sha256:cfb1d577abe9ebf0

The line at the top of this page pins the label git:20261105.fd408a5, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_c7jsqkc2qperb6da.svg)](https://markdownregistry.com/a/art_c7jsqkc2qperb6da)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 14 versions of this file, between Oct 18, 2026 and Nov 5, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261105.fd408a5 latest2026-11-05 fd408a5 16,893 BA view · diff
git:20261105.e930e062026-11-05 e930e06 16,829 BA view · diff
git:20261105.7b71ab12026-11-05 7b71ab1 16,589 BA view · diff
git:20261103.9e3953c2026-11-03 9e3953c 16,391 BA view · diff
git:20261102.bbeeee92026-11-02 bbeeee9 16,341 BA view · diff
git:20261028.9cc886e2026-10-28 9cc886e 16,073 BA view · diff
git:20261026.b1dee642026-10-26 b1dee64 15,957 BA view · diff
git:20261026.cb1f6272026-10-26 cb1f627 15,947 BA view · diff
git:20261025.5c1b3882026-10-25 5c1b388 15,781 BA view · diff
git:20261019.22de22a2026-10-19 22de22a 14,168 BA view · diff
git:20261019.8fd294a2026-10-19 8fd294a 14,120 BA view · diff
git:20261019.bfe1cee2026-10-19 bfe1cee 13,504 BA view · diff
git:20261018.464a31d2026-10-18 464a31d 12,813 BA view · diff
git:20261018.40c63cc2026-10-18 40c63cc 12,620 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (16893 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

trustmybot/plugin · 6 stars · license MIT · pushed 2026-11-05 · branch dev

API

GET https://markdownregistry.com/api/v1/artifacts/art_c7jsqkc2qperb6da
GET https://markdownregistry.com/api/v1/resolve?ref=trustmybot/plugin/tmb_planning
GET https://markdownregistry.com/api/v1/blob/cfb1d577abe9ebf094e7fc2bcfe98ea9210aaae3eb46ec6cd742be459d83d5ff

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from trustmybot/plugin

CLAUDE.md CLAUDE.md file
trustmybot/plugin · CLAUDE.md
git:20261026.b1dee64 · audit A · 6 stars
tmb-agent-setup SKILL.md skill
trustmybot/plugin · adapters/codex/skills/tmb-agent-setup/SKILL.md · Inspect, install, or remove TrustMyBot's two fixed project-level Codex Agents. Use only when the user explicitly…
git:20261026.b1dee64 · audit A · 6 stars
tmb-bro SKILL.md skill
trustmybot/plugin · adapters/codex/skills/tmb-bro/SKILL.md · Inspect a Git project with TMB's project-local inventory and world model, clarify a request, and capture an approved…
git:20260815.a2d60de · audit A · 6 stars
tmb_audit SKILL.md skill
trustmybot/plugin · skills/tmb_audit/SKILL.md · How bro audits, verifies or checks a component or an architecture — start from its outputs, state the invariants they…
git:20261012.15cca9e · audit A · 6 stars
tmb_cheatcode SKILL.md skill
trustmybot/plugin · skills/tmb_cheatcode/SKILL.md · When bro hits a wall — a task leans on a capability the project plainly lacks — and an existing published skill, MCP…
git:20261101.b2d4ceb · audit A · 6 stars
tmb_comment-triage SKILL.md skill
trustmybot/plugin · skills/tmb_comment-triage/SKILL.md · Bro's PR/MR comment triage — resolve the PR, fetch the comment threads, judge which are task-worthy, and dispatch SWE…
git:20261019.3444f14 · audit A · 6 stars
tmb_concerns-protocol SKILL.md skill
trustmybot/plugin · skills/tmb_concerns-protocol/SKILL.md · How bro raises a concern when doubting the Human's plan — surface inline via discussion_append + ask, or spawn a…
git:20261019.01719a2 · audit A · 6 stars
tmb_docs-conventions SKILL.md skill
trustmybot/plugin · skills/tmb_docs-conventions/SKILL.md · Loaded when editing prompt files (agents, skills, CLAUDE.md, workflow markdown) or updating user-visible docs. Carries…
git:20261026.b1dee64 · audit A · 6 stars
tmb_push-gate SKILL.md skill
trustmybot/plugin · skills/tmb_push-gate/SKILL.md · Bro's push-gate orchestration — reaping unsigned commits, spawning code-reviewer per task, and the all-pass push +…
git:20261105.fd408a5 · audit A · 6 stars
tmb_recovery SKILL.md skill
trustmybot/plugin · skills/tmb_recovery/SKILL.md · Bro's response when something fails — an MCP tool returns is_error=true (halt + surface), the trajectory-server is…
git:20261105.e930e06 · audit A · 6 stars
tmb_review SKILL.md skill
trustmybot/plugin · skills/tmb_review/SKILL.md · code-reviewer's diff-level push-gate review — check this task's diff against its spec, then write the validation_record…
git:20261105.fd408a5 · audit A · 6 stars
tmb_skill-creator SKILL.md skill
trustmybot/plugin · skills/tmb_skill-creator/SKILL.md · Generate a new project-local skill at <project>/.claude/skills/<name>/SKILL.md and attach it to existing agents. Loads…
git:20261103.1283019 · audit A · 6 stars

Every file in trustmybot/plugin

Browse by kind, by grade A, or by owner.