К основному содержанию
плагин

production-fast-api-template — плагин Claude Code для production FastAPI с RAG и агентами

Плагин production-fast-api-template для Claude Code и Cursor задаёт стандарты backend-разработки на FastAPI с RAG и AI-агентами на AWS ECS Fargate. Описывает структуру проекта, async-выполнение, валидацию, оценку моделей и безопасность.

MIT ★ 3 785 обновлён 2026-10-25

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add davepoon/buildwithclaude
/plugin install production-fast-api-template@buildwithclaude
Открыть на GitHub

Что делает production-fast-api-template

Плагин предоставляет восемь связанных документов со стандартами и конвенциями: структура проекта, async-маршруты и фоновая обработка через SQS/Lambda, Pydantic v2 и структурированный вывод LLM, FastAPI dependencies и REST дизайн, guardrails с Bedrock и валидаторами, AI-оценка через DeepEval и Ragas, API-безопасность (JWT, RBAC, rate limiting) и безопасность LLM/агентов (OWASP Top 10).

Каждый документ разбирает конкретную фазу: откуда писать новый код, как валидировать данные, где ловить ошибки, какие метрики считать. Стандарты помечены как обязательные (🟢), опциональные (🟡) или требующие выбора с агентом. После установки плагин автоматически загружается, когда задача касается FastAPI, RAG или агентов; можно вызвать явно через /production-fast-api-template:production-fast-api-template.

Для существующего проекта плагин добавляет CLAUDE.md или AGENTS.md, которые указывают на стандарты — агент загружает их в каждой сессии. Требует Python, FastAPI, Pydantic v2, DeepEval и Ragas для полного стека.

Какие задачи решает

  • структурировать большой backend с RAG и аgentic AI в одной кодовой базе
  • написать async-маршруты, фоновую обработку и offload на Lambda без ошибок
  • валидировать структурированный вывод LLM и citation'ы через Pydantic
  • оценить качество RAG и агентов через DeepEval и Ragas
  • защитить API от OWASP Top 10 и агентов от injection и escape-атак

Примеры запросов агенту

  • Научи меня структурировать production FastAPI с RAG и агентами на AWS ECS Fargate
  • Помоги добавить async background task через SQS для обработки документов
  • Напиши валидацию для структурированного вывода LLM с retry'ями и обработкой ошибок

Как установить production-fast-api-template

Через маркетплейс плагинов

/plugin marketplace add davepoon/buildwithclaude
/plugin install production-fast-api-template@buildwithclaude

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о production-fast-api-template

Как установить production-fast-api-template в Claude Code?

Выполни команды по очереди: сначала /plugin marketplace add davepoon/buildwithclaude, затем /plugin install production-fast-api-template@buildwithclaude. Плагин появится в маркетплейсе Build with Claude.

Что делает production-fast-api-template?

Предоставляет восемь документов со стандартами для production FastAPI backend'а: структура проекта, async-выполнение, Pydantic-валидация, guardrails, AI-оценка, API-безопасность и безопасность LLM/агентов. Используется для scaffolding новых проектов и как always-on справочник для существующих.

Какие инструменты и библиотеки нужны для работы?

Python, FastAPI, Pydantic v2, DeepEval (версии 4.1.8 или 4.2.6), Ragas (версия 0.4.3), AWS SDK для ECS Fargate и SQS, Bedrock Guardrails для контента. Плагин работает в Claude Code и Cursor.

Исходный текст

production-fast-api-template · MIT
# Production FastAPI Template

A Claude Code plugin (and a portable agent skill for Cursor and other agentic IDEs). It captures the standards I use in my jobs to build production-ready, scalable applications: the structure and execution rules for a backend template that combines domain-oriented FastAPI, RAG and Agentic AI in one codebase on AWS ECS Fargate.

## Layout

```text
production-fast-api-template/
├── .claude-plugin/plugin.json           # plugin manifest
├── skills/
│   └── production-fast-api-template/    # the skill: SKILL.md + companion standards
└── README.md
```

The companion files must stay next to `SKILL.md`, which links to them relatively.

## Contents

