How does this skill improve AI code generation?

By providing clear 'Critical Rules' and 'Code Patterns,' it prevents the AI from using incompatible libraries or coding styles that don't match your project's requirements.

What is the purpose of the Project Guidelines skill?

It provides a standardized template to inform Claude about your specific project's architecture, file structure, and coding patterns, ensuring generated code fits your existing environment.

Can I use this for projects not using Next.js or FastAPI?

Yes, while the example uses a specific stack, the structure is designed to be modified for any technology, including Ruby on Rails, Go, or mobile frameworks like Flutter.

How do I implement this for my own repository?

You can copy the SKILL.md structure into your own Claude Code configuration, updating the architecture diagrams and code examples to match your specific project.

Does it support automated testing workflows?

Yes, it includes sections for defining testing requirements for both backend (pytest) and frontend (React Testing Library), encouraging a Test-Driven Development (TDD) approach.

Project Guidelines Example | Claude Code Skill Template

This skill serves as a master blueprint for codifying project-level standards within Claude Code, ensuring that all AI-generated contributions align with a project's specific technical DNA. It provides a structured format for documenting architecture, directory hierarchies, and implementation patterns—such as FastAPI response models, Next.js hooks, and Claude API tool-calling structures. By integrating these guidelines, teams can enforce strict adherence to Test-Driven Development (TDD), immutability rules, and specific deployment checklists, significantly reducing technical debt and architectural drift in complex full-stack applications.

Key Features

01Full-stack architecture mapping for Next.js, FastAPI, and Supabase ecosystems

02Enforced critical coding rules including TDD, immutability, and error handling

03Standardized directory structures for frontend, backend, and DevOps configurations

041 GitHub stars

05Reusable implementation patterns for structured AI outputs and API handling

06Integrated testing protocols for Playwright, pytest, and React Testing Library

Use Cases

01Onboarding developers to complex projects by providing an interactive architectural guide

02Enforcing consistent API response formats and TypeScript definitions across the codebase

03Automating the alignment of AI-generated code with specific production deployment requirements

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nixdorfer/claudecodetool project-guidelines-example

For use in Claude.ai and ChatGPT

Download Skill

Key Features

01Full-stack architecture mapping for Next.js, FastAPI, and Supabase ecosystems

02Enforced critical coding rules including TDD, immutability, and error handling

03Standardized directory structures for frontend, backend, and DevOps configurations

041 GitHub stars

05Reusable implementation patterns for structured AI outputs and API handling

06Integrated testing protocols for Playwright, pytest, and React Testing Library

Use Cases

01Onboarding developers to complex projects by providing an interactive architectural guide

02Enforcing consistent API response formats and TypeScript definitions across the codebase

03Automating the alignment of AI-generated code with specific production deployment requirements

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nixdorfer/claudecodetool project-guidelines-example

For use in Claude.ai and ChatGPT

Download Skill

Project Architecture & Guidelines Template

Project Architecture & Guidelines Template

Key Features

Use Cases

Key Features

Use Cases