minlite

MinLite

Lightweight vibe coding methodology for Claude Code

MinLite is a development workflow system for Claude Code that helps you build software through natural conversation while maintaining clear documentation and code structure.

What is MinLite?

MinLite is a vibe coding methodology - a structured approach to AI-assisted development that:

• 🎯 Scans your existing codebase and generates smart indexes
• 📚 Organizes documentation automatically for AI context
• 🔨 Implements features through natural language commands
• 📝 Maintains change logs across docs, code, and resources
• ✅ Tracks TODOs with structured task management

Philosophy: Write code by describing what you want, not how to do it. Let AI handle the implementation details while you focus on product vision.

Installation

Run in your project directory (works with any git repository):

npx minlite@0.4.4

Or use the latest version:

npx minlite

This will:

• Create .minlite/ directory structure
• Install 4 slash commands to .claude/commands/
• Set up 3 AI skills for documentation and code management
• Initialize configuration and index files

Quick Start

For NEW Projects

Just start implementing features:

/min.impl Add user authentication with JWT

MinLite will guide you through the implementation with AI assistance.

For EXISTING Projects

First, scan your codebase:

/min.scan

This will:

• Scan code files and generate a detailed index with tech stack info
• Discover documentation files in your project
• Ask if you want to archive docs (optional, for better AI context)

Then implement new features:

/min.impl Add password reset functionality

Available Commands

/min.scan

Scan existing codebase and generate code indexes.

What it does:

• Finds all code files (Python, JS, TS, Go, Rust, etc.)
• Analyzes tech stack (frameworks, libraries)
• Generates .minlite/code-docs/index.md with file descriptions
• Optionally archives documentation for AI context

/min.impl <description>

Implement new features with AI assistance.

What it does:

• Reads existing code structure and docs
• Generates implementation plan
• Writes code with proper architecture
• Updates code indexes and changelogs
• Creates TODOs for testing and documentation

Example:

/min.impl Add email verification for user registration

/min.add

Process and archive documentation files.

Usage:

• Copy docs to .minlite/resources/inbox/
• Run /min.add
• AI will organize them into .minlite/docs-for-ai/

/min.log [type]

View change logs (docs/code/resources).

How It Works

1. Code Indexing

MinLite scans your code and generates human-readable indexes:

# Code Index

## Tech Stack
- Backend: Python + FastAPI + SQLAlchemy
- Frontend: React + TypeScript + Vite

## Code Structure

### backend/app/api/
- `backend/app/api/auth.py` - FastAPI auth routes, JWT login/register
- `backend/app/api/user.py` - User management API, CRUD + permissions

AI uses these indexes to understand your codebase without reading every file.

2. Vibe Coding

Describe features in natural language:

/min.impl Add two-factor authentication using TOTP

AI will:

• Read code indexes and docs
• Plan the implementation
• Write code following your architecture
• Update indexes and changelogs
• Create TODOs for testing

Philosophy

MinLite embraces "vibe coding" - development through natural language:

• No rigid specs - Describe what you want, AI figures out how
• Living documentation - Docs evolve with code automatically
• Context-aware - AI reads your code structure and docs
• Fast iteration - Focus on product, not implementation details

Perfect for:

• 🚀 Startups moving fast
• 👤 Solo developers
• 🔬 Prototyping and experiments
• 🎯 Feature-driven development

Requirements

• Claude Code (the official CLI for Claude)
• Git repository (recommended but not required)
• Node.js 14+ (for installation)

Version

0.4.4

License

MIT

Happy vibe coding! 🎉