| File | Purpose |
|---|---|
| [`SKILL.md`](skills/production-fast-api-template/SKILL.md) | The entry point. It covers the core structure rules, the canonical tree, a "where does new code go" table, RAG naming conventions, summaries of every companion file, and scaffolding steps. |
| [`ASYNC_EXECUTION.md`](skills/production-fast-api-template/ASYNC_EXECUTION.md) | The full standards for async and sync routes, thread-pool offloading, synchronous RAG, CPU-bound work, ECS Fargate scaling, SQS background processing, Lambda offload (under 15 min), Celery vs native SQS, cancellation and timeouts, monitoring and failure scenarios. |
| [`PYDANTIC_STANDARDS.md`](skills/production-fast-api-template/PYDANTIC_STANDARDS.md) | Pydantic v2 conventions: the shared `CustomModel`, the UTC datetime policy, domain schemas and `pydantic-settings`, structured LLM outputs (three validation levels, bounded retries), RAG citation validation, agent plan and tool-argument validation, async compatibility and testing. |
| [`API_CONVENTIONS.md`](skills/production-fast-api-template/API_CONVENTIONS.md) | FastAPI dependencies for validation and authorization (chaining, per-request caching, RAG access scopes, agent tool permissions), REST path naming, response serialization, `BackgroundTasks` vs the queue, 422 error messages, OpenAPI docs, database naming and SQL-first queries, migrations, async API tests with dependency overrides, and ruff. |
| [`GUARDRAILS.md`](skills/production-fast-api-template/GUARDRAILS.md) | Content-safety guardrails: pipeline checkpoints (ingestion, input, context, tool, output), the shared `src/guardrails/` layer and verdict contract, fail-closed handling, Bedrock Guardrails in AgentCore Policy (Cedar, input/output phases, schema data paths, response interpretation, log-only rollout), Guardrails AI validators, async offload, observability and privacy, and effectiveness evaluation. |
| [`AI_EVALUATION.md`](skills/production-fast-api-template/AI_EVALUATION.md) | AI evaluation with DeepEval and Ragas: runtime contracts vs the offline `evaluation/` suite, shared Pydantic contracts, metric catalogs checked against DeepEval 4.1.8/4.2.6 and Ragas 0.4.3 (collections API), RAG and per-stage retrieval evaluation, structured-output and citation checks, agent, multi-agent and conversational evaluation, custom metrics and rubrics, datasets and splits, tracing, execution, CI tiers, thresholds and reports, judge calibration, security, and API compatibility notes. |
| [`API_SECURITY.md`](skills/production-fast-api-template/API_SECURITY.md) | API security: authentication, JWT/JWKS, OAuth 2.0/OIDC, RBAC/ABAC and tenant isolation, input/upload/SSRF security, output and headers, request processing, distributed rate limiting, RAG and agent security, ECS Fargate/IAM/secrets, monitoring and audit events, CI/CD security, security tests, threat modeling and a control checklist mapped to OWASP API and LLM Top 10. |
| [`AGENT_SECURITY.md`](skills/production-fast-api-template/AGENT_SECURITY.md) | LLM and agent security: attack catalog, OWASP LLM Top 10 (2025) and Agentic Top 10 (2026) audit mappings, tool registry, authorization cards, argument and result validation, budgets, approvals, runtime isolation, audit, control baseline, testing plan, release gate and threat checklist. |

Conventions are marked 🟢. Open team decisions are marked 🟡, and agents are told to ask before choosing one.

## Install

**Claude Code (plugin, recommended).** From the Build with Claude marketplace:

```text
/plugin marketplace add davepoon/buildwithclaude
/plugin install production-fast-api-template@buildwithclaude
```

To try it from a local checkout without installing:
`claude --plugin-dir plugins/production-fast-api-template`.

**Claude Code (plain skill, no plugin).** Copy or symlink `skills/production-fast-api-template/`
to `~/.claude/skills/production-fast-api-template/` (all projects) or
`<repo>/.claude/skills/production-fast-api-template/` (one project).

**Other IDEs.**

- **IDEs that support `SKILL.md`:** copy `skills/production-fast-api-template/` into their skills directory.
- **Rules-file-only tools** (`AGENTS.md`, `.cursor/rules/`, and so on): paste in the body of `SKILL.md`, and put the seven companion files from `skills/production-fast-api-template/` alongside it.

**Validate after editing:** `claude plugin validate --strict plugins/production-fast-api-template`.
Bump `version` in `plugin.json` (and in the marketplace entry) when you publish changes.

## How it is applied

