docs

YC Co-Founder Bot Documentation

Quick Links

🚀 Getting Started

• Project Status & Quick Start - Current state and how to run
• Development Environment - Setup instructions

📖 Core Documentation

• Product Brief - What this bot does
• Architecture - System design
• Operations & Safety - Safety mechanisms

🔧 Technical Reference

• OpenAI API Guide - API usage patterns
• YC UI Structure - Browser automation details
• Event Schema - Logging format

💻 Development

• Project Structure - Code organization
• Engineering Guidelines - Clean code practices
• Testing & Quality - Test strategy

Project Overview

A bot that automates finding co-founders on YC's Startup School platform by:

1. Browsing profiles automatically using Playwright
2. Evaluating matches with GPT-4 AI
3. Messaging high-quality candidates

Current Status (September 2025)

✅ Core functionality working - Browser automation, AI evaluation, and messaging all functional

⚙️ Configuration needed - Set YC credentials and OpenAI API key in .env

📋 One known fix applied - Removed unsupported response_format parameter for GPT-4

File Organization

docs/
├── README.md              # This file
├── core/                  # Product & design docs
├── technical/             # Implementation details
├── development/           # Dev setup & guidelines
└── archive/              # Historical/outdated docs

Primary References

• CLAUDE.md (root) - AI assistant instructions
• README.md (root) - Project overview
• .env.example - Configuration template