Does it include deployment instructions?

Yes, it provides specific commands and environment variable configurations for deploying to Google Cloud Run and Vercel.

Can I use this for non-AI projects?

Yes, while it includes Claude API integration patterns, its architectural and testing guidelines apply to any modern full-stack web application.

What are the 'Critical Rules' mentioned in the skill?

The rules include mandatory TDD, 80% minimum test coverage, immutability, no emojis in code, and strict file size limits for maintainability.

What tech stack does this skill support?

It is optimized for Next.js 15 (App Router), FastAPI (Python 3.11), Supabase (PostgreSQL), and Google Cloud Run.

Full-Stack Project Architecture Guidelines

Name: Full-Stack Project Architecture Guidelines
Author: Aventerica89

byAventerica89

0•

API Development

Standardizes full-stack development workflows using Next.js, FastAPI, and Supabase with integrated AI implementation patterns.

This skill provides a comprehensive blueprint for building modern AI-powered applications, offering structured guidance on architecture, file organization, and production-ready code patterns. It bridges the gap between frontend React/Next.js development and backend FastAPI services, ensuring consistent API responses, type safety, and rigorous testing standards through Test-Driven Development (TDD) and strict code coverage requirements. By providing specific templates for Claude AI tool calling and structured outputs, it enables developers to rapidly build scalable, maintainable, and AI-native software architectures.

Key Features

01Unified Next.js 15 and FastAPI architecture patterns

02Pre-defined deployment workflows for Google Cloud Run

03Type-safe Pydantic and TypeScript API response models

04Comprehensive testing configurations for Pytest and Playwright

05Structured AI tool-calling implementation for Claude API

060 GitHub stars

Use Cases

01Bootstrapping new AI-powered SaaS platforms with standardized file structures

02Integrating structured AI outputs into Python backends with Pydantic validation

03Enforcing consistent coding standards and TDD across distributed development teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add aventerica89/bricks-builder-agent project-guidelines-example

For use in Claude.ai and ChatGPT

Download Skill