Quick Start Guide
TL;DR
./run-sessions.sh
Press ENTER when prompted, copy the Claude prompt, start Claude Code, paste, and go!
What You Need to Know
The Plan
- 17 sessions to complete the project
- 100-120 hours of work total
- Sprint 4 (Sessions 1-4): CV Upload + Admin Nav + Testing → Deploy
- Sprint 5 (Sessions 5-15): Knowledge Base feature → Deploy
- Post-Sprint (Sessions 16-17): Optimization + Cleanup
The Script
- Runs in infinite loop
- Shows session details
- Provides Claude prompts
- Tracks progress automatically
- Resumes where you left off
Session Controls
- ENTER - Start current session
- s - Skip to next session
- q - Quit script
First Time Setup
# Make sure you're in the project root
cd /Users/sarkout/projects/prive/mahmoud-consultancy
# Make script executable (if not already)
chmod +x run-sessions.sh
# Start the session runner
./run-sessions.sh
Session 1 Preview
What: CV Upload Button Component
Time: 2-3 hours
Tasks: Create button component, add to homepage, handle auth states, make responsive
Result: Users can click to upload their CV
After Each Session
- Review the deliverables
- Run tests if applicable
- Commit your changes
- Press ENTER to advance to next session
Files to Know
- SESSION_PLAN.md - Detailed specs for all 17 sessions
- SESSION_RUNNER_README.md - Complete usage guide
- SESSION_SETUP_COMPLETE.md - Summary of what's been done
- run-sessions.sh - The script you'll run
- .session-state - Tracks current session (auto-created)
Useful Commands
# Check current session number
cat .session-state
# Jump to specific session (e.g., Session 5)
echo "5" > .session-state
# Start over from Session 1
rm .session-state
# View session plan
cat SESSION_PLAN.md
Parallel Work (Advanced)
If you want to run multiple sessions in parallel:
# Terminal 1
./run-sessions.sh
# Do Session 1
# Terminal 2
./run-sessions.sh
# Press 's' twice to skip to Session 3
# Do Session 3 (Admin Nav can run parallel to Sessions 1-2)
Getting Help
- Read
SESSION_RUNNER_README.md for detailed usage
- Check
SESSION_PLAN.md for session specifications
- Review
docs/ directory for implementation guides
Expected Timeline
Full-Time Work:
- Sprint 4: 2-3 days
- Sprint 5: 2-3 weeks
- Total: 3-4 weeks
Part-Time Work:
- Sprint 4: 1 week
- Sprint 5: 4-6 weeks
- Total: 6-8 weeks
Deploy Checkpoints
- 🚀 After Session 4 - Platform ready for production (without KB)
- 🚀 After Session 15 - Complete platform with KB ready
- 🎉 After Session 17 - Project 100% complete
Ready?
./run-sessions.sh
Good luck! 🚀
Reacties