---

name: knowns.task.reopen description: Use when reopening a completed task to add new requirements, fix issues, or extend functionality

Reopening Tasks

Reopen completed tasks properly with time tracking and requirement documentation.

Announce at start: "I'm using the knowns.task.reopen skill to reopen task [ID]."

Core principle: DOCUMENT WHY THE TASK IS REOPENED.

The Process

Step 1: View Current Task State

Copyknowns task $ARGUMENTS --plain

Verify:

• Task is currently done
• Understand what was implemented
• Review implementation notes

Step 2: Reopen and Start Timer

Copy# Set back to in-progress
knowns task edit $ARGUMENTS -s in-progress

# Start timer (REQUIRED)
knowns time start $ARGUMENTS

Step 3: Document Reopen Reason

Copyknowns task edit $ARGUMENTS --append-notes "🔄 Reopened: <reason>"

Common reasons:

• User requested changes
• Bug found in implementation
• New requirements added
• Missed acceptance criteria

Step 4: Add New Requirements

Copy# Add new acceptance criteria
knowns task edit $ARGUMENTS --ac "New requirement 1"
knowns task edit $ARGUMENTS --ac "Fix: issue description"

Step 5: Update Plan (if needed)

Copyknowns task edit $ARGUMENTS --plan $'Previous plan + new steps:
1. Original step (done)
2. Original step (done)
3. NEW: Address new requirement
4. NEW: Fix reported issue'

Present updated plan and WAIT for approval.

Step 6: Implement and Complete

Follow normal task completion flow:

Copy# Check new ACs as completed
knowns task edit $ARGUMENTS --check-ac <new-index>
knowns task edit $ARGUMENTS --append-notes "✓ Done: new requirement"

# Stop timer
knowns time stop

# Mark done again
knowns task edit $ARGUMENTS -s done

When to Reopen vs Create New Task

Rule of thumb: If it takes < 30 mins and relates to original task, reopen. Otherwise, create new task with reference.

Creating Follow-up Task Instead

Copyknowns task create "Follow-up: <description>" \
  -d "Related to @task-$ARGUMENTS" \
  --ac "New requirement"

Remember

• Always document reopen reason
• Start timer when reopening
• Add new AC for traceability
• Stop timer when done
• Consider if new task is more appropriate