faff-plot

Decomposes a discovery brief into a dependency-linked roadmap of initiatives, projects, and first-slice epics.

3|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/shftwst/faff --skill faff-plot-shftwst
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: faff-plot
Source: https://github.com/shftwst/faff/tree/main/plugin/skills/faff-plot
Command: npx skills add https://github.com/shftwst/faff --skill faff-plot-shftwst

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning an application-scale idea into a coherent, tracker-backed roadmap is slow and error-prone: teams either invent hundreds of speculative tickets or leave loose backlog items ungrouped. This Skill recurses a discovery brief top-down into a confirmed roadmap skeleton and rehomes loose backlog work into outcome-led projects. ## Core Features & Use Cases - Top-down roadmap recursion: Descends outcome → initiatives → projects → first-slice epics, gating each level with human confirmation and stopping before speculative leaf tickets. - Backlog rehoming pass: /faff-plot rehome groups loose, project-less Backlog tickets into human-approved outcome-led projects with dependency edges and proposed Definitions of Done. - Methodology-driven shaping: Delegates decomposition judgement to a configurable methodology slot (structural or agile-delivery lenses) via batched producer dispatches. - Use Case: After capturing a product idea with /faff-jot, run /faff-plot to produce a confirmed initiative/project/epic skeleton in the tracker, then hand off to /faff-map for a coherence audit and /faff-prep to spec the first slice. ## Quick Start Ask the agent to run /faff-plot on your committed PRD or discovery brief to plan the whole project into a dependency-linked roadmap.

Frequently Asked Questions about faff-plot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a product idea into a project roadmap with an AI agent?▼

Run /faff-plot with a discovery brief or committed PRD. It recurses the brief top-down into initiatives, projects, and first-slice epics, confirming each level with you before writing containers and dependency links to the tracker.

How do I organize a messy backlog into projects?▼

Run /faff-plot rehome. It pulls all project-less Backlog tickets, asks the configured methodology for a grouping proposal, and gates each proposed project for your approval before creating containers, reparenting members, and drawing blocker edges.

Does faff-plot work without a Linear or tracker MCP server?▼

Yes, in git-only mode it writes the full roadmap skeleton as a nested checklist to .faff/intake/ with stable gitkey markers per epic. Container creation is skipped and the rehome pass is a no-op since there is no project-less Backlog concept.

What is the difference between faff-plot and faff-map?▼

faff-plot writes the roadmap skeleton while faff-map is its read-only twin that audits whether the roadmap joins up. Plot creates containers and epics; map never writes and only checks chain coherence, gate fireability, and ghost projects.

Why does faff-plot stop at first-slice epics instead of planning every ticket?▼

The stop rule prevents manufacturing speculative leaf tickets nobody asked for. A branch stops when the next level is not concretely derivable from the brief, and leaves grow later from specs via /faff-prep and bottom-up chain-gap filling.

Can faff-plot run autonomously without human confirmation?▼

Only via the explicit --autonomous flag, which answers its own gates within the L4 topology-write envelope after passing an outward-only ignition check. A bare invocation without the flag falls back to writing a proposal file and creating nothing.