What are the core coding rules enforced by this skill?

Key rules include immutability, TDD-first development, minimum 80% test coverage, and strict input validation using Pydantic or Zod.

How does this skill help with testing?

It provides standardized patterns and command examples for backend testing with pytest and frontend testing with React Testing Library and Playwright.

Can I use this as a template for my own project?

Yes, it is specifically designed to be used as a template for project-specific skills to ensure architectural and coding consistency.

What technical stack does this skill focus on?

It is optimized for a modern stack including Next.js 15, FastAPI (Python 3.11), Supabase (PostgreSQL), and Google Cloud Run.

Does it include AI integration examples?

Yes, it includes specific code patterns for integrating Claude AI using structured output, tool calling, and Pydantic models.

Project Architecture & Development Guidelines

Name: Project Architecture & Development Guidelines
Author: oabdelmaksoud

byoabdelmaksoud

0•

API Development

Standardizes development workflows by providing comprehensive architectural patterns, coding standards, and deployment guidelines.

This skill serves as a robust blueprint for modern web applications, specifically tailored for stacks involving Next.js, FastAPI, and Supabase. It empowers developers to maintain consistency across the codebase by defining clear file structures, API response formats, and testing requirements. By integrating specific Claude AI implementation patterns and TDD workflows, it ensures that every part of the development lifecycle—from initial coding to Cloud Run deployment—adheres to production-grade quality and reliability standards.

Key Features

01Unified architecture overview for Next.js and FastAPI stacks

02Structured Claude AI integration with Pydantic models

03Automated testing workflows using pytest and Playwright

04Clear deployment checklists and environment variable management

050 GitHub stars

06Standardized API response and request handling patterns

Use Cases

01Onboarding new developers to a standardized production codebase

02Setting up a new full-stack project with a consistent structure

03Ensuring strict coding standards and TDD compliance during development

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add oabdelmaksoud/agention project-guidelines-example

For use in Claude.ai and ChatGPT

Key Features

01Unified architecture overview for Next.js and FastAPI stacks

02Structured Claude AI integration with Pydantic models

03Automated testing workflows using pytest and Playwright

04Clear deployment checklists and environment variable management

050 GitHub stars

06Standardized API response and request handling patterns

Use Cases

01Onboarding new developers to a standardized production codebase

02Setting up a new full-stack project with a consistent structure

03Ensuring strict coding standards and TDD compliance during development

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add oabdelmaksoud/agention project-guidelines-example

For use in Claude.ai and ChatGPT