Documentation Index
Fetch the complete documentation index at: https://docs.weventures.ai/llms.txt
Use this file to discover all available pages before exploring further.
Workflow Types
We follow structured workflows for both new projects and feature development to ensure consistent quality and delivery.
New Project Workflow
Complete process from discovery to deployment for greenfield projects
Feature Implementation
Adding capabilities to existing products with minimal disruption
Core Principles
AI-Assisted
Claude Code for planning, Codex for review
Phased Delivery
Small, testable increments
Human-in-the-Loop
You supervise and validate
Quick Reference
Engineering Standards
Frontend
Backend
AI/ML
DevOps
- Languages: TypeScript (strict mode)
- Frameworks: Next.js 14+, React 18+
- Styling: Tailwind CSS, shadcn/ui
- 3D: three.js, react-three-fiber, drei
- State: React Query, Zustand (minimal)
- Database: Supabase (Postgres)
- Auth: Supabase Auth with RLS
- APIs: Next.js Route Handlers, tRPC
- Edge Functions: Supabase for serverless
- ORM: Prisma or Drizzle
- Orchestration: LangChain, LangGraph
- Models: Open-weights (DeepSeek, Llama)
- Inference: Together AI
- Chat: Supabase Edge Functions
- Vector DB: pgvector
- CI/CD: GitHub Actions
- Hosting: Vercel, Railway, GCP/AWS
- Monitoring: Sentry
- Analytics: Plausible, PostHog
- CDN: Cloudflare
Quality Gates
Code Quality
ESLint + Prettier with pre-commit hooks
Type Safety
TypeScript strict mode, Zod validations
Testing
Vitest/Jest units, Playwright E2E
Security
Auth checks, RLS policies, rate limiting
Accessibility
ARIA roles, keyboard nav, contrast checks
Daily Workflow
# Pull latest changes
git pull origin main
# Check plan.md for today's scope
cat plan.md
# Create or continue feature branch
git checkout -b feat/your-feature
# Start dev server
pnpm dev
# Run tests in watch mode
pnpm test:watch
# Check types continuously
pnpm typecheck:watch
# Run all checks
pnpm lint && pnpm typecheck && pnpm test
# Commit with conventional message
git add .
git commit -m "feat: implement user dashboard"
# Push and create PR
git push -u origin feat/your-feature
gh pr create
Definition of Done
Common Commands
pnpm dev # Start dev server
pnpm build # Production build
pnpm lint # Run ESLint
pnpm format # Run Prettier
pnpm typecheck # TypeScript check
Getting Help
Driver Docs
Check claude.md, plan.md, agents.md
Team Slack
Quick questions in #dev channel
GitHub Issues
Bug reports and feature requests
