Claude Code configuration by Pedro Jahara - autonomous workflows for /feature, /debug, /gate
npm install kakaroto-configClaude Code configuration for autonomous development workflows.
``bashLocal installation (recommended - installs to ./.claude/)
npx kakaroto-config
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@latestUpdate 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 testsStructure
- src/ - Source code
- tests/ - TestsMCP 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 npmFiles synced:
-
CLAUDE.md, ARCHITECTURE.md
- commands/ (all skills)
- agents/ (all subagents)
- templates/Files excluded:
-
audit-command/ (personal)
- Session data (plans/, specs/, interviews/`, etc.)MIT