api-platform-architect

api-platform-architect is an agent for Claude Code from gerard-labs/superpowers-api-platform. It costs 107 tokens per session (2,948 once invoked), scanned A, original, MIT.

A read-only planning assistant for API Platform 4.3 projects built with Symfony 7.4 or newer. API Platform is a framework for building web APIs, and Symfony is a PHP framework.

In plain words
What is it for?
Use it to plan new or changed API resources, endpoints, filters, data providers, processors, security, pagination, versioning, errors, and related tests.
Why use it?
It turns a feature request into a structured technical plan without changing code. It also accounts for the specific part of the API involved, such as security, filtering, or file uploads.

Agent for Claude Code

Written for Claude Code: effort in frontmatter. Also seen: model in frontmatter; reads .claude/ paths; mentions subagents.

Part of the gerard plugin — 53 skills, 25 commands, 7 agents, 1 hook shipped together

Good fit Use it to plan new or changed API resources, endpoints, filters, data providers, processors, security, pagination, versioning, errors, and related tests.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/gerard-labs/superpowers-api-platform/api-platform-architect
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.

Clone the repo
git clone --depth 1 https://github.com/gerard-labs/superpowers-api-platform

Made for: Claude Code.

Or install gerard, the plugin that ships this one along with the rest of its 53 skills, 25 commands, 7 agents, 1 hook.

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 api-platform-architect

README.md
[![agentmods](https://agentmods.dev/badge/agents/gerard-labs/superpowers-api-platform/api-platform-architect/github.svg)](https://agentmods.dev/agents/gerard-labs/superpowers-api-platform/api-platform-architect)
Your own site
<a href="https://agentmods.dev/agents/gerard-labs/superpowers-api-platform/api-platform-architect"><img src="https://agentmods.dev/badge/agents/gerard-labs/superpowers-api-platform/api-platform-architect/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for api-platform-architect

Your own site · 80×15
<a href="https://agentmods.dev/agents/gerard-labs/superpowers-api-platform/api-platform-architect"><img src="https://agentmods.dev/badge/agents/gerard-labs/superpowers-api-platform/api-platform-architect.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 107 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,948 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00107 $0.02948
Opus 5.5 $0.00043 $0.01179
Sonnet 5.5 $0.00021 $0.00590
Haiku 4.5 $0.00011 $0.00295

Measured 1mo ago against content hash 459c9425e440, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

api-platform-architect 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 1mo 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.

agents/api-platform-architect.md · 223 lines

How it starts

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

API Platform Architect Agent

You are a Senior API Platform 4.3 architect on Symfony 7.4+. You produce a plan, you never edit. Each line in your plan is a contract that the implementer will follow.

⛔ First action — Read the prior plan if it exists

If .claude/last-api-plan.md exists from a previous iteration, Read it first. You may be invoked in a REQUEST_CHANGES loop — the prior plan gives you context for incremental refinement, not a clean restart.

Authority order — local skill overrides

Before dispatching a skill gerard:X, check via Glob whether <project-name>:X exists under .claude/skills/*/X/SKILL.md. If yes, dispatch the project skill in priority (project doctrine overrides plugin canon).

Project skills naming convention: <project-name>:<skill-name> (e.g. gerard:form-contract). See docs/symfony/project-skills-pattern.md.

⛔ Story-shape × API Platform area detection

Before writing anything, classify the story along TWO dimensions:

Story shape

Shape Cues Mandatory sections
feature new resource / operation / endpoint 1-9 (canonical)
refactor restructure existing resource, switch DTO ↔ Object Mapper 1-3, 5, 6, 7, 9
migration upgrade 3.x / 4.0–4.2 → 4.3 "Findings inventory" + 6, 7 (skip test matrix — see gerard:api-platform-upgrade)
hardening / security audit rate-limit, voters, CSP, CORS, JWT rotation "Findings inventory" + 5, 6, 8
docs-only docstrings, README, ADR 1 paragraph + 6 + 7 (no test matrix)

API Platform area

Area Indicators Skills to dispatch
resource new #[ApiResource], operations, subresources gerard:api-platform-resources, gerard:api-platform-dto-resources
filter search, sort, range, full-text gerard:api-platform-filters
provider read transformation, header-versioned, multi-source gerard:api-platform-state-providers
processor write, async, CQRS bridging gerard:api-platform-state-processors, gerard:api-platform-resilience
security voters, JWT, OIDC, CORS, property security gerard:api-platform-security, gerard:symfony-voters, gerard:rate-limiting
serialization groups, BackedEnum, Context, MaxDepth gerard:api-platform-serialization
pagination partial, cursor, UUID v7 gerard:api-platform-pagination, gerard:api-platform-identifiers
versioning v1/v2, deprecation, Sunset gerard:api-platform-versioning
mcp expose to AI agent gerard:api-platform-mcp
mutator uniform routePrefix, group injection gerard:api-platform-mutators
errors RFC 7807, ErrorResource gerard:api-platform-errors
user User entity, /me, password hashing gerard:api-platform-user
file-upload MediaObject, multipart, S3 gerard:api-platform-file-upload
performance cache tags, force_eager, FrankenPHP gerard:api-platform-performance
upgrade 3.x → 4.3 migration gerard:api-platform-upgrade

Read the full file on GitHub · 223 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. 1mo ago First seen · 223 lines · 107 tokens per session scan A 459c9425e440

Subscribe to this mod's changes

api-platform-architect is an agent published in the GitHub repository gerard-labs/superpowers-api-platform (2 stars, last pushed 5mo ago), licensed MIT. It adds 107 tokens to every session and 2,948 once invoked, about $0.0004 per session on Opus 5.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

api-platform-builder

Creates and configures API Platform resources with operations, DTOs, state providers, processors, and security. Handles full resource scaffolding from entity to tested API endpoint. Use for building APIs, creating resources, or configuring API Platform.

dev-toolings/superpowers-symfony · 50 tokens

symfony-engineer

Implements Symfony application code following framework best practices, drawing on the superpowers-symfony skill library. Use for general Symfony coding — controllers, services, dependency injection, value objects/DTOs, forms, Twig components, configuration — when no more specialized agent (api-platform-builder…

dev-toolings/superpowers-symfony · 76 tokens

fastapi-architect

Expert in building production FastAPI applications with modern Python patterns. Specializes in Pydantic v2 models, SQLAlchemy 2.0 async patterns, JWT auth, and API architecture.

andisab/swe-marketplace · 43 tokens

hexagonal-architect

Analyzes a Symfony project (6.4 LTS, 7.x, 8.x) for hexagonal architecture compliance, detects installed Symfony/PHP/Doctrine versions, designs module architecture, gives compliance scores (0-100) and version-aware recommendations. Read-only, never modifies code. Use for: architecture analysis, compliance score, module…

aligundogdu/symfony-hexagonal-skill · 79 tokens

do-setup-assistant

Autonomous Durable Objects project scaffolder. Analyzes user requirements and automatically sets up complete DO project with proper configuration, code, and tests.

secondsky/claude-skills · 35 tokens

doctrine-performance-optimizer

Read-only performance audit of Doctrine usage: N+1 queries, fetch modes, batch processing, missing indexes, and caching opportunities. Use proactively after adding entities, relations, repository queries, or when a page/endpoint is reported slow.

dev-toolings/superpowers-symfony · 53 tokens