https://github.com/allthriveai/vibe-and-thrive
Free Tools and guardrails that catch common AI coding mistakes before they hit your codebase.
https://github.com/allthriveai/vibe-and-thrive
vibe-coding
Last synced: 5 months ago
JSON representation
Free Tools and guardrails that catch common AI coding mistakes before they hit your codebase.
- Host: GitHub
- URL: https://github.com/allthriveai/vibe-and-thrive
- Owner: allthriveai
- License: mit
- Created: 2025-12-10T03:17:25.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-04T07:16:55.000Z (6 months ago)
- Last Synced: 2026-01-13T19:44:29.577Z (5 months ago)
- Topics: vibe-coding
- Language: TypeScript
- Homepage:
- Size: 254 KB
- Stars: 3
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Vibe and Thrive
**Ship quality code faster with AI.**
A toolkit for implementing [RALPH](https://ghuntley.com/ralph/) with [Claude Code](https://docs.anthropic.com/en/docs/claude-code) that helps you go from idea to shipped code.
> You focus on what matters: your ideas. Brainstorm with `/idea`, then let Ralph handle the rest - coding, testing, and committing in an iterative loop until everything passes.
### This repo includes:
#### Customize
- **`/my-dna`** - Add your own voice and values to your claude.md (This helps you personalize your experience and output)
- **`/styleguide`** - Generate a UI component reference for consistent design (Stop AI from generating everything in purple add your unique style in an html and then reference it)
#### Autonmous Code Loops with RALPH principles
Run this in the terminal not in a claude cli session. It will use your claude subscription not an API key.
- **`npx ralph run`** - RALPH Autonomous loop: Brainstorm ideas → turn ideas into atomic prds → implement → verify → commit → repeat
#### Guardrails
- **`/vibe-check`** - manually run the same automated tests and guardrail checks at any time
- **`/review`** - manually run the same automated Security-focused code review with OWASP checks
- **Pre-commit hooks** - Automatically block secrets, hardcoded URLs, and security issues with precommit hooks from entering into your git repo. Catch and fix issues before your CI/CD does
- **Claude Code hooks** - Real-time warnings while coding (debug statements, secrets, hardcoded URLs)
---
See More for on how the [RALPH loop](docs/RALPH.md) works in this repo
---
## Getting Started
### Prerequisites
- Node.js 18+
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI installed and authenticated
- `jq` (for config management): `brew install jq` or `apt install jq`
- Optional: [Playwright](https://playwright.dev/) for browser verification (installed automatically by `/tour`)
## Step 0: Install
```bash
cd [your-project]
npm install vibe-and-thrive
```
This automatically sets up:
- Slash commands (`/idea`, `/review`, etc.)
- Pre-commit hooks (secrets, URLs, debug statements)
- Claude Code hooks (real-time warnings)
- Ralph configuration files
> **Note:** Claude Code hooks require `jq`. On macOS with Homebrew, it's installed automatically. On Linux, if you see a warning, run `sudo apt install jq` (or your package manager) then `npx ralph hooks`.
## Step 1: Start claude (--dangerously-skip-permissions is optional)
```bash
claude --dangerously-skip-permissions
```
## Step 1b: Optional run tour and customizations
Inside of a claude session run
```
/tour
```
1. The tour auto-detects your project settings and walks you through the workflow.
2. You can set up your own styleguide for all your frontend work to reference. I highly recommend you do this.
3. run /my-dna to add your own writing style, core values, and things you want represented in your application so that your app represents you and what you want.
### Step 2: Brainstorm Your Idea
```
/idea [describe your next feature]
```
Claude asks clarifying questions, explores your codebase, then generates:
- `docs/ideas/your-feature.md` - The documented idea
- `.ralph/prd.json` - Atomic stories for Ralph
Review and approve when prompted.
> **Note:** If Claude skips writing to `docs/ideas/`, tell it: "Please write the idea to docs/ideas/ and generate the PRD as the /idea command specifies"
### Step 3: Execute with Ralph
Type `/exit` or open a new terminal, then run:
```bash
npx ralph run
```
Ralph loops through stories one at a time, writes tests, verifies, and commits.
> **Pro tip:** Use two terminals - plan with Claude in one, run Ralph in another.
## Ralph Details
```
┌─────────────────────────────────────────────────────────────┐
│ RALPH LOOP │
├─────────────────────────────────────────────────────────────┤
│ │
│ 1. Read prd.json → find next story where passes=false │
│ 2. Build prompt (story + context + failures + signs) │
│ 3. Spawn Claude with prompt │
│ 4. Run verification (build, tests, browser, code review) │
│ 5. Pass? → commit, next story │
│ Fail? → save error, retry with failure context │
│ 6. Repeat until all stories pass │
│ │
└─────────────────────────────────────────────────────────────┘
```
---
## Documentation
| Doc | Description |
|-----|-------------|
| [How Ralph Works](docs/RALPH.md) | Architecture, config, troubleshooting |
| [Cheatsheet](docs/CHEATSHEET.md) | All commands, quick reference |
| [Workflow Guide](docs/WORKFLOW.md) | End-to-end development process |
| [Hooks Reference](docs/HOOKS.md) | Pre-commit and Claude Code hooks |
| [Bad Patterns](docs/BAD-PATTERNS.md) | AI code issues to avoid |
| [Prompting Guide](docs/PROMPTING-GUIDE.md) | Writing effective PROMPT.md |
| [TDD Guide](docs/TDD.md) | Test-driven development with Ralph |
| [Styleguide](docs/STYLEGUIDE.md) | Creating UI component references |
| [Contributing](docs/CONTRIBUTING.md) | How to contribute |
## Project Structure
```
vibe-and-thrive/
├── .claude/commands/ # Slash commands (/idea, /review, etc.)
├── ralph/ # Autonomous loop (Bash)
│ ├── hooks/ # Claude Code hooks (real-time warnings)
│ ├── browser-verify/ # Playwright verification
│ └── setup/ # Setup wizards (/tour)
├── src/ # Pre-commit checks (TypeScript)
│ └── checks/ # Check implementations (secrets, urls, etc.)
├── templates/ # Files for user projects
│ ├── PROMPT.md # Base prompt for Ralph sessions
│ ├── config/ # Project type configs (node, python)
│ ├── optional/ # Extra configs (eslint, vscode, etc.)
│ └── examples/ # Example CLAUDE.md files by stack
├── docs/ # Documentation
└── bin/ # CLI entry points (ralph, vibe-check)
```
### Three Layers of Quality Checks
| Layer | When | What |
|-------|------|------|
| **Slash commands** | In Claude Code CLI | `/vibe-check`, `/review` - on-demand checks |
| **Claude Code hooks** | While Claude writes code | Real-time warnings (debug statements, secrets) |
| **Pre-commit hooks** | At `git commit` | Blocks secrets, URLs, debug statements |
---
## Troubleshooting
### "SessionStart: startup hook error"
This means Claude Code hooks are configured but the hook scripts can't be found. Fix with:
```bash
# Reinstall project hooks
npx ralph hooks --force
# Or reinstall global hooks (if using vibe-and-thrive source repo)
/path/to/vibe-and-thrive/ralph/hooks/install.sh --global --force
```
### Hooks not working after moving project
Claude Code hooks use absolute paths. After moving a project or cloning on a new machine, reinstall hooks:
```bash
npx ralph hooks --force
```
### Team members getting hook errors
`.claude/settings.json` contains machine-specific paths and should not be committed to git. The postinstall script automatically adds it to `.gitignore`. Each team member's hooks are configured when they run `npm install`.
If `.claude/settings.json` was accidentally committed:
```bash
git rm --cached .claude/settings.json
echo ".claude/settings.json" >> .gitignore
git commit -m "Remove machine-specific settings from git"
```
### jq not installed
Claude Code hooks require `jq` for JSON manipulation. On macOS with Homebrew, `npx ralph hooks` installs it automatically. On Linux:
```bash
# Ubuntu/Debian
sudo apt install jq
# Fedora/RHEL
sudo dnf install jq
# Then install hooks
npx ralph hooks
```
---
## License
MIT - see [LICENSE](LICENSE)
---
Built by [AllThrive AI](https://allthrive.ai)