founder-os: Command for Claude Code

Approve Research Plan

Review a completed research plan and approve it for implementation. Approving automatically creates an implementation task.

Arguments

• $ARGUMENTS - (Optional) Task ID of the plan to approve. If not provided, show all plans awaiting review.

Process

1. Read .claude/queue/backlog.json to find items with status: "needs_review"

2. If no task ID provided:

   • List all items with needs_review status
   • Show title, owner, and plan file path for each
   • Ask which plan to review

3. If task ID provided (or after selection):

   • Read the plan file at the item's plan_file path
   • Display the full plan for review

4. Present the plan summary and ask for decision:

   Use AskUserQuestion:

   • Question: "How would you like to proceed with this plan?"
   • Options:
     • "Approve" - Accept the plan and create implementation task
     • "Revise" - Request changes to the plan (use /queue:revise instead)
     • "Reject" - Discard the plan entirely
     • "Skip" - Review later

If Approved

1. Update the research task:

   • Set status: "approved"
   • Add approved_at: "ISO timestamp"
   • Add approved_by: "founder"

2. Create a new implementation task in backlog:

   {
     "id": "YYYY-MM-DD-{slug}-impl",
     "title": "Implement: {original title without 'Research:' prefix}",
     "type": "implementation",
     "priority": {same as research task},
     "status": "pending",
     "requires_approval": false,
     "owner": "{same owner or reassign}",
     "plan_reference": ".claude/queue/plans/{research-id}.md",
     "blocked_by": [],
     "context": {
       "problem": "{from research task}",
       "acceptance": ["Implement plan as specified in {plan_file}"],
       "files_hint": ["{extracted from plan's Files Affected section}"]
     },
     "sizing": "single-context",
     "created": "ISO timestamp",
     "updated": "ISO timestamp"
   }
   

3. Move the approved research task to .claude/queue/completed/{id}.json