review-learnings

Review Learnings

Extract reusable learnings from closed octomux-agents tasks and add them to the repo's .claude/rules/learnings.md so future agents (and human sessions) benefit automatically.

Usage

• /review-learnings — review all unreviewed closed tasks
• /review-learnings <task-id> — review a specific task
• /review-learnings add "..." — manually add a learning to current repo

Manual Add Mode

If the argument starts with add, extract the quoted text and append it as a bullet to .claude/rules/learnings.md in the target repo:

1. Determine target repo:

   • If --repo <path> is provided, use that path
   • Otherwise, run git rev-parse --show-toplevel to get the current repo root

2. Read <repo>/.claude/rules/learnings.md (if it exists)

3. If the file doesn't exist, create it:

   mkdir -p <repo>/.claude/rules
   

   Then write the file with:

   # Learnings
   
   - <the learning text>
   

4. If the file exists, append - <the learning text> on a new line at the end

5. Confirm: Added learning to <repo>/.claude/rules/learnings.md

Then stop. Manual add does not run extraction or review.

Extraction Mode

Step 1: Fetch closed, unreviewed tasks

curl -s http://localhost:7777/api/tasks | jq .

Parse the JSON response. Filter to tasks where:

• status === "closed"
• If a specific <task-id> argument was provided, also filter to that task

For each closed task, check if it has already been reviewed:

• If task.worktree is null or the worktree directory doesn't exist on disk, skip this task silently (worktree was deleted, nothing to review)
• The task's worktree field gives the worktree path (e.g., /Users/alice/repos/myapp/.worktrees/abc123)
• Check if <worktree>/.learnings-reviewed exists:

  stat <worktree>/.learnings-reviewed
  

• If the marker file exists, compare its mtime against the task's updated_at:
  • If updated_at is AFTER the marker's mtime → treat as unreviewed (task was resumed)
  • If updated_at is BEFORE or equal → already reviewed, skip
• If the marker file doesn't exist → unreviewed