- **Skill (on demand):** the agent loads `SKILL.md` when a task matches the skill's `description`. That covers scaffolding, adding modules, and writing routes, dependencies, schemas, settings, queries, tests, LLM calls, guardrails, evaluations, security controls, tools or workers. In Claude Code you can also invoke it explicitly: as a plugin skill it is namespaced (`/production-fast-api-template:production-fast-api-template`); installed as a plain skill it is `/production-fast-api-template`.
- **Always-on enforcement:** the skill's scaffolding step writes a `CLAUDE.md` or `AGENTS.md` into each generated project, pointing at `docs/standards/*.md`. Those files are loaded in every session. For an existing project, add those lines yourself.

## Status

Phases covered:

1. Project structure
2. Async execution and background processing
3. Pydantic standards and structured LLM outputs
4. AI evaluation (DeepEval, Ragas, deterministic metrics)
5. API security, plus LLM and agent security

Also included: FastAPI dependencies, API design, database, migrations, testing and linting (`API_CONVENTIONS.md`), and guardrails and content safety (`GUARDRAILS.md`).

CI pipelines, infrastructure and deployment come in later phases.

© TrishamBP · MIT · davepoon/buildwithclaude

Похожие плагины

Все плагины по теме «Бэкенд и API» →
py-fast-api PatrickJS Правило py-fast-api для Cursor задаёт стиль разработки Python-бэкендов на FastAPI: структуру маршрутов, валидацию через Pydantic и обработку ошибок. Описывает рекомендации для создания и рефакторинга API. CX Codex +1 ★ 41 178звёзд репо deepeval Confident AI Добавляет метрики DeepEval — фреймворка для тестирования систем на больших языковых моделях. Запускает оценку агентов, RAG-пайплайнов и чат-ботов по критериям G-Eval, галлюцинаций, релевантности и выполнения задач. ★ 19 587звёзд репо api-scaffolding-fastapi-pro Seth Hobson Субагент api-scaffolding-fastapi-pro для Claude Code помогает проектировать и писать асинхронные API на FastAPI. Подключается к задачам по FastAPI, оптимизации async-кода и архитектуре API. CX Codex ★ 42 780звёзд репо python-api-endpoint-creator c0x12c Скилл python-api-endpoint-creator для Claude Code создаёт FastAPI-эндпоинты и CRUD-модули по слоистой схеме, добавляя сущности с тестами. CX Codex +1 ★ 111звёзд репо fastapi-expert https://github.com/Jeffallan Скилл fastapi-expert для Claude Code помогает разрабатывать асинхронные API на FastAPI с моделями Pydantic V2. Охватывает маршруты, аутентификацию, работу с базой и тесты. CX Codex +1 6 600установок fastapi itechmeat Помогает создавать Python API на FastAPI. Он включается при работе с REST-маршрутами, Pydantic-моделями, зависимостями и OAuth2/JWT. CX Codex +1 100установок

Из того же набора235

Весь набор →
baizhi-agent-toolkit Подключает Baizhi Agent Toolkit через удалённый MCP-сервер и добавляет отдельный скилл для исследований с лимитом вызовов. Нужны аккаунт Baizhi и API-ключ. ★ 3 785звёзд репо skyvern Подключает к Claude Code облачный браузер Skyvern через MCP: агент открывает страницы, заполняет формы, снимает скриншоты и вытаскивает данные. ★ 3 785звёзд репо equibles Подключает поиск по отчётности SEC, транскриптам звонков и биржевым данным США через облачный MCP-сервер Equibles. ★ 3 785звёзд репо midpoint-card-prices Плагин midpoint-card-prices для Claude Code показывает цены на коллекционные карточки и считает окупаемость грейдинга. Помогает оценивать карты, находить растущие позиции и проверять наборы. ★ 3 785звёзд репо cohesivity Подключает бэкенд-инфраструктуру cohesivity.ai к агенту. Позволяет разворачивать базы данных, контейнеры и хранилище без предварительной регистрации. ★ 3 785звёзд репо travel-agent-skill Плагин travel-agent-skill для Claude Code, который по одному запросу собирает полный план поездки: транспорт, достопримечательности, еда. Результат — HTML-страница со ссылками на бронирование и карты. ★ 3 785звёзд репо fabler-x402-tools Плагин fabler-x402-tools для Claude Code и Cursor включает девять MCP-инструментов для аудита контрактов, сбора данных с сайтов и рендера OG-превью; по умолчанию работает без кошелька. ★ 3 785звёзд репо fabler-relay fabler-relay — плагин для Claude Code и Cursor, который передаёт блокеры автономных агентов оператору, проверяет ответы и возобновляет работу. ★ 3 785звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой