FP Implement Skill

Find, claim, and complete work on issues.

Prerequisites

Before using fp commands, check setup:

Check if fp is installed

fp --version

If fp is not installed, tell the user:

The fp CLI is not installed. Install it with:

curl -fsSL https://setup.fp.dev/install.sh | sh -s

Check if project is initialized

fp tree

If project is not initialized, ask the user if they want to initialize:

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

If yes:

fp init

Core Workflow

1. Find work → fp tree, fp issue list --status todo
2. Claim work → fp issue update --status in-progress <PREFIX>-X
3. Do work → implement the task
4. Comment often → fp comment <PREFIX>-X "progress update"
5. Complete → fp issue update --status done <PREFIX>-X

Finding Work

See the Full Picture

fp tree

Shows all issues with hierarchy, status, and dependencies.

fp tree --status todo

Shows only todo items (filters out done work).

fp tree <PREFIX>-X

Shows a specific issue and its children - useful for focusing on one feature/epic.

List by Status

fp issue list --status todo # Available to pick up fp issue list --status in-progress # Currently active fp issue list --status done # Completed fp issue list # All issues

Pick the Right Task

Look for tasks that:

• Have status todo

• Have no dependencies, OR all dependencies are done

• Match your current focus/expertise

Claiming Work

Mark as In-Progress

fp issue update --status in-progress <PREFIX>-2

This captures the current VCS state as the starting point for tracking changes.

Log That You're Starting

fp comment <PREFIX>-2 "Starting work. First step: implement the User model schema"

Load Context

fp context <PREFIX>-2

Shows issue details, description, and related information.

During Work

Comment Frequently

Log progress at key milestones:

fp comment <PREFIX>-2 "Completed schema design. Added User, Session, Token models to src/models/"

fp comment <PREFIX>-2 "Hit a snag: OAuth library doesn't support refresh tokens out of the box. Investigating alternatives."

fp comment <PREFIX>-2 "Resolved: using custom refresh logic. Proceeding with implementation."

When to comment:

• When you start a task

• When you complete a significant milestone

• When you discover important information

• When you encounter problems

• When you finish work

Check Progress

fp issue diff <PREFIX>-2 --stat # Quick view of changed files fp issue files <PREFIX>-2 # List files changed fp issue diff <PREFIX>-2 # Full diff

Completing Work

Mark as Done

fp issue update --status done <PREFIX>-2

This captures the current VCS state as the endpoint.

Add Completion Comment

fp comment <PREFIX>-2 "Task completed. Implemented User, Session, and Token models with Drizzle ORM. All tests passing."

Continuing Previous Work

Find In-Progress Work

fp issue list --status in-progress

Load Context

fp context <PREFIX>-5

Review Recent Activity

fp log <PREFIX>-5 --limit 5

See What's Changed

fp issue diff <PREFIX>-5 --stat

Resume

fp comment <PREFIX>-5 "Resuming work. Current focus: finishing the error handling logic"

Breaking Down Work

If a task is too large, break it down:

Create sub-tasks

fp issue create --title "Part 1: Setup" --parent <PREFIX>-4 fp issue create --title "Part 2: Implementation" --parent <PREFIX>-4 --depends "<PREFIX>-10" fp issue create --title "Part 3: Tests" --parent <PREFIX>-4 --depends "<PREFIX>-11"

Document

fp comment <PREFIX>-4 "Broke down into sub-tasks: <PREFIX>-10, <PREFIX>-11, <PREFIX>-12. Working on <PREFIX>-10 first."

Work on sub-tasks

fp issue update --status in-progress <PREFIX>-10

Viewing Changes

For a Single Issue

fp issue diff <PREFIX>-2 # Full diff since task started fp issue diff <PREFIX>-2 --stat # Just file stats fp issue files <PREFIX>-2 # List of changed files

For Parent Issues

For parent issues with children, these commands aggregate changes from all descendants:

fp issue diff <PREFIX>-1 --stat # All changes across child tasks fp issue files <PREFIX>-1 # All files changed by descendants

Quick Reference

Essential Commands

Find work

fp tree # Full hierarchy fp tree --status todo # Only todo items fp tree <PREFIX>-X # Focus on one issue fp issue list --status todo # List available tasks

Claim work

fp issue update --status in-progress <PREFIX>-X fp context <PREFIX>-X

Log progress

fp comment <PREFIX>-X "message"

View changes

fp issue diff <PREFIX>-X --stat fp issue files <PREFIX>-X

Complete

fp issue update --status done <PREFIX>-X

Activity

fp log --limit 10 fp log <PREFIX>-X

Status Values

• todo

• Not started

• in-progress

• Actively being worked on

• done

• Completed

Priority Values (optional)

• critical

• Blocking other work

• high

• Important, do soon

• medium

• Normal priority

• low

• Nice to have

fp issue update --priority high <PREFIX>-X