new-track

A guided intake process for starting a feature, bug fix, or refactoring track in Draft. A track is a documented piece of work with a specification and implementation plan.

In plain words
What is it for?
Use it when planning a new feature, fixing a bug, or restructuring code. It helps produce a track specification and plan after asking clarifying questions.
Why use it?
It helps turn a vague request into an agreed scope, risks, and steps before coding starts. It also checks the project's existing Draft context and uses review points before creating the documents.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/drafthq/draft/new-track
Any agent
npx skills add drafthq/draft --skill new-track
Clone the repo
git clone --depth 1 https://github.com/drafthq/draft

Made for: Claude Code, Codex.

Per session 78 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 6,719 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00078 $0.06719
Opus 5 $0.00039 $0.03359
Sonnet 5 $0.00016 $0.01344
Haiku 4.5 $0.00008 $0.00672

Measured 2d ago against content hash b2bfbd9238e5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

new-track scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

3. Use `curl`/`wget` to fetch any URLs mentioned (dashboards, error pages, API responses)
skills/new-track/SKILL.md · 897 lines

How it starts

The opening of the file, as written. The whole thing — 897 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Create New Track

Create a new track (feature, bug fix, or refactor) for Context-Driven Development. This is a collaborative process — be an active participant providing guidance, fact-checking, and expertise grounded in vetted sources.

Feature Description: $ARGUMENTS

Red Flags - STOP if you're

  • Creating a track without reading existing Draft context (product.md, tech-stack.md, .ai-context.md)
  • Asking questions without contributing expertise or trade-off analysis
  • Rushing through intake without probing deeper with "why"
  • Generating spec/plan without user confirmation at checkpoints
  • Skipping risk identification
  • Not citing sources when giving architectural advice

Collaborative understanding, not speed.


Pre-Check

  1. Verify Draft is initialized:
ls draft/product.md draft/tech-stack.md draft/workflow.md draft/tracks.md 2>/dev/null

If missing, tell user: "Project not initialized. Run /draft:init first."

  1. Check for --quick flag in $ARGUMENTS:

    • If present: strip --quick from $ARGUMENTS now (before Step 1) and store the cleaned text as the working description for all subsequent steps. Proceed to Step 1, then go directly to Step 1.5: Quick Mode.
    • Quick mode is for: hotfixes, tiny isolated changes, work scoped to 1-3 hours
  2. Load full project context (these documents ARE the big picture — every track must be grounded in them):

  • Read draft/product.md — product vision, users, goals, constraints, guidelines (optional section)
  • Read draft/tech-stack.md — languages, frameworks, patterns, code style, accepted patterns
  • Read draft/.ai-context.md (if exists) — system map, modules, data flows, invariants, security architecture. Falls back to draft/architecture.md for legacy projects.
  • Read draft/workflow.md — TDD preference, commit conventions, review process
  • Read draft/guardrails.md (if exists) — hard guardrails, learned conventions, learned anti-patterns
  • Read draft/tracks.md — existing tracks to check for overlap or dependencies
  • Scan recent track impact memory (overlap detection): for each completed track in draft/tracks/*/metadata.json updated within the last 30 days, read the impact block (if present). Build a map module → [recent_track_ids]. After Step 4 (scope distillation), once the candidate modules for the new track are known, intersect them with this map. If overlap exists, surface it in the intake summary:

Read the full file on GitHub · 897 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 897 lines · 78 tokens per session scan A b2bfbd9238e5

Subscribe to this mod's changes

new-track is a skill published in the GitHub repository drafthq/draft (40 stars, last pushed 14d ago), licensed MIT. It adds 78 tokens to every session and 6,719 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.