# Build Full-Stack AI Applications with Project Guidelines

Developers struggle with maintaining consistent patterns across full-stack projects. This skill provides ready-to-use architecture diagrams, code patterns, and deployment workflows for Next.js and FastAPI applications with Claude AI integration.

## Install

```bash
npx skillstore add affaan-m/sickn33-cc-skill-project-guidelines-example
```

## Metadata

- - Slug: sickn33-cc-skill-project-guidelines-example
- - Version: 1.0.1
- - Author: affaan-m
- - GitHub username: sickn33
- - License: MIT
- - Repository: https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/cc-skill-project-guidelines-example
- - Ref: main
- - Supported tools: Claude, Codex, Claude Code
- - Risk level: safe
- - Quality score: 81
- - Quality tier: silver
- - Public page: https://skillstore.pages.dev/skills/sickn33-cc-skill-project-guidelines-example
- - Manifest: https://skillstore.pages.dev/api/skills/sickn33-cc-skill-project-guidelines-example/manifest

## Capabilities

- Provides complete architecture diagrams for Next.js and FastAPI applications
- Documents TypeScript and Python code patterns for API development
- Includes Claude AI integration examples with structured output
- Contains testing workflows for pytest and React Testing Library
- Offers deployment checklists and Google Cloud Run commands
- Establishes critical coding rules like immutability and TDD requirements

## Use Cases

- Onboard New Team Members: Use this skill to quickly bring developers up to speed on project architecture, code patterns, and deployment workflows.
- Standardize Code Reviews: Reference the documented patterns and critical rules during code reviews to ensure consistency across the codebase.
- Setup New Project Instances: Clone the documented structure and patterns when creating new projects with similar full-stack architecture.

## Prompt Templates

### Review Project Architecture

```
Based on the project guidelines, explain the architecture for our Next.js and FastAPI application. Include the service diagram and how Claude AI integrates with the backend.
```

### Generate API Response Pattern

```
Using the documented API response format from the guidelines, create a Pydantic model for a user profile endpoint that returns success, data, and error fields.
```

### Setup Test Structure

```
Following the testing requirements in the guidelines, generate pytest test fixtures and a sample test for the health check endpoint in our FastAPI backend.
```

### Prepare Deployment Checklist

```
Review the deployment workflow guidelines and generate a pre-deployment checklist for our next Cloud Run release. Include all required environment variables and build steps.
```

## Limitations

- This skill provides documentation only - it does not execute code or automate tasks
- Examples are specific to a Zenith-style AI platform architecture
- Requires manual adaptation for projects with different tech stacks
- Environment variable examples must be replaced with actual credentials

## Best Practices

- Write tests before implementation following TDD methodology with minimum 80% coverage
- Maintain immutability - never mutate objects or arrays directly in TypeScript or Python code
- Keep files small with 200-400 lines typical and 800 lines maximum for maintainability

## Anti Patterns

- Using console.log in production code - use proper logging frameworks instead
- Hardcoding secrets or credentials in source files - always use environment variables
- Skipping input validation - always validate with Pydantic for Python or Zod for TypeScript

## Security Audit

- - Safe to publish: true
- - Audited at: 2026-02-25T05:15:13.894\+00:00
- - Summary: This skill is a documentation-only resource containing project guidelines and code examples. All 47 static analyzer findings are false positives resulting from Markdown code fences being misinterpreted as shell commands. The file contains no executable code, no actual network calls, and no credential access - only documentation of best practices for a full-stack application.

## Stats

- - Views: 115
- - Downloads: 6
- - Favorites: 0
- - Popularity score: 0