molecule-core/org-templates/molecule-dev
Hongming Wang 2e43bb7271 chore(handoff): triage-operator role + agent handoff package
Wraps up a ~100-tick autonomous triage session by converting the prior
operator's institutional knowledge into standing, checked-in artifacts
so the next team picking up the hourly PR + issue cycle can drop in
without re-discovering everything from scratch.

## New role: Triage Operator

Peer to Dev Lead, Research Lead, Documentation Specialist under PM.
Owns the 7-gate PR verification + issue-pickup cycle across both
molecule-monorepo and molecule-controlplane. NOT an engineer — never
writes logic, never makes design calls. Mechanical fixes on other
people's branches + verified-merge only.

Runs on cron `17 * * * *`. On first boot reads four handoff files +
the last 20 lines of cron-learnings.jsonl, waits for the scheduled
tick (no first-boot triage — known stale-state footgun).

## Files

org-templates/molecule-dev/triage-operator/
- system-prompt.md (48 lines) — role prompt loaded at boot. Standing
  rules, verification discipline, escalation paths.
- philosophy.md (135 lines) — 10 principles each tied to a real
  incident. Rule 2 ("tool succeeded ≠ work done") references the
  WorkOS refresh-token + missing-migration saga. Rule 3 (authority
  verification) references PR #370 CEO directive hold.
- playbook.md (234 lines) — step-by-step tick flow (Step 0 guards →
  1 list → 2 seven-gate → 3 docs sync → 4 issue pickup → 5 report).
  Expected 5–30 min wall-clock. When-not-to-triage.
- handoff-notes.md (146 lines) — point-in-time state for the NEXT
  operator arriving fresh. 15 PRs merged this session, in-flight
  items, design-call backlog with recommendations per issue.
- SKILL.md (152 lines) — installable skill spec. Invocation, inputs,
  outputs, required composed skills, edge cases, output format.

.claude/AGENT_HANDOFF.md (206 lines) — top-level handoff for any
Claude Code agent working this repo (not just the triage operator).
The 10 principles (one-liners), communication style the user
expects, currently-live state, open items, what NOT to do, break-
glass escalation conditions. Points at triage-operator/philosophy.md
for full incident context.

## Wiring

org.yaml gains a Triage Operator workspace block under PM with:
- tier: 3, model: opus
- 8 plugins (careful-bash, session-context, cron-learnings,
  code-review, cross-vendor-review, llm-judge, update-docs, hitl)
- Hourly cron at `:17` with the full Step 0–5 flow inline as prompt
- canvas position (1150, 250) — peer to Documentation Specialist

## Why this ships now

The 30-min manual triage cron was cancelled per CEO direction. The
role moves to another team. Without this handoff package they'd be
rediscovering the same incident-classes I shipped fixes for
(#318 fail-open, #327 cross-tenant decrypt, #351 tokenless grace,
WorkOS refresh-token saga, missing migration runner). The philosophy
file gives them the scar tissue in ~10 min of reading; the playbook
gives them the steps; the SKILL gives them an invocable entry point.

No code changes outside org.yaml. Existing TestPlugins_UnionWithDefaults
still passes (verified in platform test run).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 23:41:01 -07:00
..
backend-engineer initial commit — Molecule AI platform 2026-04-13 11:55:37 -07:00
community-manager feat(org-templates): add 7-role marketing team sub-tree (#373) 2026-04-15 23:20:04 -07:00
competitive-intelligence initial commit — Molecule AI platform 2026-04-13 11:55:37 -07:00
content-marketer feat(org-templates): add 7-role marketing team sub-tree (#373) 2026-04-15 23:20:04 -07:00
dev-lead initial commit — Molecule AI platform 2026-04-13 11:55:37 -07:00
devops-engineer initial commit — Molecule AI platform 2026-04-13 11:55:37 -07:00
devrel-engineer feat(org-templates): add 7-role marketing team sub-tree (#373) 2026-04-15 23:20:04 -07:00
documentation-specialist fix(template): add missing documentation-specialist/system-prompt.md (closes #177) 2026-04-15 17:23:38 +00:00
frontend-engineer initial commit — Molecule AI platform 2026-04-13 11:55:37 -07:00
market-analyst initial commit — Molecule AI platform 2026-04-13 11:55:37 -07:00
marketing-lead feat(org-templates): add 7-role marketing team sub-tree (#373) 2026-04-15 23:20:04 -07:00
pm feat(platform): generic category_routing replaces hardcoded audit dispatch (#51) 2026-04-14 14:06:47 -07:00
product-marketing-manager feat(org-templates): add 7-role marketing team sub-tree (#373) 2026-04-15 23:20:04 -07:00
qa-engineer initial commit — Molecule AI platform 2026-04-13 11:55:37 -07:00
research-lead initial commit — Molecule AI platform 2026-04-13 11:55:37 -07:00
security-auditor chore(auditor): close #319 + #337 prompt drift on Security Auditor (#342) 2026-04-15 21:24:34 -07:00
seo-growth-analyst feat(org-templates): add 7-role marketing team sub-tree (#373) 2026-04-15 23:20:04 -07:00
social-media-brand feat(org-templates): add 7-role marketing team sub-tree (#373) 2026-04-15 23:20:04 -07:00
technical-researcher initial commit — Molecule AI platform 2026-04-13 11:55:37 -07:00
triage-operator chore(handoff): triage-operator role + agent handoff package 2026-04-15 23:41:01 -07:00
uiux-designer initial commit — Molecule AI platform 2026-04-13 11:55:37 -07:00
.env.example initial commit — Molecule AI platform 2026-04-13 11:55:37 -07:00
org.yaml chore(handoff): triage-operator role + agent handoff package 2026-04-15 23:41:01 -07:00