Skip to main content

​
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

  • 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

1

Code Quality

ESLint + Prettier with pre-commit hooks
2

Type Safety

TypeScript strict mode, Zod validations
3

Testing

Vitest/Jest units, Playwright E2E
4

Security

Auth checks, RLS policies, rate limiting
5

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