Start new project structure
Create a new project structure in this directory according to these guidelines. You will create a few files and dirs.
Create a minimal README.md file in the root as follows, filling in the information as needed:
# [Project Name]
**[1-2 sentence description of what this project does]**
## Quick Start
```bash
# Basic setup commands
npm install
npm run dev
- ✅ [Completed feature]
- 🚧 [In progress feature]
- 📋 [Planned feature]
📖 Full Documentation - Complete setup and development guide
📋 Current Tasks - What's being worked on now
🔧 Quick Reference - Commands and common fixes
## docs/start-here.md
Create a docs/start-here.md file as follows, filling in the information as needed:
```start-here.md
# START HERE - [project name] Development
## 🎯 What You're Building
**[project name]** - [1-2 sentence description of project]
**Current Status**: [1-2 sentence very high-level update of where the project is]
**Your Mission**: [upcoming big tasks, projects]
## 🚀 Quick Start (5 minutes)
### 1. Get the Code Running
[a bash code block example of how to get the code up and running, with all relevant steps/commands, if we're at that stage -- aim to be maximally helpful here]
### 2. Your Roadmap
Work through these in order:
[a numbered list of done/todo items -- below are example rows to show you the format we use]
[example: 1. ✅ **[Phase 1: Database Setup](dev-guides/01-DATABASE-SETUP.md)** - COMPLETED]
[example: 2. ✅ **[Phase 1A: Security & RLS](dev-guides/01A-SECURITY-RLS.md)** - COMPLETED (July 30, 2025)]
[example: 3. 🚨 **[Phase 1B: Backend Authentication](dev-guides/01B-BACKEND-AUTH.md)** ← **DO THIS NEXT**]
[example: 5. **[Phase 2: Payment Integration](dev-guides/02-PAYMENTS.md)**]
[example: 6. **[Phase 3: User Features](dev-guides/03-USER-FEATURES.md)**]
## 📚 Documentation Structure
### When You Need Help
- **[quick-reference.md](quick-reference.md)** - Commands, URLs, and common fixes
- **[tasks/](tasks/)** - Step-by-step implementation task lists -- your checklist for getting things done
- **[reference/](reference/)** - Deep technical documentation (read only if needed)
- **[how-to-guides/](how-to-guides/)** - Project-specific walkthroughs (e.g. Supabase CLI setup)
### Key Principle
**Read docs just-in-time**. Start with the next task that needs to be done (which you get from a mixture of reading this doc and verifying in tasks/ dir files), and reference other docs only when you need specific information. It's important to work on the correct next thing, so take a small amount of extra time in the beginning to make sure you're looking at the next tasks.
## ✅ Success Criteria
MVP is complete when:
- Users can pay via Stripe
- Daily emails with podcast summaries are sent automatically
- Users can manage their subscriptions
- System runs without manual intervention
## 🎯 **Ready? Go look for the next task to do, then create a plan, and get to work →**
Create a docs/tasks/ dir (if it doesn't exist already) with the following structure:
./docs/tasks
├── active
│ ├── 01-[name of prioritized task or feature].md
│ └── 02-[name of prioritized task or feature].md
├── backlog
│ └── [backlog task or feature name].md
├── completed
│ ├── [completed task or feature name].md
│ ├── [completed task or feature name].md
│ └── [completed task or feature name].md
└── README.md
The README.md should be this:
# Task Management System
This directory organizes development tasks and technical improvements for the [project name] repository.
## Directory Structure
### `active/`
Current high-priority tasks that need to be completed in sequence. Files are prefixed with numbers (01-, 02-, etc.) to indicate order.
### `backlog/`
Tasks that should be done but have no specific timeline or order. Includes performance improvements, technical debt, and nice-to-have features.
### `completed/`
Archive of completed tasks. Move files here when done to maintain history of what's been accomplished.
## File Naming Conventions
**Active tasks:** `01-description.md`, `02-description.md`
**Backlog tasks:** `descriptive-name.md`
**Completed tasks:** Keep original name, optionally add completion date
## Task Format
Each task file should include the following, in this order:
- **Summary**: 2-3 sentences describing the issue/improvement
- **Action Items**: Specific steps to complete as md checkboxes, with short notes about the task (if it's stalled, if there are important details or caveats, etc.)
- **Technical Details**: Relevant code locations, dependencies, etc.
## Usage
1. Check `active/` for next priority task
2. Create new tasks in appropriate directory
3. Move completed tasks to `completed/`
4. Review `backlog/` during planning sessions
Create the docs directory structure with the following subdirectories and files:
📁 docs/
├── 📁 tasks/ → Actionable checklists and TODOs
├── 📁 how-to-guides/ → Project-specific walkthroughs (e.g. Supabase CLI setup)
├── 📁 reference/ → In-depth conceptual docs (e.g. auth flow diagram, schema)
├── 📄 start-here.md → Main project development guide
└── 📄 quick-reference.md → One-pager for frequent lookups
Populate how-to-guides and reference with any documentation that already exists or extremely high value docs that should exist, but no need to create things here just for the sake of it.
