python-services

Claude's Kitchen 👨‍🍳

Where developer chefs cook production-ready code with Claude

Claude's Kitchen is a collection of battle-tested recipes, techniques, and tools that Claude uses to cook secure, tested, production-ready code.

What's in the Kitchen?

• Recipes (skills/): Battle-tested patterns and standards Claude follows to cook your code

  • Coding standards (functional programming, type safety, hexagonal architecture)
  • Security patterns (OWASP Top 10)
  • Infrastructure recipes (Terraform, NestJS, testing frameworks)
  • Integration guides (GitHub, Jira, Slack, Notion, Confluence)
  • Development workflows

• Agents (agents/): AI agents that validate code and enforce standards

  • architecture-agent: Validates hexagonal architecture principles and layer boundaries
  • production-code-agent: Validates functional programming patterns and coding standards
  • test-code-agent: Validates test architecture and patterns
  • Supports dual-mode: informative (report) or executive (auto-fix)
  • JSON configs for orchestrator integration

Quick Start

→ New here? Start with the QUICKSTART.md guide! 🍋

Option 1: Automated Setup (Recommended)

Run the setup script to install Claude Code, marketplace, all plugins, and security hooks:

1. Add Marketplace in Claude Code

./setup-cooking-environment.sh

What it installs:

• Claude Code CLI (if not already installed)
• Claude's Kitchen marketplace
• All 5 plugins: skills-development, backend-services, typescript-services, workflows, agent-orchestrator
• Git security hooks (gitleaks pre-commit/pre-push scanning)
• GPG commit signing configuration
• jq for JSON parsing

Supported platforms: macOS, Linux

---

Option 2: Manual Setup

1. Add Marketplace in Claude Code

# In Claude Code, add the marketplace
claude plugin marketplace add andercore/claudes-kitchen

Or add to your project's .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "claudes-kitchen": {
      "source": {
        "source": "github",
        "repo": "andercore/claudes-kitchen"
      }
    }
  }
}

2. Install Plugins

Install plugins from .claude-plugin/marketplace.json:

# Install each plugin listed in marketplace.json
claude plugin install <plugin-name>@claudes-kitchen

# Restart Claude Code to load recipes

Available plugins: See .claude-plugin/marketplace.json for current list

Updates

When recipes are updated:

claude plugin marketplace update claudes-kitchen

And if new recipe plugins are added:

claude plugin install <new-recipe-plugin>@claudes-kitchen

---

Troubleshooting

Marketplace Installation Fails (HTTPS Clone Issue)

Problem: Claude Code clones marketplace via HTTPS, causing update/sync failures.

Symptoms:

• Marketplace update errors
• Plugin sync failures
• "not all refs are readable" errors

Fix: Convert Claude Code's marketplace clone to SSH:

# Find marketplace location
ls ~/.claude/marketplaces/  # or ~/Library/Application Support/Claude/marketplaces/

# Navigate to the marketplace directory
cd ~/.claude/marketplaces/claudes-kitchen
# OR (depending on Claude Code version)
cd ~/Library/Application\ Support/Claude/marketplaces/claudes-kitchen

# Convert HTTPS → SSH
git remote set-url origin git@github.com:andercore/claudes-kitchen.git

# Verify
git remote -v  # Should show: git@github.com:andercore/claudes-kitchen.git

# Test pull
git pull origin main

After fixing: Restart Claude Code and run /plugin marketplace update claudes-kitchen

Documentation

• SKILLS.md - How to use skills in Claude Code
• AGENTS.md - How to use agents for code validation
• CONTRIBUTING.md - Adding new recipes and agents

Why Claude's Kitchen?

When you ask Claude to cook code, Claude follows recipes from this kitchen. Each recipe captures years of team experience, security standards, and best practices - so Claude cooks it right the first time.

Agents automate code validation and can auto-fix violations, ensuring consistent quality across your codebase.

Contributing

When you cook something great, add it to the kitchen! See CONTRIBUTING.md for details.

License

MIT