English · Português (Brasil) · Español

Vibe Coding Toolkit

Set up your machine. Bootstrap or upgrade your projects.

A toolkit of documentation, prompts, and templates with two functions: configure machines and configure individual projects. Build with AI agents: prepare your machine, start an application, improve an existing project, and maintain context and quality throughout the work.

You describe the goal. The agent inspects the environment, organizes decisions, configures applicable components, and verifies the result. The code stays in your project; this repository holds the recipe.

START A PROJECT →   ·   PREPARE YOUR MACHINE   ·   SET UP AN EXISTING PROJECT   ·   EXPLORE THE TOOLKIT

  MIT   ·   Star History   ·   Evidence and limits

Claude Code + Codex / portable instructions / local skills

Next.js for new projects / your stack preserved in existing projects

---

00 / Choose where to start

On this page: Foundation · Agents · Knowledge · Quality · Prompts · Documentation · Community.

The agent must be able to read files, edit, and execute commands. The guides cover Claude Code and Codex separately; other clients can follow the agreements with equivalent capabilities. A conversation without environment access explains the process but does not prove installations or tests.

01 / Prepare a foundation that fits your project

Setup starts with what exists: product, files, runtime, package manager, instructions, and available tools. New projects receive a coherent foundation; existing projects receive adoption compatible with their contracts.

Start a project with two lines

Open the agent in the destination directory and paste. Replace the second line with your product description:

Read https://raw.githubusercontent.com/soumatheusgomes/vibe-coding-toolkit/main/docs/prompts/11-next-project-bootstrap.md and execute setup in this directory.
Project: [name, problem, audience, main flows, and constraints].

Example: “CRM for small real estate agencies. Agents record contacts, deals, and tasks; managers track the pipeline by team. English interface, MVP focused on registration and tracking opportunities.”

The bootstrap ends with a configured foundation and the next MVP task identified. Authentication, services, and features depend on the product. An application without persistence may omit the database with a reason. The defaults are reviewed against current sources during execution.

Configure or update an existing project

Open the agent at the application root and paste:

Read https://raw.githubusercontent.com/soumatheusgomes/vibe-coding-toolkit/main/docs/prompts/12-existing-project-setup.md and execute the entire “Prompt” section block in this project, starting with brainstorming.

The prompt supports a codebase without the toolkit, partial adoption, or an older configuration. Work follows this path:

1. Understand: inspect product, stack, instructions, dependencies, integrations, and current checks.
2. Decide: brainstorm and present improvements, risks, dependencies, and completion criteria.
3. Configure: install, update, integrate, or reuse each applicable catalog component.
4. Improve: reconcile documentation and rules; organize code through incremental, verifiable changes.
5. Verify: compare before/after, test available integrations, and record limits and pending work.

Rerunning the prompt is part of maintenance. It checks the toolkit revision and current documentation, preserves customizations, and avoids duplicate instructions, skills, hooks, or MCP servers. Existing stack, database, and contracts are preserved; incompatible migrations require their own decision.

Prepare your machine

Read https://raw.githubusercontent.com/soumatheusgomes/vibe-coding-toolkit/main/docs/prompts/10-development-environment-setup.md and execute the entire “Prompt” section block on this computer.

Global setup handles system tools, Node.js, Docker, agents, plugins, and integrations. It records versions, scopes, backups, validations, and required interventions. Project setup reuses this environment.

Paste these texts into a conversation with an agent that has terminal access. Remote shortcuts use the version published on main; in an unpublished checkout, use the local file. No setup automatically publishes your application.

02 / Give agent work direction

Understand → design → plan when needed → implement → verify → review. Each stage makes the result more predictable. The process follows the request’s size and current authorization.

Capability chosen per task

With authorized model selection, the LLM chooses among models and effort levels actually available. Search, inventory, and mechanical changes favor lightweight capability; ambiguous decisions, security, data, and critical review receive enough capability for the risk.

The existing-project prompt authorizes this selection within the current client and authentication, respecting explicit restrictions. Without that policy, preserve the session model. Tool availability does not authorize changing providers, enabling a proxy, or creating API charges.

Parallel work when tasks allow it

• Each task has an objective, minimal context, permitted files, dependencies, acceptance criteria, and checks.
• One writer per file; lockfiles and shared configurations have a single owner.
• Parallel reviewers are read-only. The coordinator checks the diff and integration.
• Failures require diagnosis and possible escalation, with time and retry limits.
• Resumption checks actual files, checkout, and processes. An earlier summary does not prove current state.

Small changes can stay with the main agent. The orchestration protocol details criteria, recovery, and concurrency.

03 / Make knowledge survive the session

Harness engineering organizes the environment where the agent works: discoverable instructions, reliable context, accessible tools, reproducible commands, and verifiable feedback. The project keeps what the next agent needs to continue.

Each document has a purpose

The document manifest connects templates to the nine bootstrap destinations:

