Can I adapt this for a different tech stack?

Yes, while this example focuses on Next.js and FastAPI, the framework is designed to be used as a template for any language or platform.

How are testing requirements managed?

The skill mandates a Test-Driven Development (TDD) approach with specific commands for Pytest and React Testing Library, requiring a minimum of 80% coverage.

How does this skill handle AI integration?

It includes specific code patterns for structured output and tool calling using the Anthropic API, ensuring high-quality AI service layers.

Does it enforce specific coding styles?

Yes, it includes critical rules such as immutability, no emojis in code, and strict file length limits (max 800 lines) to ensure maintainability.

What is the primary purpose of this project guidelines skill?

It serves as a source of truth for Claude, providing the specific architectural context, file structures, and coding rules needed to generate project-consistent code.

Project Architecture Guidelines

Name: Project Architecture Guidelines
Author: x-cmd

byx-cmd

•

学习与文档

Standardizes full-stack project structures, coding patterns, and deployment workflows for AI-driven application development.

This skill acts as a comprehensive blueprint for developers building modern, AI-powered platforms using Next.js, FastAPI, and Supabase. It codifies essential project knowledge including directory structures, API response formatting, and testing protocols. By providing Claude with domain-specific guidance on architecture and implementation patterns, it ensures that generated code adheres to strict project standards, follows TDD methodologies, and integrates seamlessly with tool-calling AI models. This is particularly useful for maintaining consistency across large teams or complex production environments like Zenith.

主要功能

01Rigorous testing requirements for Pytest, Playwright, and RTL

029 GitHub stars

03Standardized API response formats and TypeScript patterns

04Step-by-step deployment workflows for Google Cloud Run and Vercel

05Comprehensive architecture blueprints for Next.js and FastAPI

06Pre-configured Claude AI tool-calling and structured output integration

使用场景

01Automating the enforcement of TDD and 80% code coverage requirements

02Ensuring AI-generated code follows project-specific rules and immutability standards

03Establishing a standardized project template for new full-stack applications

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add x-cmd/skill project-guidelines-example

For use in Claude.ai and ChatGPT

Download Skill