Turning vibe coding from lottery into workflow

What it does

Vibe Coding Toolkit is a structured workflow for AI-assisted development built around Claude Code and OpenAI Codex. It bundles a “Superpowers” plugin that forces planning before execution, parallel subagent orchestration to prevent file collisions, and ESLint quality gates including a hard 350-line file limit. The whole thing was extracted from a real private fintech codebase and genericized into copy-paste prompts and templates.

The interesting bit

The author treats AI agents like team members that need management, not interns that need babysitting. The parallel subagent orchestration is unusual—it structurally prevents commit disputes and file collisions rather than relying on developer discipline. The repository keeps docs in Portuguese for accessibility but leaves the actual prompts in English, because that’s what the models parse best.

Key highlights

• “Superpowers” plugin makes Claude Code explore intent and plan before writing code
• Parallel wave subagent orchestration eliminates file collision and commit races by design
• ESLint/Biome quality gates with a 350-line-per-file ceiling and tracked migration from warning to error
• Ready-to-copy prompts for lint burndown, multi-agent code review, and file-size refactoring
• Extracted from a real production fintech project under NDA, then sanitized for public use

Caveats

• No automatic installer yet; setup still requires manual file copying and command pasting
• The RTK token proxy is documented as a replication pattern, not a public installable binary
• README and explanatory docs are in Portuguese, though the copy-paste prompts are in English

Verdict

Worth bookmarking if you run Claude Code daily and need guardrails that actually survived production. Skip it if you need a fully automated setup or prefer your documentation in English.