Workflow definitions

Pre-plan → Horizon → Issue → Article → Approve → Pin

Canonical SoR + Spec: mfp2/docs/CANONICAL_SPEC.md. Working model (roles × spine): mfp2/docs/WORKING_MODEL.md. Role cards: roles.html · Workflow detail: mfp2/docs/WORKFLOWS.md. UI handoff: docs/HANDOFF_UI_ROLES_WORKFLOW.md.

1.0 Pre-plan 1.5 Horizon 2.0 Issue 3.0 Article A1–A4 3.9 Approve 4.0 Pin / APL

5.0 Images cross-cut briefs, drafts, and layouts

Roles (do not conflate)

CodeRoleDecides
mbeManaging Brand EditorMulti-brand direction · themes · cover / TOC / Lead
editorEditorThis issue’s delivery · briefs · approve text/images · selective non-lead gate
plannerIssue PlannerSlot fill · brief commission · cascades (may stand in for Editor gate)
hub_leadHub leadHub queue / tone only — not a substitute for Editor
writerWriterDraft · mark ready (= authority when no higher gate)

Create envelope: Editor files brief → Writer Create → Mark ready → Editor (or MBE) approves → pin. Detail: CREATE_WORKHORSE.md §1b.

1.0 Pre-planning

  • 1.1 Brand Define magazine title
  • 1.2 Blueprint Content slots; 1+ articles per layout
  • 1.3 A-tags A1 generate+select · A2 brief-draft · A3 open-format writer · A4 cascade-P3
  • 1.4 P-tags P1 new · P2 changed reuse · P3 minimal reuse
  • 1.5 INDD + samples Target layouts + <10 example pages · APL-1 BA ↔ layout Y/N
  • 1.6 Cascade Giver title → taker slot/page

2.0 Issue planning

  • 2.1 Cover always A1 · package · cover-led or issue-led · MBE gate
  • 2.2 One brief per article (Editor/Planner); P3 cascade = no brief
  • 2.3 Select INDD template (compatible pairs only)
  • 2.4 Deep inputs + images may attach
  • 2.5 Publish brief · allocate hub / writer
  • 2.6 MBE: cover + TOC + leads · Editor: gated non-leads · Writer: ready = authority when no higher gate

3.0 Article creation

MethodTypical PFlow (short)
A1P1Both: (1) bulk generate article type → pool · (2) select → task → review → approval. Cover always A1 · MBE.
A2P1Editor/Planner file task + draft brief → Writer improve → AI draft → layout-aware edit → mark ready → Editor approve
A3P1 (or P2)Open-format: directional brief → writer experiences/reports → often selects images → writes to page
A4P3Design goal: no work. Cascade only onto matrix-compatible layouts; place automatically; tweak is exception

Shared toolkit: fact-check, length/fit (APL-2), proofread, template test, mark ready. 3.9: Writer can mark ready; MBE or Editor only when their gate applies. Hub lead does not approve Create.

4.0 APL — three fit gates

Business top priority: 100% fit ideal · ≥90% pins with no designer work. Deep UI parked — keep stage labels honest.

  • APL-1 Pre-plan BA ↔ layout pairs only — Y/N fit test; incompatible layout not selectable
  • APL-2 Creation Live min/max on titles, subheads, text blocks · quality may trump fit (exception → design later)
  • APL-3 Pin / Layout QA IDS pin → scan bleed / overhang / overlay · minor adjust or raise flag
  • L1 back Failures feed Improve / pairs / length contracts upstream

Engine: InDesign Server. Detail in WORKFLOWS §4. Do not collapse into a single “layout QA” blob.

5.0 Images — article image set

Typically 3–5 images (0–10). Position 1 = Main; 2…N support frames.

  • Sources Archive first (usually free) · Agency (may pay on use) · AI-gen (no real people)
  • When With brief · writer during task · late/news before press — same selector
  • Set Ordered article image set → INDD slots

Detail: docs/IMAGE_WORKFLOW.md.

Workflow-driven registry + events

Live catalog from Postgres (/api/workflows/registry) · domain outbox (/api/events). Doc: docs/WORKFLOW_DRIVEN.md. n8n orchestrates; it does not own editorial SoR. Unconsumed events show AckPOST /api/events/{id}/ack. Ack all unconsumed walks open events one-by-one (no batch API yet). Toggle ●/○ or Enable/Disable → PATCH /api/workflows/registry/{stage_id}.

Registry

Loading…

Recent domain events

Loading…

Persistence

Postgres = SoR · LangGraph = agent runs · n8n = jobs. Full matrix in WORKFLOWS §7.

BandPostgresLangGraphn8n
1.x Pre-planYesSuggestImport
2.x Issue / briefYesBrief assistNotify
3.x DraftYesDraft / critiqueNotify
3.9 ApproveGatesNotify
4.x PinIdsJob→ IDS
5.x ImagesImage*Vector assist→ WWA / agency