mcpField
F
fstack-learn

fstack-learn

github.com/flaviocopesAgent workflows3162 installsUpdated 15w ago
Repository

About fstack-learn

fstack-learn is an agent skill for recording one useful lesson from recent project work in LEARNED.md. It checks for duplicates and skips routine observations.

Key features

  1. 01Selects one lesson from recent work
  2. 02Checks LEARNED.md for duplicates
  3. 03Skips routine facts
  4. 04Appends an entry of up to three lines
  5. 05Shows the added entry

Use cases

  1. 01Record a non-obvious bug cause
  2. 02Preserve a lesson after a project decision

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/flaviocopes/fstack --skill fstack-learn

After installing, type/fstack-learnin Claude Code to confirm it loaded.

Details

From the project README

/fstack-learn

Capture one lesson so the next session starts smarter.

When to use

  • After /fstack-push completes.
  • When a bug had a non-obvious cause.
  • When a decision took longer than it should have.
  • When the user invokes /fstack-learn.

Steps

  1. Look at the recent work and pick one lesson. Not two. Not a list.
  2. Read LEARNED.md in the project root if it exists.
  3. Check for a duplicate. If the same lesson is already there, say so and stop.
  4. Skip routine facts. Do not log "added a component" or "fixed a typo".
  5. Write the entry. Max three lines, this format:
## 2026-07-11 — Theme flash on load
The theme must be set in a blocking inline script, not in React.
Anything set after hydration flashes the wrong theme.
  1. Append the entry to LEARNED.md. Create the file if it is missing.
  2. Show the user exactly what was added.

Entry rules

  • Line 1: ## date — short title
  • Line 2: the lesson itself.
  • Line 3: optional context or consequence. Omit if line 2 is enough.
  • No essays. If it needs more than three lines, it belongs in a doc, not here.

Must NOT

  • Write more than one lesson per run.
  • Log routine facts that would not save future-you real time.
  • Duplicate an existing entry.
  • Ask the user to approve before appending. Append, show, done.

Example

Agent: "Added to LEARNED.md:

2026-07-11 — Theme flash on load

The theme must be set in a blocking inline script, not in React. Anything set after hydration flashes the wrong theme."

Comments

Markdown supported