CLAUDE.md Default

Unleash autonomous Claude Code — just add to any project

Time-Aware Loops · Ralph Wiggum Automation · Auto-Planning & Execution · Task Tracking · Git Discipline

---

Overview

Drop-in configuration files that supercharge Claude Code with autonomous work modes, automatic planning, and self-correcting loops.

├── CLAUDE.md              # Claude's operating instructions
├── new-project.sh         # Quick-start script
└── .claude/
    └── settings.json      # Bypass permissions for autonomous work

Quick Start

Option 1: Use the Script

# Clone
git clone https://github.com/Ark0N/CLAUDE.md-default.git
cd CLAUDE.md-default

# Create a new project
./new-project.sh my-awesome-app

This will:

• Create my-awesome-app/ directory
• Copy CLAUDE.md and .claude/settings.json
• Initialize a git repository

Option 2: Manual Setup

# Copy files to your existing project
cp CLAUDE.md /path/to/your/project/
cp -r .claude /path/to/your/project/

# Update Project Overview in CLAUDE.md, then start
claude

Features

Feature	Description
Ralph Loop	Autonomous work mode with self-correction
Auto Planning	Enters planning mode for 3+ file changes
Time-Aware Loops	Work for specified durations
Task Tracking	TodoWrite for progress visibility
Git Discipline	Commits after every meaningful change

Ralph Loop

Persistent autonomous sessions that self-correct until done:

/ralph-loop:ralph-loop   # Start
/ralph-loop:cancel-ralph # Stop
/ralph-loop:help         # Help

Time-Aware Work

"Optimize the API for 4 hours. Focus on performance."
Completion phrase: <promise>TIME_COMPLETE</promise>

Claude generates additional tasks if primary work finishes early.

Task Tracking (TodoWrite)

Claude uses TodoWrite for all multi-step work:

• Creates todos before starting
• Marks each in_progress → completed as work progresses
• One task at a time, completed immediately
• Gives you visibility into exactly what Claude is doing

How It Works

Time-aware loops are behavioral guidance, not enforced code. Claude follows the instructions in CLAUDE.md to:

1. Record start time via date +%s > /tmp/ralph_start_time
2. Complete primary tasks
3. Check elapsed time before outputting the completion phrase
4. Self-generate additional tasks if minimum duration not reached
5. Only complete when time threshold is met

Tested Behavior (2-minute loop)

Elapsed	Behavior
37s	Primary tasks done — checked time, under minimum — kept working
90s	Added JSDoc, edge cases, more functions — still under, continued
122s	Minimum reached — output completion phrase

What this means: Claude will track time and extend work when needed, but this relies on Claude following the CLAUDE.md instructions. The Ralph Loop plugin handles iteration limits and completion phrase detection, while time-awareness is prompt-driven.

Requirements

• Claude Code CLI
• Ralph Loop Plugin:

claude config set enabledPlugins.ralph-loop@claude-plugins-official true

License

MIT