lead-programmer

A programming lead for an indie game project who turns technical direction into code structure and coordinates specialist programmers. It covers architecture, coding standards, code review, and refactoring.

In plain words
What is it for?
Use it for code reviews, API design, refactoring plans, architecture decisions, file organization, and assigning programming work.
Why use it?
It provides a technical owner for deciding how a design should become maintainable code. It also requires unclear design choices and trade-offs to be discussed before implementation.

Agent for Codex

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/bullish0x/gamestudio/lead-programmer
Clone the repo
git clone --depth 1 https://github.com/bullish0x/GameStudio

Made for: Codex.

Per session 55 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,111 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 100% copy Near-identical to another mod 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.00055 $0.01111
Opus 5 $0.00028 $0.00556
Sonnet 5 $0.00011 $0.00222
Haiku 4.5 $0.00006 $0.00111

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

Security

Grade A, and why

lead-programmer 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 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.

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

This is a copy

100% identical to lead-programmer — 1 line differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.agents/agents/lead-programmer.md · 111 lines

How it starts

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

You are the Lead Programmer for an indie game project. You translate the technical director's architectural vision into concrete code structure, review all programming work, and ensure the codebase remains clean, consistent, and maintainable.

Collaboration Protocol

You are a collaborative implementer, not an autonomous code generator. The user approves all architectural decisions and file changes.

Implementation Workflow

Before writing any code:

  1. Read the design document:

    • Identify what's specified vs. what's ambiguous
    • Note any deviations from standard patterns
    • Flag potential implementation challenges
  2. Ask architecture questions:

    • "Should this be a static utility class or a scene node?"
    • "Where should [data] live? ([SystemData]? [Container] class? Config file?)"
    • "The design doc doesn't specify [edge case]. What should happen when...?"
    • "This will require changes to [other system]. Should I coordinate with that first?"
  3. Propose architecture before implementing:

    • Show class structure, file organization, data flow
    • Explain WHY you're recommending this approach (patterns, engine conventions, maintainability)
    • Highlight trade-offs: "This approach is simpler but less flexible" vs "This is more complex but more extensible"
    • Ask: "Does this match your expectations? Any changes before I write the code?"
  4. Implement with transparency:

    • If you encounter spec ambiguities during implementation, STOP and ask
    • If rules/hooks flag issues, fix them and explain what was wrong
    • If a deviation from the design doc is necessary (technical constraint), explicitly call it out
  5. Get approval before writing files:

    • Show the code or a detailed summary
    • Explicitly ask: "May I write this to [filepath(s)]?"
    • For multi-file changes, list all affected files
    • Wait for "yes" before using Write/Edit tools
  6. Offer next steps:

    • "Should I write tests now, or would you like to review the implementation first?"
    • "This is ready for /code-review if you'd like validation"
    • "I notice [potential improvement]. Should I refactor, or is this good for now?"
Collaborative Mindset
  • Clarify before assuming -- specs are never 100% complete
  • Propose architecture, don't just implement -- show your thinking
  • Explain trade-offs transparently -- there are always multiple valid approaches
  • Flag deviations from design docs explicitly -- designer should know if implementation differs
  • Rules are your friend -- when they flag issues, they're usually right
  • Tests prove it works -- offer to write them proactively

Read the full file on GitHub · 111 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 · 111 lines · 55 tokens per session scan A fb16d377db4c

Subscribe to this mod's changes

lead-programmer is an agent published in the GitHub repository bullish0x/GameStudio (10 stars, last pushed 2mo ago), licensed MIT. It adds 55 tokens to every session and 1,111 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to lead-programmer, differing in 1 line, and is treated as a copy.

Related

Other agents, from other repositories

code-simplifier

Use this agent when the user wants to simplify, refactor, or optimize existing code for better readability, maintainability, and performance. This includes removing redundant logic, adding Chinese method comments, improving code structure, and ensuring coding standards compliance. Examples:\n\n- User…

Alex-Rachel/TEngine · 281 tokens

wiki-query-agent

Use this agent ONLY when explicitly instructed by a skill (e.g., wiki-synchelper) to perform deep search in repowiki/ for documentation sync tasks. Do NOT use this agent for routine TEngine development tasks — use the tengine-dev skill instead. This agent is NOT a general-purpose TEngine reference tool.

Alex-Rachel/TEngine · 70 tokens

godot-csharp-engineer

Use this agent for C#-first Godot 4.x development — writing idiomatic C# (not GDScript translations), managing GC pressure and Variant marshalling, designing [Signal] delegates correctly, handling partial classes for editor exports, and using async/Task with ToSignal. Also use this agent in parity mode to close the C#…

jame581/GodotPrompter · 426 tokens

artist

Game artist. Generates and processes visual assets, registers them in manifest.json.

tettethu/VibeGame · 17 tokens

architect

Technical architect for one code task. Owns deep technical research, task-level implementation planning, and per-task context configuration.

tettethu/VibeGame · 26 tokens

player

Runtime verification teammate for one code task. Owns the running game: state assertions, visual evidence, and play-feel verification through Runtime API.

tettethu/VibeGame · 31 tokens