Development Workflows

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)

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

Morning Routine

# 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

Development Loop

# Start dev server
pnpm dev

# Run tests in watch mode
pnpm test:watch

# Check types continuously
pnpm typecheck:watch

End of Day

# 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

pnpm test         # Run unit tests
pnpm test:e2e     # Run Playwright tests
pnpm test:watch   # Watch mode
pnpm coverage     # Coverage report

pnpm db:migrate   # Run migrations
pnpm db:generate  # Generate types
pnpm db:seed      # Seed data
pnpm db:reset     # Reset database

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

Development Process

CI/CD

Workflow Types

New Project Workflow

Feature Implementation

Core Principles

AI-Assisted

Phased Delivery

Human-in-the-Loop

Quick Reference

Engineering Standards

Quality Gates

Daily Workflow

Definition of Done

Common Commands

Getting Help

Driver Docs

Team Slack

GitHub Issues

​Workflow Types

New Project Workflow

Feature Implementation

​Core Principles

AI-Assisted

Phased Delivery

Human-in-the-Loop

​Quick Reference

​Engineering Standards

​Quality Gates

​Daily Workflow

​Definition of Done

​Common Commands

​Getting Help

Driver Docs

Team Slack

GitHub Issues

Workflow Types

Core Principles

Quick Reference

Engineering Standards

Quality Gates

Daily Workflow

Definition of Done

Common Commands

Getting Help