secret-sauce

Original：🇺🇸 English

Translated

Development best practices and project patterns. Use when starting projects, setting up CLAUDE.md, coding TypeScript/Next.js/React/Supabase, implementing AI flows, data fetching, testing, deployment, git workflows, browser automation, centralized configuration, or Tailwind CSS v4.

2installs

Sourceco8/cc-plugins

Added on2026-02-22

NPX Install

npx skill4agent add co8/cc-plugins secret-sauce

SKILL.md Content

View Translation Comparison →

Secret Sauce

Best practices, rules, and templates extracted from real production projects.

Quick Reference

Category	Reference File
Tech Stack	`references/tech-stack.md`
Project Setup	`references/claude-md-template.md`
Project Tracking	`references/project-tracking.md`
Coding Standards	`references/coding-standards.md`
Centralization	`references/centralization-patterns.md`
Tailwind v4	`references/tailwind-v4.md`
AI Development	`references/ai-flow-patterns.md`
Data Fetching	`references/data-fetching.md`
Git Workflow	`references/git-workflows.md`
Testing	`references/testing-patterns.md`
Supabase	`references/supabase-patterns.md`
Deployment	`references/deployment-patterns.md`
Browser Tools	`references/browser-automation.md`
Versioning	`references/version-management.md`

Framework Rules

Framework	Rule File
TypeScript	`rules/typescript.md`
Next.js	`rules/nextjs.md`
React	`rules/react.md`
Supabase	`rules/supabase.md`
Security	`rules/security.md`

Templates

Template	Purpose
`templates/CLAUDE.md.template`	Project configuration starter
`templates/settings.json.template`	Permission configuration
`templates/project-plan.md.template`	Project planning document
`templates/implementation-plan.md.template`	Technical implementation plan
`templates/code-review.md.template`	Code review summary
`templates/changelog.md.template`	Project changelog

Usage

Starting a New Project

Copy
```
templates/CLAUDE.md.template
```
to your project root as
```
CLAUDE.md
```
Customize sections for your stack

Reference specific rules:

~/.claude/skills/secret-sauce/rules/typescript.md

Setting Up Permissions

Copy

templates/settings.json.template

to

.claude/settings.json

Adjust permissions for your workflow

Project Documentation

Use templates for consistent project documentation:

```
project-plan.md.template
```
for planning
```
implementation-plan.md.template
```
for technical specs
```
code-review.md.template
```
for reviews

Key Patterns

CLAUDE.md Structure

Every project CLAUDE.md should include:

YAML frontmatter (title, status, owner, tags)
Quick Reference section with key commands
Active/Pending/Completed projects
Stack-specific guidelines
Development patterns

Git Workflow

Commit format:
```
<type>(<scope>): <description>
```
Never commit without confirmation
Branch naming:
```
feature/<name>
```
,
```
fix/<name>
```
PR template with summary and test plan

Centralization Pattern

All configuration in

@/config

:

typescript

import { env, isProduction, getServiceUrl } from '@/config';

Configuration Hierarchy

Database configuration (system_configuration table)
Environment variables (.env.local)
Hardcoded defaults

Secrets (API keys) →

.env.local

only Configs (models, URLs) → Database with fallback

Testing Standards

Target: >90% coverage
Use Jest with 30s timeout for ML operations
Add new test directories to test runners
Security tests required for auth/validation

AI Flow Pattern

Zod schemas for input/output
Prompt builder functions
OpenAI SDK v6 with
```
zodResponseFormat()
```
Error handling with Result types
Server action wrapper

Data Fetching

Always pass
```
signal
```
to fetch calls
Use
```
isAbortError()
```
to handle cancellation
Memoize fetch options to prevent refetches
Use
```
usePolling
```
for dashboards with visibility-aware intervals

Security Checklist

Strict TypeScript (no
```
any
```
)
Zod input validation
Safe property access:
```
Object.prototype.hasOwnProperty.call()
```
XSS prevention on all user inputs
Rate limiting in API routes