Claude Code Configuration (CCC)

A comprehensive workspace and configuration system for Claude Code that organizes all your projects, writing, and ideas in a structured environment with built-in best practices, security, testing, and intelligent session management.

🎯 New: Complete Workspace Management

CCC now includes a full workspace organization system:

• 📂 Structured Workspace - Organized directories for business, code, writing, and ideas
• 🎨 Interactive Welcome Menu - Quick access to common tasks when starting Claude
• 🔍 Project Detection - Work on existing projects or create new ones seamlessly
• 📝 Real-time Brainstorming - Ideas saved as you think with structured markdown files
• 📥 Project Import - Bring external projects into your workspace with full analysis
• 🔄 Version Management - Track and migrate workspace configurations

🚀 Quick Installation

One-Command Setup (Recommended)

curl -sSL https://raw.githubusercontent.com/ryarasi/claude-code-configuration/main/install.sh | bash

Manual Installation

git clone https://github.com/ryarasi/claude-code-configuration.git
cd claude-code-configuration
./install.sh

Claude Self-Setup

Claude can configure itself by reading:

claude read https://raw.githubusercontent.com/ryarasi/claude-code-configuration/main/CLAUDE-SETUP.md

📋 What's Included

Core Features

• Interactive Project Creation (/create-app)
• Smart Decision Making (Business vs Technical decisions)
• TDD/BDD Workflows with automated testing
• Security-First Development (OWASP compliant)
• Distributed Session Storage (Project-local .claude directories)
• Automatic Context Loading (When entering project directories)
• Session Migration Tools (Move existing sessions to projects)
• GitHub Actions CI/CD templates
• Free Quality Tools (ESLint, Prettier, Snyk)

Configuration Components

• Global Claude settings with plan mode by default
• Custom slash commands for common workflows
• Project templates with security checklists
• PRD generation system with version tracking
• Session recovery for interrupted work
• Cursor IDE integration

🛠️ System Requirements

• OS: macOS or Linux
• Claude Code: Latest version
• Git: For repository management
• Node.js: For web development projects (optional)
• Python: For API development projects (optional)

📁 Installation Details

The installer will:

1. Create workspace structure:

   ~/workspace/
   ├── business/
   │   ├── for-profit/
   │   │   ├── Yarasi Enterprises/
   │   │   └── Exomudra Technologies/
   │   ├── non-profit/
   │   │   └── Shuddhi Trust/
   │   └── misc/
   ├── code/
   │   └── ccc/  # This repository
   ├── write/
   │   ├── blog/
   │   ├── research/
   │   └── journal/
   ├── personal/
   ├── ideas/     # Brainstorming sessions
   └── CONFIG.md  # Workspace configuration
   

2. Set up Claude directories:

   ~/.claude/
   ├── settings.json
   ├── commands/
   └── scripts/
   
   ~/.ccc/configs/  # Persistent user preferences
   
   # In each project (created automatically):
   project-root/
   └── .claude/
       ├── sessions/     # Project-specific sessions
       ├── .gitignore    # Excludes session data
       └── CLAUDE.md     # Project instructions
   

3. Install configurations:

   • Global settings with smart defaults
   • Custom commands (/create-app, /resume-context)
   • Project templates and workflows
   • Security checklists and quality tools

4. Set up integrations:

   • Cursor IDE configuration
   • Git aliases for common operations
   • Shell completions (optional)

🎯 Key Commands

Workspace Commands (NEW)

# Software project management - work on existing, create new, or import
/code

# Writing projects - blog posts, research papers, journals
/write

# Interactive brainstorming with real-time documentation
/brainstorm

Classic Commands

# Start new project with interactive PRD generation
/create-app

# Resume interrupted session
/resume-context

# Enter planning mode
/plan

# Start TDD workflow
/tdd

Session Management (Distributed)

# Auto-initialize Claude context when entering a project
~/code/claude-config-template/scripts/auto-init.sh

# View recent sessions for current project
~/code/claude-config-template/scripts/log-session.sh list

# Resume last incomplete session
~/code/claude-config-template/scripts/recover-session.sh auto

# Migrate existing sessions to project directories
~/code/claude-config-template/scripts/migrate-sessions.sh

# Clean old sessions
~/code/claude-config-template/scripts/cleanup-sessions.sh

💡 Usage Examples

Creating a New Application

