vibe-coding-tutor

# Vibe Coding Tutor V2: "Superpowers" Edition

AI skill that teaches you while coding through interactive MCQs, design questions, **TDD enforcement, and systematic debugging**.

> *"Never write final code before asking and confirming design questions."*
> *"No production code without a failing test first."*

---

## 🚀 Installation

### Option 1: Add as Marketplace

1. Register this repository as a marketplace:
   ```
   /plugin marketplace add N1KH1LT0X1N/vibe-coding-tutor
   ```
2. Install the skill:
   ```
   /plugin install vibe-coding-tutor@vibe-coding-tutor-marketplace
   ```

### Option 2: Browse & Install

1. Run `/plugin`
2. Select "Browse and install plugins"
3. Select `vibe-coding-tutor-marketplace`
4. Select `vibe-coding-tutor`
5. Click "Install now"

---

## ✨ New in Version 2.0

Upgrade your workflow with **Superpowers**:

### 🛡️ The Iron Laws
The skill now enforces professional software engineering standards:
1. **TDD Iron Law**: No production code without a failing test first.
2. **Debugging Iron Law**: No fixes without root cause investigation.
3. **Verification Iron Law**: No completion claims without fresh evidence.
4. **Vibe Check Iron Law**: No code before design confirmation.

### 🛠️ Enhanced Workflow
- **Planning Engine**: Generates TDD implementation plans with bite-sized tasks.
- **Debug Engine**: Activates 4-Phase Systemic Debugging when tests fail.
- **State Persistence**: Resumes exactly where you left off, even between sessions.

---

## 🎮 How It Works

When activated on code requests, the skill leads you through 7 states:

1. **Discovery**: Extracts decision points from your request.
2. **Vibe Check**: Asks design MCQs (Best Practice vs Naive vs Tradeoff).
3. **Confirmation**: Summarizes choices for approval.
4. **Planning**: Creates a step-by-step TDD plan.
5. **Execution**: Implements tasks (Test → Fail → Code → Pass).
6. **Verification**: validats everything works.
7. **Systematic Debugging**: (Fallback) Guides you through root cause analysis if tests fail.

---

## 📁 Skill Structure

```
skills/vibe-coding-tutor/
├── SKILL.md             # Main skill instructions (Iron Laws & Workflow)
├── scripts/
│   ├── plan_engine.py   # [NEW] TDD Plan Generator
│   ├── debug_engine.py  # [NEW] 4-Phase Debugging Logic
│   ├── state_manager.py # [UPDATED] Persists plans & sessions
│   └── ...
├── templates/
│   ├── tdd_plan.md      # [NEW] TDD Plan Template
│   ├── debug_session.md # [NEW] Debug Session Template
│   └── ...
└── references/
    ├── iron_laws.md     # [NEW] The Non-Negotiable Rules
    └── ...
```

## 📝 License

MIT © Nikhil