your-project/
├── README.md                 How to enter and run
├── PRODUCT.md                Problem, scope, and acceptance
├── AGENTS.md                 Shared commands and agreements
├── CLAUDE.md                 Bridge to shared instructions
└── docs/
    ├── architecture.md       Structure, boundaries, and decisions
    ├── design.md             Visual direction and accessibility
    ├── onboarding.md         Local preparation and first flow
    ├── quality.md            Checks, review, and limits
    └── setup.md              Sources, versions, evidence, and pending work

In an existing project, preserve equivalent canonical documents and record the mapping. A behavior, command, schema, or configuration change also updates its responsible document. Details stay in the correct source without turning AGENTS.md into an encyclopedia.

Available skills, actions on demand

For Next.js/React, the Vercel catalog covers best practices, composition, UI, writing, transitions, optimization, and Vercel operations, plus find-skills. React Native/Expo depends on the platform. Names come from SKILL.md and are checked upstream during setup.

Installing a deployment skill does not publish. Installing a transition skill does not require animations. Skills, MCP servers, and external memory enter the workflow when there is a relevant task and authorization.

04 / Replace “looks ready” with evidence

The toolkit distinguishes file present, configuration complete, and integration tested. Each check proves part of the result; pending work and pre-existing failures remain visible.

New rules in legacy code receive measurement and gradual adoption. Existing protections are not weakened to obtain a green report. The lint profile follows the stack; installing rules does not justify switching ORM or adding unused dependencies.

Review after implementation or fixes

Shared instructions scope review by risk and evidence. Nontrivial changes receive independent review when available, covering the exact diff and connected callers, contracts, and tests.

Finish when relevant findings are resolved or explicitly dispositioned, affected checks pass, and coverage and residual risks are recorded. Additional rounds need new evidence, unresolved risk, or an explicit request. Honor requested counts without resetting them after internal fixes. The security prompt supports read-only repository and diff reviews with private reports.

Evidence and limits

The foundation has documented validation on macOS, Linux, and Windows, with automated checks also on Ubuntu and Windows. The report distinguishes boundary tests, SQL, build, HTTP, and real integrations, and records advisories and known limits. Installation in another environment requires its own verification.

Checks are explicit. The toolkit does not install push blockers on main, require a branch/worktree, or add commit/push hooks. Client hooks use supported, verified integrations without duplication.

05 / A prompt library organized by goal

Choose a task, open the prompt, and copy the indicated block. The complete catalog includes usage and adaptation instructions.

Adopt one component at a time

To install only the quality gates:

Read https://raw.githubusercontent.com/soumatheusgomes/vibe-coding-toolkit/main/docs/prompts/08-eslint-quality-gates-install.md and execute the prompt in this project. Use MAX_LINES=350.

After measurement, prompt 09 guides large-file refactoring. For Vercel skills alone, use the catalog and local installation. Modular adoption remains available without running the entire setup.

06 / Understand what belongs where

Global and local

Claude Code and Codex have their own discovery and configuration mechanisms. Reuse a working global integration; personal content and credentials are not copied into templates. Installation and updates use the smallest supported scope, with explicit authorization limits.

Starting stack and compatibility

The toolkit is neither a custom generator nor a ready-made application. New scaffolds come from create-next-app; templates complement the foundation. Versions and APIs are checked during setup. Publishing, paid services, and incompatible migrations require relevant authorization.

07 / Explore the documentation

vibe-coding-toolkit/
├── README.md                 You are here
├── docs/                     Guides, defaults, and evidence
│   ├── tools/                Tools by purpose
│   └── prompts/              Copyable recipes
├── templates/                Files to adapt at the destination
└── scripts/                  Toolkit validation

Guides

Tools

The tool catalog maintains the complete index, installation links, and machine/project scope matrix.

Evaluate every option during setup; activate those that fit the project. Each guide covers requirements, installation, use, verification, and maintenance.

Templates

The template catalog includes documentation, Next.js core, ESLint profiles, Context7 configuration per client, Graphify exclusions, and hook examples. Copy and adapt only files you use; validate at the destination. The manifest is the reference for generated documents.

Verify this checkout

node --test scripts/validate-docs.test.mjs
node scripts/validate-docs.mjs
node scripts/validate-next.mjs

The first commands test the validator and check links, anchors, destinations, and JSON. The final command requires Node.js 24, npm, and network access; it creates a temporary project, runs foundation checks, and removes created resources. Product dependencies stay outside this repository’s root. See scope and evidence before interpreting results.

08 / Follow the project’s progress

If the toolkit helped you prepare a project or improve your workflow, a star makes it easier to find again and helps others discover the work.

Open star history · Report an issue · Suggest an improvement

The chart is provided by Star History and depends on that service’s availability. To contribute, describe the problem, keep public paths in English, and include relevant validation. Prompts and templates must remain portable, without secrets or personal settings.

Credits and license

Built on Superpowers, RTK, Ponytail, Caveman, Graphify, Context7, agent-browser, Vercel Agent Skills, and Skills CLI. Each project maintains its own license and distribution.

Toolkit licensed under MIT. By Matheus Gomes.

BUILD WITH INTENT. SHIP WITH FLOW.

Back to top ↑