← Back to Vibeconfig

How to use Vibeconfig

Works with Claude Code CLI, VS Code, JetBrains, and the web app. Takes 30 seconds.

Before you start

You need an existing Next.js 15+ project with TypeScript and Tailwind CSS.

# If you don't have a project yet:
npx create-next-app@latest my-saas --typescript --tailwind --app --src-dir

Install (all environments)

The same install works for CLI, VS Code extension, JetBrains extension, and web app.

1

Unzip the pack

unzip vibeconfig-claude.zip
2

Copy files into your project

cd your-project

cp vibeconfig-claude/CLAUDE.md .
cp -r vibeconfig-claude/.claude .
cp vibeconfig-claude/plan.md .
3

Start building

claude "Build me a SaaS with auth and Stripe payments"

Claude reads CLAUDE.md automatically. Rules load when you edit matching files. Skills are available as /scaffold-auth, /scaffold-stripe, etc.

For the web app (claude.ai/code)

1

Push to your repo first

git add CLAUDE.md .claude/ plan.md
git commit -m "chore: add vibeconfig rules"
git push
2

Open in claude.ai/code

Select your repo. Claude Code reads CLAUDE.md and .claude/ from the repo root automatically.

Using plan.md

1

Open plan.md

11 sections: project overview, database schema, auth strategy, payment model, features, API endpoints, pages, env vars, deployment, security, performance.

2

Fill it out

"I want to build a project management tool with teams,
tasks, and Stripe billing. Help me fill out plan.md."
3

Build from the plan

Claude reads plan.md before every feature and follows your architecture decisions.

Verify it works

1

Check rules are loaded

"What rules are you following for this project?"
2

Test a skill

/scaffold-auth

Troubleshooting

Claude doesn't follow the rules

Make sure CLAUDE.md is at the project root (same level as package.json). Restart Claude Code after adding files.

Skills don't show up

Make sure .claude/skills/ is at the project root. Type / in Claude Code to see available commands.

Hooks block me from editing on main

Intentional. Create a feature branch: git checkout -b feat/my-feature

My project doesn't use src/

Update the paths: field in .claude/rules/*.md to match your project layout.

← Back to Vibeconfig