convez.ai
SkillDesenvolvimento WebIntermediário
taimour1446

Claude Flask Builder

taimour1446/claude-flask-builder

Scaffolder de APIs Flask production-ready com arquitetura opinionada e gate de revisão dupla

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin de código Claude que scaffolda e estende APIs Flask REST em produção com arquitetura de 4 camadas (Controller/Service/Validation/Model). Inclui 1 skill + 4 agentes especializados com dupla gate de revisão e encoda 330+ correções de auditoria real de codebase produtivo.

Instalação

$npx convez-ai taimour1446/claude-flask-builder

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerar novas aplicações Flask com stack completo (SQLAlchemy, Alembic, JWT, Docker)
  • Estender APIs existentes com novos recursos (Controller + Service + Validation + Model + testes)
  • Garantir qualidade com revisão automática contra ruleset de 150+ padrões
  • Gerar documentação Swagger/OpenAPI automática a partir de schemas Marshmallow

Veredito

Excelente para equipes que precisam scaffoldar APIs Flask production-grade com governança integrada. O sistema de dupla revisão e 330+ correções pré-codificadas reduz drasticamente ciclos de correção. Recomendado para projetos com requisitos de segurança, padrão arquitetural e testes desde o início.

README

A tradução para o português deste README ainda está na fila.

claude-flask-builder

🤖 A Claude Code plugin — an AI agent system that scaffolds and extends production-grade Flask REST APIs on a fixed, opinionated 4-layer architecture (Controller / Service / Validation+DTO / Model).

It ships one skill and four specialized AI agents that work under a self-reviewing build loop. The skill encodes ~330 specific corrections distilled from 26 audit passes of a real production Flask codebase — so every scaffolded app starts with the security, correctness, and operational gaps already fixed.

What it does

  • Scaffolds a new Flask app: app factory, 4-layer architecture, JWT auth, Alembic, Flask-Seeder, RequestInterceptor, BaseResponse, Marshmallow validation+DTO, Stripe/Twilio/S3/GCS/Mail integration stubs, Docker, gunicorn entrypoint, pytest, CI.
  • Extends an existing app: adds a Controller + Service + Validation + DTO + Model + Alembic migration + pytest E2E, all gated by the reviewer.
  • Reviews code against a numbered ruleset (R01–R150+).
  • Builds + tests with flask-runner: pipenv install → DB up → Alembic upgrade → pytest with coverage, reports pass/fail.

The locked stack

ConcernChoice
LanguagePython 3.11+
FrameworkFlask (app factory + blueprints)
Package managerpipenv
ORMSQLAlchemy via Flask-SQLAlchemy
MigrationsAlembic via Flask-Migrate
SeedersFlask-Seeder (idempotent)
DBPostgreSQL default, MySQL switchable
ValidationMarshmallow (request schemas with error_messages)
SerializationMarshmallow (DTO schemas with @post_dump — NO DB queries inside)
AuthJWT (pyjwt) with exp + refresh tokens
MoneyNumeric / Decimal (NOT Float)
ResponseBaseResponse envelope (200 + error flag) — kept for client compat
LoggingStructured stdlib logging (NO print)
ContainerMulti-stage Dockerfile, non-root user, HEALTHCHECK, gunicorn
Testspytest + coverage (60% gate to start)

The agents

AgentRole
flask-scaffolderBootstraps a new Flask app
flask-feature-builderBuilds a vertical resource — gated by reviewer on both ends
flask-pattern-reviewerStrict standards gate (read-only)
flask-runnerBuilds, migrates, runs pytest, reports pass/fail

The double review gate

flask-feature-builder cannot write code until flask-pattern-reviewer has approved its plan, and cannot finish until the reviewer has approved its code. Failures loop back until they pass.

Auto-generated API docs (Swagger UI)

Every scaffolded app ships Swagger UI at /api/v1/docs and the raw OpenAPI 3 spec at /api/v1/openapi.json — both by default, no opt-in.

The spec is auto-generated from the Marshmallow schemas the skill already requires for request validation (R26) and response serialization (R27). When flask-feature-builder adds a new endpoint, the @blp.arguments(<ValidationSchema>) + @blp.response(<status>, <DTO>) decorators on the controller method tell flask-smorest to reflect those exact schemas into the OpenAPI spec — no hand-written YAML, no duplication, no drift between validation and docs.

Persistent JWT auth in Swagger UI: after a single /api/v1/auth/login call, paste the access token into Swagger UI's Authorize dialog once. persistAuthorization=true saves it to browser localStorage, and every subsequent "Try it out" request auto-attaches Authorization: Bearer <token> — no re-pasting per request, even across browser restarts.

In production, the UI is gated behind either an env-set OPENAPI_DOCS_TOKEN query param or any valid Bearer login; the openapi.json endpoint stays publicly available for CI / SDK generators.

Installation

/plugin marketplace add taimour1446/claude-flask-builder
/plugin install claude-flask-builder@taimour1446

Once installed, trigger with /claude-flask-builder, or just ask Claude to build or extend a Flask app.

See also

  • CHANGELOG.md — version history; the current line is documented per round.
  • CONTRIBUTING.md — how to propose changes; the audit-driven workflow (/audit-loop + double-gated review) is the source of truth for what lands.

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados