> ## 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.

# Development Workflows

> How we execute new projects and implement features

## Workflow Types

We follow structured workflows for both new projects and feature development to ensure consistent quality and delivery.

<CardGroup cols={2}>
  <Card title="New Project Workflow" icon="sparkles" href="/workflows/new-project">
    Complete process from discovery to deployment for greenfield projects
  </Card>

  <Card title="Feature Implementation" icon="puzzle-piece" href="/workflows/feature-implementation">
    Adding capabilities to existing products with minimal disruption
  </Card>
</CardGroup>

## Core Principles

<CardGroup cols={3}>
  <Card title="AI-Assisted" icon="robot">
    Claude Code for planning, Codex for review
  </Card>

  <Card title="Phased Delivery" icon="stairs">
    Small, testable increments
  </Card>

  <Card title="Human-in-the-Loop" icon="user-check">
    You supervise and validate
  </Card>
</CardGroup>

## Quick Reference

### Engineering Standards

<Tabs>
  <Tab title="Frontend">
    * **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)
  </Tab>

  <Tab title="Backend">
    * **Database**: Supabase (Postgres)
    * **Auth**: Supabase Auth with RLS
    * **APIs**: Next.js Route Handlers, tRPC
    * **Edge Functions**: Supabase for serverless
    * **ORM**: Prisma or Drizzle
  </Tab>

  <Tab title="AI/ML">
    * **Orchestration**: LangChain, LangGraph
    * **Models**: Open-weights (DeepSeek, Llama)
    * **Inference**: Together AI
    * **Chat**: Supabase Edge Functions
    * **Vector DB**: pgvector
  </Tab>

  <Tab title="DevOps">
    * **CI/CD**: GitHub Actions
    * **Hosting**: Vercel, Railway, GCP/AWS
    * **Monitoring**: Sentry
    * **Analytics**: Plausible, PostHog
    * **CDN**: Cloudflare
  </Tab>
</Tabs>

## Quality Gates

<Steps>
  <Step title="Code Quality">
    ESLint + Prettier with pre-commit hooks
  </Step>

  <Step title="Type Safety">
    TypeScript strict mode, Zod validations
  </Step>

  <Step title="Testing">
    Vitest/Jest units, Playwright E2E
  </Step>

  <Step title="Security">
    Auth checks, RLS policies, rate limiting
  </Step>

  <Step title="Accessibility">
    ARIA roles, keyboard nav, contrast checks
  </Step>
</Steps>

## Daily Workflow

<Accordion title="Morning Routine">
  ```bash theme={null}
  # 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
  ```
</Accordion>

<Accordion title="Development Loop">
  ```bash theme={null}
  # Start dev server
  pnpm dev

  # Run tests in watch mode
  pnpm test:watch

  # Check types continuously
  pnpm typecheck:watch
  ```
</Accordion>

<Accordion title="End of Day">
  ```bash theme={null}
  # 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
  ```
</Accordion>

## Definition of Done

<Checklist>
  <Check>Feature matches acceptance criteria</Check>
  <Check>Tests pass locally and in CI</Check>
  <Check>Code reviewed by Codex and human</Check>
  <Check>Documentation updated</Check>
  <Check>Sentry shows clean deployment</Check>
  <Check>Performance within budgets</Check>
</Checklist>

## Common Commands

<CodeGroup>
  ```bash Development theme={null}
  pnpm dev          # Start dev server
  pnpm build        # Production build
  pnpm lint         # Run ESLint
  pnpm format       # Run Prettier
  pnpm typecheck    # TypeScript check
  ```

  ```bash Testing theme={null}
  pnpm test         # Run unit tests
  pnpm test:e2e     # Run Playwright tests
  pnpm test:watch   # Watch mode
  pnpm coverage     # Coverage report
  ```

  ```bash Database theme={null}
  pnpm db:migrate   # Run migrations
  pnpm db:generate  # Generate types
  pnpm db:seed      # Seed data
  pnpm db:reset     # Reset database
  ```
</CodeGroup>

## Getting Help

<CardGroup cols={3}>
  <Card title="Driver Docs" icon="file-lines">
    Check claude.md, plan.md, agents.md
  </Card>

  <Card title="Team Slack" icon="slack">
    Quick questions in #dev channel
  </Card>

  <Card title="GitHub Issues" icon="github">
    Bug reports and feature requests
  </Card>
</CardGroup>