# Quick Start Guide

Get started with AI-assisted development in 5 minutes.

## First Time Setup

1. **Clone this repository**
   ```bash
   git clone https://github.com/stavxyz/persuade.git
   cd persuade
   ```

2. **Browse the structure**
   ```bash
   # See what's available
   ls -la
   
   # Check out methodologies
   cat methodologies/ai-pair-programming.md
   
   # Look at templates
   ls templates/
   ```

3. **Try a playbook**
   - Open `playbooks/implementing-new-feature.md`
   - Follow along with your next feature implementation
   - Note what works and what doesn't

## Your First Contribution

Let's document something you learned today:

### Option 1: Quick Tip (30 seconds)

```bash
# Copy the template
cp templates/tip-template.md tips-and-tricks/prompting/my-discovery.md

# Edit it with your discovery
nano tips-and-tricks/prompting/my-discovery.md

# Commit
git add .
git commit -m "Added tip about [your discovery]"
git push
```

### Option 2: Use Claude to Help

Just tell Claude:
```
"Add a quick tip to my AI development knowledge base about [what you learned]"
```

Claude can create the file in the right place with the right format.

## Daily Workflow

### Morning (2 minutes)
```bash
git pull  # Get latest knowledge
# Skim recent additions for inspiration
```

### During Development
When you discover something useful:
1. Open Claude/AI assistant
2. Say: "Document this in my knowledge base: [your discovery]"
3. Or manually add to appropriate directory
4. Don't worry about perfection

### End of Day (5 minutes)
```bash
git status  # See what you've added
git add .
git commit -m "Daily learnings: [brief summary]"
git push
```

## Common Tasks

### I want to implement a feature
→ Read `playbooks/implementing-new-feature.md`

### I need a good prompt for [task]
→ Check `prompts/[category]/`

### I found a quirk with [AI model]
→ Document in `model-nuances/[model-name].md`

### I learned a useful trick
→ Add to `tips-and-tricks/[category]/`

### I developed a new workflow
→ Create in `playbooks/` or `methodologies/`

## Tips for Success

1. **Document immediately** - Knowledge is freshest now
2. **Don't overthink structure** - We can reorganize later
3. **Use templates** - They make it faster
4. **Tag everything** - Makes searching easier
5. **Iterate** - Start rough, refine over time

## Getting Help

- **Not sure where to put something?** Just pick a spot, we can move it
- **Don't know the format?** Copy an existing file
- **Template too complex?** Use the minimal version
- **Still confused?** Just create a markdown file anywhere with your notes

## Next Steps

After you're comfortable with the basics:

1. **Explore different sections** - See what others have documented
2. **Add your specialties** - Create files for tools you use
3. **Refine templates** - Adjust formats to match your style
4. **Share discoveries** - Help others learn from your experience

## Remember

This is **your** knowledge base. Make it work for you:
- Add sections you need
- Remove things you don't use
- Change formats that don't work
- Experiment with organization

**The best knowledge base is the one you actually use.**

## Quick Reference

```bash
# View structure
tree -L 2

# Search for content
grep -r "search term" .

# Find recent additions
git log --oneline --decorate --graph

# See your contributions
git log --author="your-name" --oneline
```

## Ready to Start?

Pick one thing you learned this week and document it. Right now. Don't overthink it.

That's all you need to get started! 🚀
