Skip to main content

Day 1 checklist

Welcome to Aucert. This checklist gets you from zero to a running development environment.

Accounts and access​

  • GitHub account added to aucert organization
  • Google Workspace account (@aucert.ai)
  • Cloudflare Access verified (visit plane.aucert.dev)
  • Azure subscription access (az login works)
  • Plane project access (task tracking)

Development environment​

  • Clone the monorepo: git clone git@github.com:aucert/aucert.git
  • Install tools: Node.js 22+, pnpm 9+, JDK 21, Python 3.12+
  • Run pnpm install from repo root
  • Run setup-dev.sh (if available) or follow dev environment setup

Read the context files​

Start with these (they're small — ~3000 tokens total):

  1. .context/AI_RULES.md — Hard rules and development workflow
  2. .context/ARCHITECTURE.md — 5-layer pipeline overview
  3. .context/CONVENTIONS.md — Coding standards
  4. .context/TECH_STACK.md — Technologies and versions
  5. .context/GLOSSARY.md — Domain terminology

Verify your setup​

  • cd backend/platform && ./gradlew build compiles
  • cd frontend/apps/console && pnpm dev starts
  • kubectl get pods -n internal-platform shows running pods (if cluster access granted)
  • cd docs/public && pnpm build builds the documentation site

What's next​