init

Initialize or audit .claude/ configuration for this repository based on detected stack.

Arguments:

• $ARGUMENTS: Optional flags
  • --audit: Only analyze existing config, report improvements
  • --force: Overwrite existing files without confirmation

Mode Detection

1. Check if .claude/ directory exists
2. If exists AND no --force: Run Audit Mode
3. If not exists OR --force: Run Fresh Init Mode

---

Progressive Disclosure Principles

Generated rules and skills follow progressive disclosure to minimize token usage while maintaining depth:

Three-layer approach:

1. Metadata (scanned first) - Name and description only
2. Main file (loaded if selected) - Concise patterns, under 500 lines
3. Reference files (loaded on-demand) - Deep details in references/ subdirectory

Key rules:

• Main files point to reference files, never duplicate content
• References are always one level deep (no nested references)
• Reference files include a table of contents for partial reads
• Rules reference ce:* skills rather than duplicating skill content

When to use references/:

• Domain-specific schemas or configurations
• Extensive code examples for different scenarios
• API documentation that varies by context
• Style guides with multiple personas

Example structure:

rules/
├── testing.md                    # Points to ce:writing-tests skill
└── api/
    ├── conventions.md            # Main file, ~100 lines
    └── references/
        ├── error-codes.md        # Loaded when handling errors
        └── pagination.md         # Loaded when implementing pagination

skills/
└── my-project-connector/
    ├── SKILL.md                  # Main instructions, <500 lines
    └── references/
        ├── auth-flows.md         # OAuth, API key, etc.
        └── rate-limiting.md      # Retry strategies

---

Fresh Init Mode

Step 1: Detect Stack

Check for manifest files in the repository root:

File	Stack	Test Framework
pyproject.toml or requirements.txt	Python	pytest
package.json	Node.js/TypeScript	vitest, jest
Cargo.toml	Rust	cargo test
go.mod	Go	go test
pom.xml or build.gradle	Java/Kotlin	JUnit
Gemfile	Ruby	RSpec