vibe-coding-claude-md

English · 한국어

A CLAUDE.md generator for vibe coding — itself vibe-coded.

▶ Live demo: https://whoridechicken.github.io/vibe-coding-claude-md/ · 🧩 Single file: open index.html in any browser

---

What

A single HTML file that walks you step-by-step to a clean CLAUDE.md for Claude Code.

• No install, no server, no build — open one file and go
• Zero network requests — your input never leaves the browser (autosave uses local localStorage only)
• Save the result as CLAUDE.md, then ask Claude Code to "refine it against our actual code"

Why (the meta)

Hand-writing CLAUDE.md for every project got old — so I vibe-coded a tool, with Claude Code, to make it. A tool for better vibe coding, made by vibe coding. 🌀

Features

• 👩‍💻 Developer mode / 🙋 Non-developer mode — completely separate flows (non-dev gets auto-recommended stack & commands, no jargon)
• 🌐 EN / KR toggle — UI and generated output switch together; selections are preserved
• 🧱 Domain-aware stack & architecture suggestions (web / mobile / API / game / desktop / automation / library…)
• ✅ Bakes in verified best practices: ≤200-line guard, build/test/verify commands, way of working, source of truth, security rules, Definition of Done, @import, .claude/rules example
• 💾 Autosave & resume (survives refresh / accidental navigation)
• ⌨️ Keyboard navigation & a11y (focus-visible, reduced-motion)

Screens

Mode select — developer vs non-developer	Coding rules — verifiable, chip-based
Security guardrails	Review & generated CLAUDE.md

How to use

1. Open index.html in a browser (or the live demo)
2. Pick a mode → go step by step → review & edit at the end
3. 📋 Copy or ⬇ Download → save as CLAUDE.md in your project root
4. In that folder, tell Claude Code:

   Review and refine this CLAUDE.md against our actual code. Where it differs from the code, fix it to match the code, and fill in missing build/test/verify commands and domain terms. Keep it under 200 lines.

Privacy

100% client-side. No network requests. Inputs stay in the browser and autosave is written only to this browser's localStorage. (A static host may keep standard access logs like any website, but the tool itself adds no analytics or tracking.)

Unofficial

Unofficial project. Not affiliated with Anthropic. "Claude" is a trademark of Anthropic.

License

MIT © 2026 WooWon Jin

Contributing

Issues & PRs welcome — it's a single file, easy to read end-to-end.