Project Guidelines Skill (Example)

When to Use

• Architecture overview
• File structure
• Code patterns
• Testing requirements
• Deployment workflow

Reference Documents

• Architecture & File Structure - Tech stack, service diagram, directory layout
• Code Patterns - API response format, frontend API calls, Claude AI integration, custom hooks
• Testing & Deployment - pytest, React Testing Library, deployment commands, environment variables

Critical Rules

1. No emojis in code, comments, or documentation
2. Immutability - never mutate objects or arrays
3. TDD - write tests before implementation
4. 80% coverage minimum
5. Many small files - 200-400 lines typical, 800 max
6. No console.log in production code
7. Proper error handling with try/catch
8. Input validation with Pydantic/Zod

Related Skills

• coding-standards

  - General coding best practices

• backend-patterns

  - API and database patterns

• frontend-patterns

  - React and Next.js patterns

• tdd-workflow

  - Test-driven development methodology