Skip to main content
This playbook was intentionally shared.

The owner approved this public link with the permissions shown below.

For humans and agents: a playbook is operating intent — workflow patterns, communication style, approval rules. It should not contain secrets, credentials, or other sensitive information. If you forked this and notice anything sensitive, remove it before sharing further.

Jonathan Keen - Operator Playbook

Jonathan Keen · Co-executive director of a nonprofit newsroom; advisory and governance roles across several media and media-tech organizations; builds AI-driven systems and media infrastructure.

PublicLowv1.2.15forking allowedcomparison allowedexport allowed

Jonathan Keen - Operator Playbook

Co-executive director of a nonprofit newsroom; advisory and governance roles across several media and media-tech organizations; builds AI-driven systems and media infrastructure. · Works across multiple organizations at once - constant context switching is the default operating condition, so portability and clean handoffs matter more than per-org tuning.

Action-biased operator who runs agent-first development with verification gates. Agents plan before non-trivial work, verify every claim with a tool before reporting it, and close each unit of work with commit + push + a handoff note so any future session can resume cleanly; human-only work goes to an operator action queue surfaced every session start. Several model lineages work as one team: the active session conducts, and review goes to a different vendor's model - a classifier routes ordinary diffs to a Gemini-lineage gate and risk surfaces to a GPT-lineage gate before anything leaves the machine, while a cloud coding agent runs a daily lane of evidence-checkable cleanups. An instruction canon compiles each agent's native rules file from one source so the agents cannot drift apart silently. Everything must work from a fresh clone, with docs updated in the same pass as the change. The standing bargain: high autonomy on local and reversible work, hard stops on anything irreversible, outward-facing, or cost-bearing.

Default tone
Direct, concise, decision-first - lead with the state change, then the detail; written for a teammate catching up, not for a log file.
Risk tolerance
High for local, reversible automation; zero for unreviewed pushes to gated branches, recurring paid infrastructure, or anything touching credentials or financial accounts.
Decision style
Bias to action: act on reversible decisions without asking, escalate irreversible or cost-bearing ones, and course-correct early rather than defending a failing approach.
Recommended use
For operators running multi-agent development across several orgs. Adopt in order: (1) handoffs plus an operator action queue; (2) cross-vendor review lanes routed by risk, with receipts checked at push; (3) the instruction canon once you run more than one agent CLI; (4) a cloud-agent routine lane for evidence-checkable cleanups. The runnable implementation is public: the 'dotfiles' repository on GitHub under handle jckeen - fork it rather than rebuilding.
Created for
claude_codecodexcursorgeneric

Primary workflows

  • Plan -> confirm approach -> execute for non-trivial work; clear tactical asks get done and reported with no plan and no preamble
  • Roles assigned per task: the active session conducts; implementer, independent reviewer and runtime verifier go to whichever runtime fits
  • One PR per unit of work; a classifier picks the review lane: ordinary diffs -> Gemini-lineage gate, risk surfaces -> GPT-lineage gate
  • Review gates are prompt-injection-hardened (read-only, sandboxed, diff fenced as data) and mint a receipt the pre-push hook checks
  • Reviewer-bot PR comments are harvested into one consolidated checklist issue per PR, at merge time and again when the PR closes
  • Cross-agent parity is CI-enforced: every canonical working rule must appear in each agent's instruction file, and one shared workflow skill set is symlinked from a single source into every agent's config
  • Handoff notes at every stopping point; a handoff to a verifier carries the claim to disprove and the exact repro command, not just 'please review'
  • Parallel subagents for read-only research and review; exactly one owner at a time for shared-file edits
  • Audit risky surfaces (auth, path handling, file IO, schemas) the moment a first draft exists - not at a final gate
  • Changelog updated every 1-2 meaningful commits, appended not rewritten
  • A scheduled routine fleet covers overnight/weekend gaps: merge-bot plus nightly/weekly security, dependency, docs-drift, advisor, digest, and janitor sweeps - issues not PRs, silent when clean. Routine prompts are version-controlled and pushed by script, never hand-edited
  • A cloud coding agent runs a daily routine lane: one versioned prompt per cleanup, capped PRs, paused below a 30% merge rate
  • Instruction canon: shared rules live once; a generator emits each agent's native rules file; CI fails on hand-edits or stale artifacts
  • Instruction and gate files are agent-proof: agents file a labelled issue with an applyable patch; the operator lands them in one gated PR
  • Operator action queue: work only the human can do goes in one queue file surfaced every session start, removed only when done
  • Fresh-context review packet from staged changes (bounded, fail-closed on empty diff) so reviewers see exactly the artifact under review
  • Learning loop: one session-retro after the outcome is verified directly - agent reports stay hypotheses until then
  • Agent launchers share a preflight: repo pull, memory publication, health check, self-heal; health failures stop it, sync failures warn
  • Plugins split by scope: a global set enabled everywhere, stack-specific skill farms installed everywhere but enabled per project
  • Routine patch/minor dependency PRs merge on sight when green, one per repo; majors need a release-notes and used-surface review first

Recurring tasks

  • Inbox triage that classifies every message and produces two reply drafts (formal + casual) for urgent items
  • Meeting prep notes generated from calendar attendees + recent thread context
  • Branch and worktree cleanup after every merge
  • Weekly review of dismissed agent drafts to find classifier patterns worth demoting
  • Session retrospectives that propose edits to the agent's own skill files
  • End-of-day cross-org rollup note built from the day's briefs and prep notes plus tomorrow's calendar
  • Post-routine custodian pass: merge only docs/lockfile PRs with green CI, report dirty trees and stale branches, never touch code