kakaroto-config

Claude Code configuration for autonomous development workflows.

Quick Install

``bash


Local installation (recommended - installs to ./.claude/)

npx kakaroto-config

Global installation (installs to ~/.claude/)

npx kakaroto-config --global
`

Local is recommended because each project can have its own customizations while inheriting the global rules.

Updating

To update to the latest version, run the same command again:

`bash


Update local installation

npx kakaroto-config@latest

Update global installation

npx kakaroto-config@latest --global
`

The installer will detect the existing .claude/ folder and ask if you want to overwrite.

> Note: If you previously installed globally (~/.claude/) and want to switch to local (./.claude/), just run npx kakaroto-config@latest in your project folder. Both can coexist - Claude Code will use local config when available.

What Gets Installed

`
.claude/
├── CLAUDE.md # Global rules (autonomy, coding standards)
├── ARCHITECTURE.md # Full documentation of the system
├── commands/ # Skills (invoked via /skill)
│ ├── feature.md # /feature orchestrator
│ ├── feature/ # 7 phases: interview → spec → plan → implement → quality → commit → evaluate
│ ├── debug.md # /debug orchestrator
│ ├── debug/ # 6 phases + playbooks, techniques, templates, validators
│ └── gate.md # /gate - quality gate before PR
├── agents/ # 7 specialized subagents
│ ├── test-fixer.md
│ ├── code-reviewer.md
│ ├── code-simplifier.md
│ ├── dry-enforcer.md
│ ├── visual-validator.md
│ ├── terraform-validator.md
│ └── memory-sync.md
└── templates/ # Spec templates
└── spec-template.md
`

Skills (Commands)

| Skill | Trigger | Description |
|-------|---------|-------------|
| /feature | "adicionar", "implementar", "criar" | Full feature workflow with spec, planning, and quality gates |
| /debug | "bug", "erro", "problema" | Bug resolution with 5 Whys methodology |
| /gate | Manual | Run all 7 quality agents before PR |

Agents (Subagents)

| Agent | Purpose |
|-------|---------|
| test-fixer | Runs tests, fixes failures, creates missing tests |
| code-reviewer | Reviews code quality, security, auto-fixes issues |
| code-simplifier | Reduces complexity, improves readability |
| dry-enforcer | Detects duplication, suggests code reuse |
| visual-validator | Validates UI with Playwright |
| terraform-validator | Validates env vars and Terraform consistency |
| memory-sync | Syncs knowledge to MCP Memory |

Philosophy

The configuration enforces autonomous development:

| Principle | Meaning |
|-----------|---------|
| FAZER, nao perguntar | Agents fix issues automatically, don't ask for confirmation |
| BUSCAR, nao pedir contexto | Use MCP Memory and codebase exploration, don't ask user for context |
| Codigo sem teste = PR rejeitado | Tests are mandatory (blocking) |
| Erros: corrigir e continuar | Fix errors automatically, don't stop workflow |

After Installation

$3

Create a CLAUDE.md in your project root with project-specific info:

`markdown


Project Name

Commands


- npm run dev - Start dev server
- npm run build - Build
- npm run test - Run tests

Structure

- src/ - Source code
- tests/ - Tests

MCP Memory Namespace

Prefix: myproject:
`

$3

Create .claude/commands/your-skill.md for project-specific workflows.

Workflow Examples

$3

`
User: "adiciona filtro de data na listagem"
↓
Claude automatically triggers /feature
↓
01-interview → Explores codebase, asks clarifying questions
02-spec → Generates technical specification
03-planner → Creates implementation plan (requires approval)
04-implement → Writes code following spec and plan
05-quality → Runs all 7 quality agents
↓
Ready for PR
`

$3

`
User: "erro ao salvar formulario"
↓
Claude automatically triggers /debug
↓
01-reproduce → Reproduces the bug
02-investigate → 5 Whys analysis with evidence
03-fix → Minimal fix + mandatory test
04-verify → Confirms fix works
05-commit → Creates commit
↓
Done
`

Requirements

- Claude Code CLI
- MCP Memory server (optional, for knowledge persistence)
- Playwright MCP (optional, for visual validation)

Development

$3

This project uses ~/.claude/ as the source of truth. To publish changes:

`bash
npm run release
`

This command will:
1. Sync files from ~/.claude/ to config/ (excluding personal files like audit-command/)
2. Bump the patch version automatically
3. Create a git commit and push
4. Publish to npm

Files synced:
- CLAUDE.md, ARCHITECTURE.md
- commands/ (all skills)
- agents/ (all subagents)
- templates/

Files excluded:
- audit-command/ (personal)
- Session data (plans/, specs/, interviews/`, etc.)

License

MIT