fp-learn

A Claude Code skill that turns project execution into deliberate learning. It wraps around the FP Task Management (plan / implement / review) to classify tasks as "do it yourself" or "delegate to AI", track your learning progress, and quiz you on what you built.

Prerequisites

FP (required)

fp-learn depends on the FP for project management. You need to follow the fp installation and initialize the repo you want to work in with fp before using fp-learn.

FP provides the task breakdown, issue tracking, and plan/implement/review workflow that fp-learn layers on top of. Without it, fp-learn has nothing to wrap around.

Make sure the following FP skills are available in your Claude Code setup:

• fp-plan — creates and breaks down plans into issues
• fp-implement — picks up and works on issues
• fp-review — reviews code and assigns commits

Claude Code

You need Claude Code installed and running.

Installation

Option 1: Project-level (this project only)

Copy the skill directory into your project's .claude/skills/:

mkdir -p .claude/skills
cp -r fp-learn .claude/skills/fp-learn

Option 2: Personal (all projects)

Copy the skill directory into your personal skills folder:

mkdir -p ~/.claude/skills
cp -r fp-learn ~/.claude/skills/fp-learn

Option 3: From the .skill file

Extract fp-learn.skill (it's a ZIP archive) and copy the contents:

unzip fp-learn.skill -d ~/.claude/skills/

Verify installation

Start Claude Code and ask:

plan with learning goals

or just type:

/fp-learn

If Claude recognizes the skill and asks about your learning goals, you're set.

What it does

fp-learn adds 4 stages on top of the normal FP workflow:

Stage	When	What happens
Goal Setup	After fp-plan creates tasks	You define 3-5 learning goals. Tasks get classified as [DIY] (you code it) or [DELEGATE] (AI handles it)
Implementation	During fp-implement	DIY tasks get Socratic hints instead of direct answers. DELEGATE tasks run normally
Phase Completion	All tasks in a phase are done	Reflection journal: what clicked, what's fuzzy, confidence ratings
Quiz	After reflection	10-question quiz tied to your actual project code

DIY vs DELEGATE

Every task gets classified based on your learning goals:

• [DIY: goal] tasks have full issue descriptions with learning goals, key insights, steps, and a definition of done. You write the code. Claude guides with questions, not answers.
• [DELEGATE] tasks are boilerplate or repetitive work. Claude implements them normally.

Example DIY issue

# Install and Configure Keystatic

> **DO YOURSELF** - Learn how Astro integrations work and understand hybrid rendering mode.

Set up Keystatic in the Astro project.

## Learning Goals
- Understand Astro integrations system
- Learn output modes (static vs hybrid vs server)
- Understand why /admin needs SSR (hybrid mode)

## Key Insight: Why Hybrid?
- Most pages: Static (pre-rendered HTML)
- /admin: Server-rendered (needs to run Keystatic)
- Hybrid mode: Choose per-route

## Definition of Done
- Keystatic installed
- Can visit /admin without errors
- See Keystatic UI (even if empty)

Files created in your project

fp-learn creates these files in your project root (not inside .fp/):

File	Purpose
learning-goals.md	Your 3-5 learning goals with skill levels
progress-plan.md	Plan phase journal: tasks, decisions, reflections
progress-impl.md	Implementation phase journal
progress-review.md	Review phase journal
quiz-phase-plan.md	Plan phase quiz (10 questions)
quiz-phase-impl.md	Implementation phase quiz
quiz-phase-review.md	Review phase quiz

Skill contents

fp-learn/
├── SKILL.md                                 # Main skill instructions
├── references/
│   ├── labeling-guide.md                    # DIY vs DELEGATE classification rules
│   └── quiz-generation-guide.md             # Quiz design and evaluation rules
└── assets/
    ├── learning-goals.template.md           # Template for goal tracking
    ├── progress.template.md                 # Template for phase journals
    └── quiz-phase.template.md               # Template for quizzes

License

MIT