Can this skill help with database migrations?

Yes, the guidelines include sections for database operations and deployment workflows to ensure migrations are handled correctly during the development cycle.

How does this improve AI-generated code quality?

By defining 'Critical Rules' such as mandatory TDD, immutability, and no console logs, it prevents the AI from introducing technical debt.

How do I implement this for my own repository?

You can use this skill as a template, replacing the example paths and patterns with your specific architecture and project requirements.

What is the Project Guidelines Skill?

It is a template designed to give Claude Code specific instructions regarding your project's architecture, file structure, and coding standards to ensure consistent output.

Does this skill support specific tech stacks?

The example focuses on Next.js, FastAPI, and Supabase, but it is meant to be used as a flexible template that can be customized for any tech stack.

Project Architecture & Coding Guidelines

Name: Project Architecture & Coding Guidelines
Author: AmbushData

byAmbushData

0•

API Development

Provides a comprehensive template for project architecture, coding patterns, and testing requirements to ensure AI-driven development consistency.

This skill serves as a blueprint for full-stack applications, offering a standardized structure for projects using Next.js, FastAPI, and Supabase. It guides Claude in maintaining architectural integrity by defining specific file structures, API response formats, and testing protocols. By implementing this skill, developers can establish clear guardrails for AI coding assistants, ensuring generated code adheres to strict project-specific rules such as Test-Driven Development (TDD), immutability, and structured AI tool-calling patterns.

Key Features

01Full-stack architecture mapping for Next.js and FastAPI environments

020 GitHub stars

03Comprehensive deployment checklists and environment variable management

04Structured Claude AI integration patterns using Pydantic models

05Standardized API response patterns for consistent frontend-backend communication

06Integrated testing workflows for Pytest and Playwright (E2E)

Use Cases

01Enforcing strict quality controls like 80% test coverage and immutability rules

02Bootstrapping new full-stack projects with predefined folder structures and coding standards

03Onboarding Claude to an existing codebase by providing explicit architectural context

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ambushdata/ai_setup project-guidelines-example

For use in Claude.ai and ChatGPT

Download Skill