1. AGENTS.md

   - REQUIRED (master plan)

2. agent_docs/

   directory - REQUIRED (detailed specs)

3. docs/PRD-*.md

   - Reference for requirements

4. docs/TechDesign-*.md

   - Reference for implementation

/vibe-agents

1. Read

   AGENTS.md

   to understand current phase and tasks
2. Load relevant

   agent_docs/

   files for the current task
3. Propose a brief implementation plan
4. Wait for user approval before proceeding

Plan for: User Authentication

1. Set up auth provider (Supabase/Firebase)
2. Create login/signup components
3. Add protected route wrapper
4. Test login flow

Shall I proceed?

1. Implement ONE feature at a time
2. Follow patterns in

   agent_docs/code_patterns.md

3. Use tech stack from

   agent_docs/tech_stack.md

4. Keep changes focused and minimal
5. Commit after each working feature

1. Run tests:

   npm test

   (or equivalent)
2. Run linter:

   npm run lint

3. Manual smoke test if needed
4. Fix any issues before moving on
5. Update

   AGENTS.md

   current state

1. Initialize project with chosen stack
2. Set up development environment
3. Configure database connection
4. Set up authentication
5. Create basic project structure

1. Identify the simplest implementation
2. Create database schema if needed
3. Build backend logic
4. Create frontend components
5. Connect and test end-to-end

1. Add error handling
2. Improve mobile responsiveness
3. Add loading states
4. Optimize performance
5. Add analytics

1. Deploy to production
2. Set up monitoring
3. Run through launch checklist
4. Document any manual steps

Created

LoginForm.tsx

with email/password fields. Running tests... Tests pass. Ready for next feature?

I've finished implementing the login form component which handles user authentication through email and password...

• User authentication
• [Next feature]

undefined

1. Don't apologize - just fix it
2. Explain briefly what went wrong
3. Show the fix
4. Verify it works
5. Move on

Build error: Missing dependency. Installing

@supabase/auth-helpers-nextjs

... Fixed. Continuing with auth setup.

• Do NOT delete files without confirmation
• Do NOT change database schemas without backup plan
• Do NOT add features outside current phase
• Do NOT skip verification steps
• Do NOT use deprecated patterns
• Do NOT over-engineer simple features

1. State what you're trying to do
2. Explain what's unclear
3. Ask ONE specific question
4. Wait for response

I need to implement file uploads. The PRD mentions image storage but doesn't specify a provider. Should I use Cloudinary (free tier) or Supabase Storage?

MVP Complete!

What's Built:

• [List of features]

Deployed To: [URL]

Next Steps:

1. Share with 5-10 beta testers
2. Collect feedback
3. Prioritize v2 features

Congratulations on shipping your MVP!