<a href="https://valescoagency.com"> <img src="assets/va-bowtie-logo-primary.svg" alt="Valesco Agency" width="80" /> </a>
ValescoAgency/flightplan
Claude Code skills authored by or curated for Valesco Agency to drive tracker issues from idea to a clean handoff state for runway, Valesco's autonomous coding CLI.
Install
claude plugin marketplace add ValescoAgency/flightplan
claude plugin install flightplan@valescoFor local development against a working clone:
claude plugin marketplace add /path/to/local/flightplan
claude plugin install flightplan@valescoAfter install, skills are invocable as flightplan:<skill-name> (e.g.
flightplan:triage, flightplan:diagnose).
Contents
CONTEXT.md— ubiquitous-language glossary for
flightplan + runway. Read on session start.
docs/workflow.md— end-to-end map from idea to
PR, repo conventions, HITL fork.
docs/adr/— architectural decision records.skills/<skill-name>/SKILL.md— Valesco-authored skills, one
directory per skill (Claude Code plugin convention).
Consumer skills
User-invoked skills that drive issues toward the runway pickup state (label ready-for-agent). Vendor-agnostic — they read the active tracker via the adapter system below.
| Skill | Purpose | |---|---| | /triage | Funnel issues to the ready-for-agent label with sharp acceptance criteria so runway will pick them up. HITL-aware. | | /diagnose | Six-phase debugging discipline; Phase 1 builds a deterministic feedback loop. | | /feedback-loop | The 10-pattern catalog for constructing deterministic agent-runnable signals. | | /handoff | Compact the current conversation into a handoff document so another agent can continue the work. |
Tracker adapters
Modular per-vendor adapters that satisfy the tracker contract. The active adapter is selected via tracker: in .afk/config.yml (default
linear).
| Adapter | Status | Capabilities | |---|---|---| | tracker-linear | Shipped (default) | Full — customer field, project/cycle membership, team namespace, reliable active-work detection | | tracker-github | Shipped | Reduced — no customer field, best-effort active-work detection | | tracker-jira, tracker-local-md | Deferred | — |
These compose with Matt Pocock's engineering skills (/grill-with-docs, /to-prd, /to-issues,
/improve-codebase-architecture, /zoom-out, /tdd) per the workflow in docs/workflow.md. Matt's /triage is not adopted — flightplan's /triage adds runway-prep discipline (sharp acceptance criteria, HITL routing) on top of the same canonical state machine.
Related
runway— autonomous CLI;
reads issues from the tracker, runs Claude Code in @ai-hero/sandcastle, runs an adversarial sub-agent review, opens a PR.
upstream for /grill-with-docs, /to-prd, /to-issues,
/improve-codebase-architecture, /zoom-out, /tdd.
