farseer

Plan large work efforts as decision-ticket maps on an issue tracker.

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/petemcw/farseer --skill farseer-petemcw
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: farseer
Source: https://github.com/petemcw/farseer/tree/main/skills/farseer
Command: npx skills add https://github.com/petemcw/farseer --skill farseer-petemcw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large projects or chunks of work are too big for a single agent session, and the path from a loose idea to a finished result is unclear. Farseer charts that path as a shared map of decision tickets on the repo's issue tracker, resolving them one at a time until the route to the destination is clear. ## Core Features & Use Cases - Map Charting: Turns a loose idea into a map issue (labeled farseer:map) with a named destination, notes, decisions-so-far index, and a Not Yet Specified section for unresolved fog. - Decision Tickets: Creates child issues typed as research, prototype, interviewing, or task, wired with native blocking relationships so the frontier of takeable work is visible in the tracker UI. - Session-Based Resolution: Works one ticket per session, recording answers as resolution comments and graduating newly specifiable fog into fresh tickets. - Use Case: You have a vague goal like migrating a data structure or producing a spec. Invoke the skill to interview you, chart the decisions ahead as tickets, fire off research subagents in parallel, and then work through the frontier ticket by ticket across sessions. ## Quick Start Ask the agent to chart a map for your large idea, for example: "Use farseer to plan the migration of our legacy data model to the new schema."

Frequently Asked Questions about farseer

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

FAQPage Schema
How do I plan a project too big for one agent session?▼

Invoke the skill with your loose idea. It interviews you to name the destination, maps the frontier breadth-first, creates a map issue labeled farseer:map, and files the specifiable decisions as child tickets wired with blocking relationships.

What is a decision ticket in issue tracker planning?▼

A decision ticket is a question whose resolution is a decision, never a slice of build work. Each ticket is a child issue of the map, typed as research, prototype, interviewing, or task, and sized to fit one agent session.

Does farseer work with GitHub Issues or other trackers?▼

The map and tickets live on whatever issue tracker the repo is configured with via /farseer:repo-setup. Trackers with native blocking render the frontier directly; those without fall back to a body convention, and local-markdown is the default.

Can multiple agent sessions work the same map in parallel?▼

Yes. A session claims a ticket by assigning it before starting work, so concurrent sessions skip claimed tickets. The frontier is the set of open, unblocked, unclaimed child issues, and each session resolves at most one ticket.

When should I not use a decision-ticket map?▼

Skip the map when charting surfaces no fog, meaning the path to the destination is already clear and the work fits in one session. Also avoid it for pure execution work, since tickets resolve decisions rather than deliver build slices.