Project Kami — Development skill for Claude Code

Project Kami 🗾

A comprehensive development environment for building and maintaining large-scale projects with Claude Code. Project Kami provides a complete, isolated Docker container that safely integrates your code, database, Claude Code with MCPs, and all necessary configurations - allowing Claude to operate with full file system access while maintaining security and consistency.

🎌 Core Principles

Project Kami operates on these fundamental principles:

🐳 Everything in One Container

• Complete isolation: Code, database, Claude Code, and all tools in a single Docker image
• Safe permissions: Run Claude with --dangerously-skip-permissions without risk
• Consistent environment: Every developer gets the exact same setup
• No host pollution: Your local machine stays clean

📝 Memory-Driven Development

• Persistent AI memory: Claude maintains comprehensive project understanding across sessions
• Requirements-first: All development traces back to documented requirements
• Living documentation: Architecture, roadmap, and changelog evolve with your project
• Context preservation: Never lose project knowledge between sessions

🔧 Integrated Tools & Configuration

• Claude Code: Latest version with full file system access
• MCP Servers: Pre-configured Model Context Protocol servers (PostgreSQL, Context7, n8n)
• Claude settings: Optimized configuration for large projects
• Cursor settings: Ready-to-use IDE configuration
• Development tools: Node.js, Python, PostgreSQL with pgvector, and more

🛡️ Security Through Isolation

• Container boundaries: Claude operates within Docker, not on your host
• Non-root user: Runs as devuser with controlled sudo access
• Volume mounts: Only specified directories are accessible
• Credential management: Secrets stay in the container

📌 Two Ways to Use Project Kami

Option 1: Starting a NEW Project (Empty Workspace)

Perfect when you want Cla