FP Agent - Interactive Task Picker

Environment Check

• fp CLI installed: !which fp > /dev/null 2>&1 && echo "✓ Yes" || echo "✗ No"
• Project initialized: !test -d .fp && echo "✓ Yes" || echo "✗ No"

Instructions

Based on the environment check above, follow ONE of these paths:

Path A: fp CLI not installed

If fp CLI is NOT installed, inform the user:

The fp CLI is not installed. To install it:

curl -fsSL https://setup.fiberplane.com/install.sh | sh -s

After installation, run /fp again.

Do NOT proceed further.

Path B: Project not initialized

If fp CLI is installed but .fp directory doesn't exist, ask the user:

This project hasn't been initialized with fp. Would you like to initialize it?

If yes, run fp init and then proceed to Path C.

Path C: Ready to work (fp installed + project initialized)

Then run these commands to load context:

fp tree                                  # Show issue hierarchy
fp context --current --format compact    # Current work (if any)
fp issue list --status todo              # Available tasks
fp issue list --status in-progress       # Active tasks
fp issue list --status done              # Completed tasks

Then use AskUserQuestion to ask the user what they want to do:

• Present the todo tasks as options (use the issue IDs and titles from the commands above)
• Include "Continue current work" (if there's in-progress work)
• Include "Create a new task"
• Include "Plan new work" (for breaking down a feature/project into tasks)
• Include "Review commits" (to assign commits to the correct issues)

Based on selection:

• Continue current work: Load full context with fp context --current
• Pick a task: Mark it in-progress with fp issue update --status in-progress <id>, then load context with fp context <id>
• Create new task: Use AskUserQuestion to gather title/description, then fp issue create
• Plan new work: Invoke the fp-planning skill to help break down the work into a hierarchy of issues
• Review commits: Use the fp-review skill to analyze recent commits and assign them to issues

After task is selected, use TodoWrite to create a todo list based on the issue description.

Quick Reference

Once working on a task:

• fp comment <id> "message" - Log progress (do this frequently!)
• fp issue update --status done <id> - Mark complete
• fp issue update --priority high <id> - Set priority (low/medium/high/critical)
• fp issue diff <id> - See changes since task started
• fp issue files <id> - List changed files
• fp issue assign <id> - Assign current commit to issue (for manual commit tracking)
• fp context <id> - Reload issue context
• Suggest user run fp review to open web UI for reviewing uncommitted changes

End of session:

• Use the fp-review skill to assign commits to correct issues

See fp-workflow, fp-planning, and fp-review skills for detailed patterns.