Vibe Engineering Starter Kit

A copy-pasteable foundation for AI-assisted development workflows.

From the article series: Vibe Engineering: From Random Code to Deterministic Systems

What's Included

.
├── QUICKSTART.md          # Get started in 15 minutes
├── PERSONAS.md            # Personas for multi-perspective code review
├── PRODUCT_SPEC.md        # Template for defining what you're building
├── WORKLOG.md             # Template for tracking multi-session work
├── examples/              # Real examples from the article series
│   ├── PRODUCT_SPEC_EXAMPLE.md   # User registration flow example
│   ├── SYSTEM_SPEC_EXAMPLE.md    # API contract example
│   ├── CI_SPEC_EXAMPLE.md        # CI job documentation example
│   └── WORKLOG_EXAMPLE.md        # Complete feature worklog example
├── articles/              # The full article series
│   └── 01_Part1_...       # Part 1: You Haven't Been Replaced — You've Been Promoted
├── .claude/
│   └── skills/
│       ├── feature-dev/     # Skill for implementing features with TDD
│       ├── post-mortem/     # Skill for capturing lessons after shipping
│       └── medium-editing/  # Skill for editing Medium articles via Playwright
└── archive/               # How this repo was built (worklog + outline)

Quick Start

⚡ First 15 Minutes — Get a tiny win before reading the theory.

Or if you want the full setup:

1. Copy these files into your project root
2. Fill in PRODUCT_SPEC.md with your product's happy paths, sad paths, and constraints
3. When starting a feature, create a WORKLOG.md from the template
4. Invoke personas during review: "@Security-Agent, review this change"
5. After shipping, run /post-mortem to capture lessons

The Core Loop

Spec → Implement → Persona Review → Ship → Post-Mortem → Update Skills
         ↑                                                    │
         └────────────────────────────────────────────────────┘

The feedback loop is what makes this work. Post-mortems improve skills. Skills improve the next feature. The system gets smarter with each iteration.

Customization

• Add domain-specific personas to PERSONAS.md (e.g., @Performance-Agent, @Accessibility-Agent)
• Create new skills in .claude/skills/ for repeatable tasks in your codebase
• Extend WORKLOG.md with project-specific sections

Learn More

Read the full article series for the philosophy behind this workflow:

• Part 1: You Haven't Been Replaced — You've Been Promoted
• Part 2: Personas — How to Think With AI
• Part 3: Skills — How to Encode What You Learn
• Part 4: Worklogs — How AI Work Persists Over Time
• Part 5: The Feedback Loop — How Systems Improve Themselves (coming soon)
• Part 6: Designing Failure Before It Designs You (coming soon)
• Part 7: Scaling the Vibes (coming soon)

---

Created by Andrew Orobator and Claude Opus 4.5