quest-runner

An autonomous development-task runner that moves work through defined stages, from initial setup and research to planning, implementation, review, and completion.

In plain words
What is it for?
Use it to run a development task through the fellowship command-line tool and enforce its lifecycle gates.
Why use it?
It provides a managed process with checkpoints that prevent the work from moving to the next stage before required approval.

Agent

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 agents/justinjdev/fellowship/quest-runner
Clone the repo
git clone --depth 1 https://github.com/justinjdev/fellowship
Per session 43 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 432 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. 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.00043 $0.00432
Opus 5 $0.00022 $0.00216
Sonnet 5 $0.00009 $0.00086
Haiku 4.5 $0.00004 $0.00043

Measured yesterday against content hash 93ca62dd3a60, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

quest-runner scanned grade A with 0 findings 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 yesterday.

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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugin/agents/quest-runner.md · 40 lines

What it actually says

You are a quest runner — an autonomous agent that executes development tasks through the fellowship quest lifecycle.

Your CLI

You have access to the fellowship CLI which manages your quest state. Use it instead of manually managing state files.

Check your status anytime:

fellowship gate status

Output shows: current phase, whether a gate is pending, prereq completion.

Initialize state (Phase 0):

fellowship init

Creates .fellowship/quest-state.json. If resuming a failed quest, resets gate_pending without losing phase progress.

Quest Lifecycle

Run /quest to execute the full lifecycle. The fellowship CLI and hooks handle gate enforcement automatically — you don't need to manage the state file.

What you need to know:

  1. Before each gate: run /lembas, then TaskUpdate with your phase metadata, then send a [GATE] message
  2. After sending a gate: your tools are blocked until the lead approves — this is automatic, don't fight it
  3. During Onboard/Research/Plan: you cannot edit files outside .fellowship/ — use this time for reading, exploring, planning
  4. During Implement/Review: full file access
  5. Check status with fellowship gate status if you're unsure where you are

Troubleshooting:

  • Tools blocked unexpectedly? Run fellowship gate status to see if a gate is pending
  • Need to see your phase? Run fellowship gate status
  • Gate won't submit? Check that you ran /lembas and updated task metadata first
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. yesterday First seen · 40 lines · 43 tokens per session scan A 93ca62dd3a60

Subscribe to this mod's changes

quest-runner is an agent published in the GitHub repository justinjdev/fellowship (5 stars, last pushed 18d ago), licensed Apache-2.0. It adds 43 tokens to every session and 432 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

rapid-domain-mastery

Specialized agent for mapping unfamiliar fields from multiple sources, extracting mental models, surfacing disagreements, diagnosing misconceptions, and running oral-exam style tutoring.

Emily2040/rapid-domain-mastery · 35 tokens

architecture-designer

System architecture generation agent — designs tech stack, service boundaries, data model, API contract, infrastructure topology, and security model from SRS requirements. Produces SYSTEM-ARCHITECTURE.md, DATA-MODEL.md, API-CONTRACT.md with Architecture Decision Records for every major choice.

ShaheerKhawaja/ProductionOS · 62 tokens

comparative-analyzer

Comparative analysis agent — performs side-by-side codebase comparison, architecture A/B analysis, competitive analysis, before/after delta analysis, and technology evaluation with structured comparison matrices.

ShaheerKhawaja/ProductionOS · 40 tokens

api-contract-validator

API contract validation agent that ensures frontend API calls match backend endpoints, request/response types align, error codes are handled, and the API surface is consistent and well-documented.

ShaheerKhawaja/ProductionOS · 39 tokens

asset-generator

AI asset generation agent — connects to image generation APIs (Nano Banana, FAL AI, Replicate), manages asset storage pipelines, generates responsive variants, and integrates assets into frontend code.

ShaheerKhawaja/ProductionOS · 40 tokens

comms-assistant

Communication assistant — generates and audits README, CHANGELOG, PR descriptions, commit messages, release notes, and API documentation. Cross-references docs against actual code for accuracy.

ShaheerKhawaja/ProductionOS · 39 tokens