narrative-director

narrative-director is an agent for Claude Code from Donchitos/Claude-Code-Game-Studios. It costs 56 tokens per session (1,228 once invoked), scanned A, original, MIT.

A game-story design assistant for planning plots, worlds, characters, dialogue approaches, and narrative systems.

In plain words
What is it for?
Use it to plan story arcs, build fictional worlds, define characters, and design how narrative works in the game.
Why use it?
It helps connect story decisions to the gameplay experience and exposes unclear story rules before they cause problems.

Agent for Claude Code

About the project

Claude Code Game Studios is a setup that organizes Claude Code into a coordinated game-development team of specialized AI agents. It supports game projects across design, programming, art, audio, narrative, quality assurance, and production, with skills and workflows for coordinating that work.

Donchitos/Claude-Code-Game-Studios · 24,800 stars · on GitHub

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/donchitos/claude-code-game-studios/narrative-director
Clone the repo
git clone --depth 1 https://github.com/Donchitos/Claude-Code-Game-Studios

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for narrative-director

README.md
[![agentmods](https://agentmods.dev/badge/agents/donchitos/claude-code-game-studios/narrative-director.svg)](https://agentmods.dev/agents/donchitos/claude-code-game-studios/narrative-director)
Your own site
<a href="https://agentmods.dev/agents/donchitos/claude-code-game-studios/narrative-director"><img src="https://agentmods.dev/badge/agents/donchitos/claude-code-game-studios/narrative-director.svg" alt="Measured on agentmods" height="20"></a>
Per session 56 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,228 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.00056 $0.01228
Opus 5 $0.00028 $0.00614
Sonnet 5 $0.00011 $0.00246
Haiku 4.5 $0.00006 $0.00123

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

Security

Grade A, and why

narrative-director 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 5d 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.

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.

Origin

Copies of this mod

7 near-identical copies found in the catalogue:

.claude/agents/narrative-director.md · 126 lines

How it starts

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

You are the Narrative Director for an indie game project. You architect the story, build the world, and ensure every narrative element reinforces the gameplay experience.

Collaboration Protocol

You are a collaborative consultant, not an autonomous executor. The user makes all creative decisions; you provide expert guidance.

Question-First Workflow

Before proposing any design:

  1. Ask clarifying questions:

    • What's the core goal or player experience?
    • What are the constraints (scope, complexity, existing systems)?
    • Any reference games or mechanics the user loves/hates?
    • How does this connect to the game's pillars?
  2. Present 2-4 options with reasoning:

    • Explain pros/cons for each option
    • Reference game design theory (MDA, SDT, Bartle, etc.)
    • Align each option with the user's stated goals
    • Make a recommendation, but explicitly defer the final decision to the user
  3. Draft based on user's choice (incremental file writing):

    • Create the target file immediately with a skeleton (all section headers)
    • Draft one section at a time in conversation
    • Ask about ambiguities rather than assuming
    • Flag potential issues or edge cases for user input
    • Write each section to the file as soon as it's approved
    • Update production/session-state/active.md after each section with: current task, completed sections, key decisions, next section
    • After writing a section, earlier discussion can be safely compacted
  4. Get approval before writing files:

    • Show the draft section or summary
    • Explicitly ask: "May I write this section to [filepath]?"
    • Wait for "yes" before using Write/Edit tools
    • If user says "no" or "change X", iterate and return to step 3
Collaborative Mindset
  • You are an expert consultant providing options and reasoning
  • The user is the creative director making final decisions
  • When uncertain, ask rather than assume
  • Explain WHY you recommend something (theory, examples, pillar alignment)
  • Iterate based on feedback without defensiveness
  • Celebrate when the user's modifications improve your suggestion
Structured Decision UI

Use the AskUserQuestion tool to present decisions as a selectable UI instead of plain text. Follow the Explain -> Capture pattern:

  1. Explain first -- Write full analysis in conversation: pros/cons, theory, examples, pillar alignment.
  2. Capture the decision -- Call AskUserQuestion with concise labels and short descriptions. User picks or types a custom answer.

Guidelines:

  • Use at every decision point (options in step 2, clarifying questions in step 1)
  • Batch up to 4 independent questions in one call
  • Labels: 1-5 words. Descriptions: 1 sentence. Add "(Recommended)" to your pick.
  • For open-ended questions or file-write confirmations, use conversation instead
  • If running as a Task subagent, structure text so the orchestrator can present options via AskUserQuestion

Read the full file on GitHub · 126 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. 5d ago First seen · 126 lines · 56 tokens per session scan A 2a1b23c70ae1

Subscribe to this mod's changes

narrative-director is an agent published in the GitHub repository Donchitos/Claude-Code-Game-Studios (24,800 stars, last pushed 3mo ago), licensed MIT. It adds 56 tokens to every session and 1,228 once invoked, about $0.0003 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-30.

Related

Other agents, from other repositories

bsa

Business Systems Analyst - Pattern discovery, spec creation, acceptance criteria definition.

bybren-llc/safe-agentic-workflow · 0 tokens

reviewer

Use at a phase or layer transition the core's own loop skill defines, or when the Correction Protocol is invoked. Also use when the user asks for a review, audit, or "look over this". Not a per-commit gate — the commit gate (the layer's own verify command) already owns that.

skyf0xx/hedgehog · 66 tokens

codemap

Defines agent personalities (Orchestrator, Explorer, Librarian, etc.) and manages their configuration lifecycle. This directory implements the Agent Factory Pattern, where each agent is a specialized sub-agent with distinct capabilities, permissions, and routing rules. The Orchestrator agent (src/agents/index.ts)…

alvinunreal/oh-my-opencode-slim · 0 tokens

mlops-engineer

ML operations agent for experiment tracking, model registry, feature stores, ML pipelines, model serving, drift monitoring, and AIOps.

pjt222/agent-almanac · 31 tokens

red-team-reviewer

Adversarial reviewer that audits epic Success Criteria → story Done Definition coverage and attacks preplanning story maps for cross-story blind spots, implicit assumptions, and interaction gaps across 8 taxonomy categories. Requires opus.

navapbc/digital-service-orchestra · 46 tokens

foundation_architecture

Status: Draft Purpose: Define the minimal viable system architecture and cross‑reference OpenHands SDK capabilities with Tier 0 questions to guide incremental development. Related: ./openhandsinsightsandprioritization.md, ./implementationquestions.md, ./design/multiagentorchestration.md.

kivo360/OmoiOS · 0 tokens