agent-foundry plugin
99 task-first skills with unified cross-domain orchestration and Unity CLI readiness; pair with Unity’s official specialist plugin.
How to install the agent-foundry plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add furkantokkan/agent-foundry
/plugin install agent-foundry@agent-foundryWhat's inside agent-foundry
109 parts read from the plugin's own files.
Commands 7
Run as /agent-foundry:name- /agent-foundry:ada[task]
Adaptive skill router for Unity, Firebase, JavaScript, Clean OOP, code review, and game design tasks.
- /agent-foundry:clean-oop[architecture-or-refactor-task]
Apply SOLID, Clean Code, dependency boundaries, and testability.
- /agent-foundry:code-review[task]
Performs an architectural and quality code review on a specified file or set of files. Checks for coding standard compliance, architectural pattern adherence, SOLID principles, testability, and performance concerns.
- /agent-foundry:firebase-game-api[firebase-api-task]
Build or review Firebase Functions game APIs for Unity clients.
- /agent-foundry:game-design[design-task]
Design game systems, GDDs, loops, economy, pacing, and criteria.
- /agent-foundry:js-game-tools[javascript-task]
Work on JavaScript or TypeScript game tooling and Firebase code.
- /agent-foundry:unity-dev[unity-task]
Work on a Unity task using the repository's canonical architecture, ownership, automation, and verification policies.
Agents 3
Call as @agent-agent-foundry:name- @agent-agent-foundry:unity-bugfixersonnet
Fixes one revision-locked, task-owned Unity defect handoff through an exact red-capable reproduction and surgical change, then returns FIXED_UNVERIFIED for independent verification.
- @agent-agent-foundry:unity-feature-implementersonnet
Implement one revision-locked Unity task contract in its assigned code lane or checkout, keep production changes inside exact ownership, and produce an evidence-backed verifier handoff without claiming task completion.
- @agent-agent-foundry:unity-test-verifiersonnet
Independently verifies one revision-locked Unity task handoff, protects test integrity, classifies evidence and reproducible failures, and never owns production fixes or task closure.
Skills 99
Claude loads it when the task matches- adaptive-skills
Use when a task may span multiple personal skills and Codex should choose the smallest relevant skill set across Unity, Unity performance, Clean OOP, Firebase backend, JavaScript tooling, game design/UX, tracked task lifecycle, Steam launch, code review, and web/SaaS work.
- adopt
Brownfield onboarding — audits existing project artifacts for template format compliance (not just existence), classifies gaps by impact, and produces a numbered migration plan. Run this when joining an in-progress project or upgrading from an older template version. Distinct from /project-stage-detect (which checks what exists) — this checks whether what exists will actually work with the template's skills.
- agent-orchestration
Coordinate game, Unity, web, SaaS, and tooling work through one orchestration workflow across Claude and Codex. Resolve tracked task IDs, ownership conflicts, worktrees, sequential role handoffs, Editor queues, capacity, and verification. Use for orchestration or independent deliverables; keep one small task in the current agent.
- architecture-decision
Creates an Architecture Decision Record (ADR) documenting a significant technical decision, its context, alternatives considered, and consequences. Every major technical choice should have an ADR.
- architecture-review
Validates completeness and consistency of the project architecture against all GDDs. Builds a traceability matrix mapping every GDD technical requirement to ADRs, identifies coverage gaps, detects cross-ADR conflicts, verifies engine compatibility consistency across all decisions, and produces a PASS/CONCERNS/FAIL verdict. The architecture equivalent of /design-review.
- art-bible
Guided, section-by-section Art Bible authoring. Creates the visual identity specification that gates all asset production. Run after /brainstorm is approved and before /map-systems or any GDD authoring begins.
- asset-audit
Audits game assets for compliance with naming conventions, file size budgets, format standards, and pipeline requirements. Identifies orphaned assets, missing references, and standard violations.
- asset-spec
Generate per-asset visual specifications and AI generation prompts from GDDs, level docs, or character profiles. Produces structured spec files and updates the master asset manifest. Run after art bible and GDD/level design are approved, before production begins.
- balance-check
Analyzes game balance data files, formulas, and configuration to identify outliers, broken progressions, degenerate strategies, and economy imbalances. Use after modifying any balance-related data or design. Use when user says 'balance report', 'check game balance', 'run a balance check'.
- brainstorm
Guided game concept ideation — from zero idea to a structured game concept document. Uses professional studio ideation techniques, player psychology frameworks, and structured creative exploration.
- bug-report
Creates a structured bug report from a description, or analyzes code to identify potential bugs. Ensures every bug report has full reproduction steps, severity assessment, and context.
- bug-triage
Read all open bugs in production/qa/bugs/, re-evaluate priority vs. severity, assign to sprints, surface systemic trends, and produce a triage report. Run at sprint start or when the bug count grows enough to need re-prioritization.
- changelog
Auto-generates a changelog from git commits, sprint data, and design documents. Produces both internal and player-facing versions.
- clean-oop-architecture
Use for SOLID, Clean Code, and maintainable object-oriented design, including Unity C#. Covers dependency boundaries, DI, ServiceLocator, Onity, design patterns, testability, naming, code smells, refactoring, overengineering risk, surgical changes, and goal-driven verification.
- consistency-check
Scan all GDDs against the entity registry to detect cross-document inconsistencies: same entity with different stats, same item with different values, same formula with different variables. Grep-first approach — reads registry then targets only conflicting GDD sections rather than full document reads.
- content-audit
Audit GDD-specified content counts against implemented content. Identifies what's planned vs built.
- create-architecture
Guided, section-by-section authoring of the master architecture document for the game. Reads all GDDs, the systems index, existing ADRs, and the engine reference library to produce a complete architecture blueprint before any code is written. Engine-version-aware: flags knowledge gaps and validates decisions against the pinned engine version.
- create-control-manifest
After architecture is complete, produces a flat actionable rules sheet for programmers — what you must do, what you must never do, per system and per layer. Extracted from all Accepted ADRs, technical preferences, and engine reference docs. More immediately actionable than ADRs (which explain why).
- create-epics
Optionally group a large approved GDD/architecture outcome into an epic that owns several independently closable task contracts. Use for multi-task roadmap planning, not routine bugs or bounded features. In the canonical task-first workflow create tasks directly after the epic; do not add a separate story layer.
- create-stories
Legacy-only workflow that breaks an epic into separate story files when a repository explicitly retains the old epic/story pipeline. Do not use in the canonical task-first workflow, where create-task already produces the implementable and closable contract.
- create-task
Create one tracked task contract, which is also the implementable story, from a request, brief, task ID, or attached references without implementing it. Use separate story files only in an explicitly legacy story repository.
- daily-handoff
Create a concise, durable end-of-day handoff for one or more tracked production tasks, covering status, completed work, changed systems, verification evidence, blockers, next commands, and commit state. Use when the user invokes $daily-handoff, asks for today's multi-task handoff, or needs a compact file-backed recovery checkpoint without changing task lifecycle state, running tests, mutating Unity, or committing work.
- day-one-patch
Prepare a day-one patch for a game launch. Scopes, prioritises, implements, and QA-gates a focused patch addressing known issues discovered after gold master but before or immediately after public launch. Treats the patch as a mini-sprint with its own QA gate and rollback plan.
- design-review
Reviews a game design document for completeness, internal consistency, implementability, and adherence to project design standards. Run this before handing a design document to programmers.
- design-system
Guided, section-by-section GDD authoring for a single game system. Gathers context from existing docs, walks through each required section collaboratively, cross-references dependencies, and writes incrementally to file.
- dev-story
Read a story file and implement it. Loads the full context (story, GDD requirement, ADR guidelines, control manifest), routes to the right programmer agent for the system and engine, implements the code and test, and confirms each acceptance criterion. The core implementation skill — run after /story-readiness, before /code-review and /story-done.
- estimate
Estimates task effort by analyzing complexity, dependencies, historical velocity, and risk factors. Produces a structured estimate with confidence levels.
- firebase-game-backend
Use for Firebase-backed game features in Unity or JavaScript, including Auth, Firestore, Realtime Database, Cloud Functions Gen2 with Express APIs, typed Unity request/response clients, Remote Config, App Check, security rules, emulators, deployment, and client/server boundaries.
- game-code-review
Use when reviewing game code or architecture, especially Unity C#, Firebase rules/functions, JavaScript/TypeScript tooling, gameplay systems, UI code, async code, dependency injection, tests, performance hot paths, and security-sensitive backend code.
- game-design-studio
Use for game design work, including GDDs, core loops, player fantasy, mechanics and systems, economy and balance intent, pacing and risk/reward, fail states, onboarding and UX requirements, and implementable acceptance criteria.
- game-feel-polish
Add or tune game feel and UI polish (juice) for a feature, menu, HUD, or hit. Covers screen shake, hitstop and slow motion, punch and squash tweens, hit flash, pooled damage numbers, toast stacks, animated counters and lag bars, staggered menu intros, CRT screen looks, and pooled SFX banks, using the Liquid UI architecture adapted to Unity UI Toolkit, with Godot source references. Use when a request says Liquid UI, juice, feel, feedback, impact, polish this menu/HUD/hit, or asks why an action feels flat.
- game-studio-orchestration
Compatibility alias for agent-orchestration; forward all existing task IDs, flags, constraints, and authorization unchanged.
- gate-check
Validate readiness to advance between development phases. Produces a PASS/CONCERNS/FAIL verdict with specific blockers and required artifacts. Use when user says 'are we ready to move to X', 'can we advance to production', 'check if we can start the next phase', 'pass the gate'.
- help
Analyzes what is done and the users query and offers advice on what to do next. Use if user says what should I do next or what do I do now or I'm stuck or I don't know what to do
- hotfix
Emergency fix workflow that bypasses normal sprint processes with a full audit trail. Creates hotfix branch, tracks approvals, and ensures the fix is backported correctly.
- implement-task
Implement a ready task ID, contract, story, or one bounded ad-hoc change with focused verification, closing a clean empty-ledger task when every gate passes and policy allows. Also runs on a plain continue or an explicit criteria acceptance for the sole retained task. New bug feedback goes to task-bug.
- javascript-game-tools
Use when building JavaScript or TypeScript tooling around a game project, including Firebase web apps, admin dashboards, build tools, data editors, content pipelines, Node scripts, Cloud Functions, React/Vite/Next frontends, package setup, linting, tests, and browser tooling.
- launch-checklist
Complete launch readiness validation covering every department: code, content, store, marketing, community, infrastructure, legal, and go/no-go sign-offs.
- localize
Full localization pipeline: scan for hardcoded strings, extract and manage string tables, validate translations, generate translator briefings, run cultural/sensitivity review, manage VO localization, test RTL/platform requirements, enforce string freeze, and report coverage.
- map-systems
Decompose a game concept into individual systems, map dependencies, prioritize design order, and create the systems index.
+59
Using agent-foundry in Claude Code
Type a command in a Claude Code session:
/agent-foundry:ada [task]
/agent-foundry:clean-oop [architecture-or-refactor-task]
/agent-foundry:code-review [task]Ask for an agent by name:
@agent-agent-foundry:unity-bugfixer
@agent-agent-foundry:unity-feature-implementerSkills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update agent-foundry@agent-foundry
- Refresh the marketplace
- /plugin marketplace update agent-foundry
- Turn it off for now
- /plugin disable agent-foundry@agent-foundry
- Remove it
- /plugin uninstall agent-foundry@agent-foundry
Skills in agent-foundry
- task-donefurkantokkan/agent-foundry
Close one or more exact tracked tasks. Invoke automatically for an explicit user close order in a tool command or ordinary language; use --strict to require satisfied acceptance criteria.
2 files13stars - unity-clifurkantokkan/agent-foundry
Unity CLI operating contract for every Unity task. Prove the exact project and Editor, choose CLI or built-in MCP transport, run Roslyn and focused test checks, apply ownership and risk gates, and install the official CLI safely. For idea-to-project setup use unity:new-unity-project.
20 files13stars - agent-orchestrationfurkantokkan/agent-foundry
Coordinate game, Unity, web, SaaS, and tooling work through one orchestration workflow across Claude and Codex. Resolve tracked task IDs, ownership conflicts, worktrees, sequential role handoffs, Editor queues, capacity, and verification. Use for orchestration or independent deliverables; keep one small task in the current agent.
8 files13stars - bug-reportfurkantokkan/agent-foundry
Creates a structured bug report from a description, or analyzes code to identify potential bugs. Ensures every bug report has full reproduction steps, severity assessment, and context.
2 files13stars - clean-oop-architecturefurkantokkan/agent-foundry
Use for SOLID, Clean Code, and maintainable object-oriented design, including Unity C#. Covers dependency boundaries, DI, ServiceLocator, Onity, design patterns, testability, naming, code smells, refactoring, overengineering risk, surgical changes, and goal-driven verification.
8 files13stars - create-taskfurkantokkan/agent-foundry
Create one tracked task contract, which is also the implementable story, from a request, brief, task ID, or attached references without implementing it. Use separate story files only in an explicitly legacy story repository.
3 files13stars - daily-handofffurkantokkan/agent-foundry
Create a concise, durable end-of-day handoff for one or more tracked production tasks, covering status, completed work, changed systems, verification evidence, blockers, next commands, and commit state. Use when the user invokes $daily-handoff, asks for today's multi-task handoff, or needs a compact file-backed recovery checkpoint without changing task lifecycle state, running tests, mutating Unity, or committing work.
2 files13stars - firebase-game-backendfurkantokkan/agent-foundry
Use for Firebase-backed game features in Unity or JavaScript, including Auth, Firestore, Realtime Database, Cloud Functions Gen2 with Express APIs, typed Unity request/response clients, Remote Config, App Check, security rules, emulators, deployment, and client/server boundaries.
5 files13stars - game-feel-polishfurkantokkan/agent-foundry
Add or tune game feel and UI polish (juice) for a feature, menu, HUD, or hit. Covers screen shake, hitstop and slow motion, punch and squash tweens, hit flash, pooled damage numbers, toast stacks, animated counters and lag bars, staggered menu intros, CRT screen looks, and pooled SFX banks, using the Liquid UI architecture adapted to Unity UI Toolkit, with Godot source references. Use when a request says Liquid UI, juice, feel, feedback, impact, polish this menu/HUD/hit, or asks why an action feels flat.
8 files13stars - implement-taskfurkantokkan/agent-foundry
Implement a ready task ID, contract, story, or one bounded ad-hoc change with focused verification, closing a clean empty-ledger task when every gate passes and policy allows. Also runs on a plain continue or an explicit criteria acceptance for the sole retained task. New bug feedback goes to task-bug.
3 files13stars - skill-improvefurkantokkan/agent-foundry
Improve one skill with a predictable scoped test-fix-retest loop. Diagnose completion, routing, invocation, duplication, and instruction hygiene as well as structural checks; apply only when explicitly requested.
2 files13stars - steam-store-launchfurkantokkan/agent-foundry
Use when planning, drafting, auditing, or launching a Steam Coming Soon or store page for an indie game, including Steamworks requirements, capsules, screenshots, trailer, copy, tags, wishlist strategy, competitor research, press and creator CRM, festivals, Steam Next Fest, Reddit/social announce posts, UTM tracking, and launch readiness.
6 files13stars - story-donefurkantokkan/agent-foundry
Backward-compatible alias for task-done when given a task ID or task contract path, plus the legacy completion review for an explicit story file. Use only for compatibility; canonical tracked-task closure is $task-done.
2 files13stars - task-bugfurkantokkan/agent-foundry
Intake new post-implementation bug feedback or explicit task-bug commands. Resolve the one tracked task that owns the failed behavior and send the raw evidence to task-cycle without pre-classifying it; feedback with no task match goes once to create-task.
2 files13stars - task-cyclefurkantokkan/agent-foundry
Run the defect lifecycle for one resolved tracked task. Confirms matches, owns the defect ledger and linked evidence, runs bounded repair and verification, reopens safely, and closes when every gate passes and policy allows. New bug feedback enters through task-bug first.
5 files13stars - task-statusfurkantokkan/agent-foundry
Show a fast read-only snapshot for one or more tracked tasks from each contract's managed lifecycle block, including phase, changed paths, evidence, blockers, decisions, and next command. Use for progress checks without running tests, writing status files, changing task state, or starting a cycle.
2 files13stars - team-qafurkantokkan/agent-foundry
Orchestrate an evidence-backed QA cycle for tracked tasks, a sprint, or a feature. Route failures to task-bug, bug-report, or create-task without duplicating defect ownership.
2 files13stars - unity-agentic-workflowfurkantokkan/agent-foundry
Design, teach, audit, or bootstrap a professional Claude Code and Codex workflow for a Unity repository. Use when deciding which Markdown file owns a rule, writing prompts or slash commands, choosing single-agent versus sequential role handoffs or worktrees, reconciling provider instructions, or finding gaps in an existing Unity agent setup.
6 files13stars - unity-game-devfurkantokkan/agent-foundry
Use when working on Unity game projects, especially Unity 6, C# gameplay systems, UI Toolkit or UGUI, Addressables, Input System, UniTask, Onity, ServiceLocator, tests, performance, project structure, package setup, and Unity-specific architecture decisions.
8 files13stars - unity-grid-drag-puzzlefurkantokkan/agent-foundry
Implement or reconstruct a Unity grid drag puzzle with irregular multi-cell pieces, pointer ownership, collision-safe previews, axis constraints, matching exit gates, and validated board commands. Use for block sliding and gate exits, not general drag-and-drop UI.
3 files13stars - unity-grid-level-editorfurkantokkan/agent-foundry
Implement a Unity UI Toolkit grid level editor with pure edit commands, irregular-piece transforms, grouped Undo, reload-safe transient drafts, exact-source saving, bounded solver validation, and isolated test play. Use for puzzle authoring tools that share rules with runtime.
3 files13stars - unity-grid-puzzle-effectsfurkantokkan/agent-foundry
Implement composable Unity grid puzzle effects such as movement arrows, ice counters, cell barriers, and booster restrictions using typed metadata, per-attempt state, shared rule hooks, and semantic board events. Use when extending a grid puzzle without putting effect logic in input or views.
3 files13stars - unity-life-economyfurkantokkan/agent-foundry
Implement Unity lives or energy regeneration with UTC refill arithmetic, offline progress, atomic paid refills, stable save IDs, attempt-level life charging, and cancellation-safe UI flows. Use for timed consumable currencies, not general economy balancing or anti-cheat.
3 files13stars - unity-optimizationfurkantokkan/agent-foundry
Use when profiling, diagnosing, optimizing, or reviewing Unity performance, including CPU/GPU bottlenecks, GC allocations, Update/Input/UI hot paths, physics cost, rendering, shaders, batching, Addressables/loading, mobile thermal/battery constraints, memory, and before/after performance evidence.
2 files13stars - unity-transactional-boostersfurkantokkan/agent-foundry
Implement Unity consumable boosters with inventory-backed targeting, immutable use intents, atomic save debits, cancellation-safe completion, starting-booster selection, opening phases, and pause/restart rules. Use when a booster must be paid for durably before changing gameplay.
3 files13stars - adaptive-skillsfurkantokkan/agent-foundry
Use when a task may span multiple personal skills and Codex should choose the smallest relevant skill set across Unity, Unity performance, Clean OOP, Firebase backend, JavaScript tooling, game design/UX, tracked task lifecycle, Steam launch, code review, and web/SaaS work.
13stars - game-code-reviewfurkantokkan/agent-foundry
Use when reviewing game code or architecture, especially Unity C#, Firebase rules/functions, JavaScript/TypeScript tooling, gameplay systems, UI code, async code, dependency injection, tests, performance hot paths, and security-sensitive backend code.
13stars - verification-before-completionfurkantokkan/agent-foundry
Use when preparing to say a change is complete, a defect is fixed, checks pass, or a commit or release is ready.
13stars - adoptfurkantokkan/agent-foundry
Brownfield onboarding — audits existing project artifacts for template format compliance (not just existence), classifies gaps by impact, and produces a numbered migration plan. Run this when joining an in-progress project or upgrading from an older template version. Distinct from /project-stage-detect (which checks what exists) — this checks whether what exists will actually work with the template's skills.
2 files13stars - architecture-decisionfurkantokkan/agent-foundry
Creates an Architecture Decision Record (ADR) documenting a significant technical decision, its context, alternatives considered, and consequences. Every major technical choice should have an ADR.
2 files13stars
agent-foundry plugin questions
How do I install the agent-foundry plugin?
In Claude Code run /plugin marketplace add furkantokkan/agent-foundry, then /plugin install agent-foundry@agent-foundry.
What does the agent-foundry plugin include?
agent-foundry bundles 7 commands, 3 agents, 99 skills.
What commands does the agent-foundry plugin add?
It adds /agent-foundry:ada, /agent-foundry:clean-oop, /agent-foundry:code-review, /agent-foundry:firebase-game-api, /agent-foundry:game-design, /agent-foundry:js-game-tools +1. Run them in Claude Code with the plugin prefix, for example /agent-foundry:ada.
Which agents come with agent-foundry?
unity-bugfixer, unity-feature-implementer, unity-test-verifier. Call one with @agent-agent-foundry:unity-bugfixer.
How do I update or remove the agent-foundry plugin?
Update it with claude plugin update agent-foundry@agent-foundry in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall agent-foundry@agent-foundry.
What license is the agent-foundry plugin under?
MIT, as stated in the plugin's manifest.