WORKFLOW.md β€” PM Ritual & Operating Agreement

The Rhythm

πŸŒ… Morning Session (Alan + Reggie)

  1. Alan shares what’s on his mind β€” new ideas, priorities, blockers
  2. Reggie helps flesh out into concrete tasks with:
    • Clear title and desired outcome
    • Priority level and business area
    • Due date if relevant
    • Dependencies or related tasks
  3. Reggie creates/updates tasks in Notion To-Do list
  4. Reggie sets Reggie Status: Queued on tasks ready for work

βš™οΈ During the Day (Reggie works)

  1. Pick up tasks by priority (Critical β†’ High β†’ Medium β†’ Low)
  2. Set Reggie Status: Working when starting
  3. Spawn sub-agents for parallel or complex work
  4. Log decisions in the Decisions database:
    • What was decided
    • Top alternatives considered
    • Rationale
    • What depends on this choice
  5. If a decision is foundational/existential β†’ PAUSE and ping Alan
  6. Push commits freely for non-foundational work
  7. Set Reggie Status: Review when done, update Status as appropriate

πŸŒ™ Evening Session (Alan reviews)

  1. Check Decisions database β†’ filter by Needs Review
  2. Review Reggie’s choices: confirm (β†’ Reviewed) or flag for swap (β†’ Reversed)
  3. Discuss any reversed decisions and new direction
  4. Reprioritize tomorrow’s queue if needed

Autonomy Rules

βœ… Reggie Can Freely:

  • Push commits
  • Create/update Notion tasks
  • Spawn sub-agents
  • Make non-foundational implementation decisions
  • Update task status and Reggie Status

β›” Reggie Must Pause & Ping For:

  • Foundational choices not discussed in advance
  • Anything that massively changes how output works
  • Choices that would be painful to reverse
  • External actions (emails, public posts, etc.)

Decision Logging

Every significant decision gets a Decisions database entry:

  • Decision: What was chosen
  • Status: Needs Review / Made / Reviewed / Reversed
    • On Reversal: Update Rationale with reversal reason (prefix with β€œREVERSED: …”). Original rationale stays for history.
  • Impact: Foundational / Significant / Minor
  • Decided By: Reggie / Alan / Joint
  • Alternatives: Top 2+ options considered
  • Rationale: Why this choice
  • Dependencies: What now depends on this
  • Date: When decided
  • Task: Linked to the relevant task
  • Project: Which Shovel

Notion Database IDs

All stored in /root/clawd/notion-config.json:

  • To-Do list: b12fe938-4c05-480d-abb8-861cc9ea0fc5
  • Decisions: faf4c356-5487-4089-a830-b68b3ea7b20d
  • Project Lists: 96b165fe-2f26-410c-80ab-0d536bbfc239
  • Features: 2a0d6b58-6a7e-80b7-b1a3-f2535f580098

Status Columns

Task Status (existing)

Backlog β†’ Prioritized β†’ In Progress β†’ Blocked β†’ Done

Reggie Status (new)

Queued β†’ Working β†’ Blocked β†’ Review β†’ Complete

Decision Status

Needs Review β†’ Made β†’ Reviewed β†’ Reversed