1. Type /create-app in Claude
2. Answer business questions (no "Let Claude decide" option):
   • Application type
   • Target audience
   • Monetization model
3. Answer technical questions (can use "Let Claude decide"):
   • Backend architecture
   • Authentication method
   • Database choice
4. Review generated PRD
5. Begin TDD development

Resuming Interrupted Work

If Claude crashes or you close unexpectedly:

1. Type /resume-context
2. Claude will show recent incomplete sessions
3. Select session to resume
4. Continue where you left off

🔧 Configuration

Global Settings Location

~/.claude/settings.json

Key settings:

• defaultMode: "plan" (always start with planning)
• autoApprovedCommands: Pre-approved safe commands
• testCoverage: 70% minimum
• decisionCategories: Business vs Technical

Customization

All configurations are editable:

# Edit global settings
vim ~/.claude/settings.json

# Add custom commands
vim ~/.claude/commands/my-command.md

# Modify templates
vim ~/code/claude-config-template/templates/

📊 Session Logging

How It Works

1. Every interaction creates a session log
2. Logs capture essential context:
   • Todo lists
   • Modified files
   • Tech stack decisions
   • Last operations
3. Sessions auto-expire after 30 days

Log Location

~/.claude/sessions/YYYY-MM-DD/

Recovery

# Show incomplete sessions
~/.claude/scripts/recover-session.sh

# Resume specific session
~/.claude/scripts/recover-session.sh SESSION_ID

🖥️ Cursor IDE Integration

Automatic Setup

The installer configures Cursor automatically.

Manual Setup

See CURSOR-INTEGRATION.md for details.

Features

• Custom keybindings for Claude commands
• Integrated terminal shortcuts
• Project templates
• Syntax highlighting for .claude files

📁 Repository Structure

claude-code-configuration/
├── README.md                    # This file
├── CLAUDE-SETUP.md             # Claude self-configuration guide
├── CURSOR-INTEGRATION.md       # Cursor IDE setup
├── LICENSE                     # MIT License
├── install.sh                  # Installation script
├── config/
│   └── .claude/
│       ├── settings.json       # Global settings
│       └── commands/           # Custom commands
├── templates/                  # Project templates
│   ├── prd-template.json      # PRD structure
│   ├── questionnaire-flow.json # Decision flow
│   ├── eslintrc.template.json # ESLint config
│   └── prettierrc.template.json # Prettier config
├── workflows/                  # CI/CD templates
│   ├── ci-web.yml             # Web pipeline
│   └── ci-api.yml             # API pipeline
├── security/                   # Security resources
│   └── security-checklist.md  # OWASP checklist
├── scripts/                    # Utility scripts
│   ├── log-session.sh         # Session logging
│   ├── recover-session.sh     # Session recovery
│   └── cleanup-sessions.sh    # Session cleanup
└── docs/                       # Documentation
    ├── CLAUDE-APP-DEVELOPMENT.md
    └── TROUBLESHOOTING.md

🚨 Troubleshooting

Installation Issues

# Verify installation
./scripts/verify-installation.sh

# Check permissions
ls -la ~/.claude

# Re-run installer
./install.sh --force

Command Not Found

# Reload Claude
claude reload

# Check command exists
ls ~/.claude/commands/

# Verify path
echo $CLAUDE_CONFIG_DIR

Session Recovery Failed

# Check session files
ls ~/.claude/sessions/

# Validate JSON
jq . ~/.claude/sessions/*/*/*.json

# Manual recovery
cat ~/.claude/sessions/*/*/recovery-context.md

🤝 Contributing

Adding Features

1. Fork the repository
2. Create feature branch
3. Add tests
4. Update documentation
5. Submit pull request

Reporting Issues

Create issues at: https://github.com/ryarasi/claude-code-configuration/issues

📚 Additional Documentation

• App Development Guide - Complete development workflow
• Security Checklist - Security guidelines
• Scripts README - Script documentation
• Best Practices - Coding standards

🔐 Security

This configuration system includes:

• OWASP Top 10 compliance
• Automated security scanning
• Environment variable management
• No hardcoded secrets
• Regular dependency updates

📄 License

MIT License - See LICENSE file

🙏 Acknowledgments

Created for the Claude Code community to enable:

• Consistent project quality
• Faster development cycles
• Better context persistence
• Security-first approach

---

Version: 1.0.0
Author: @ryarasi
Repository: https://github.com/ryarasi/claude-code-configuration