Skip to main content

First day checklist

Welcome to Aucert. This checklist gets you from zero to a running development environment. Each step has a verification check — click it when you've confirmed it works.

Accounts and access​

1

GitHub organization access

# Verify: you should see aucert repos
gh repo list aucert --limit 3
☐
Verify
You can see aucert/aucert in the repo list
2

Google Workspace account

☐
Verify
You can log in to your @aucert.ai email
3

Cloudflare Access

# Visit this URL — it should load without 403
open https://plane.aucert.dev
☐
Verify
Plane dashboard loads successfully
4

Azure subscription access

az login
az account show --query name -o tsv
☐
Verify
Output shows the Aucert subscription name
5

Plane project access

☐
Verify
You can see project boards at plane.aucert.dev

Development environment​

6

Clone the monorepo

git clone git@github.com:aucert/aucert.git
cd aucert
☐
Verify
You have the aucert directory with .context/ inside
7

Install required tools

# macOS (Homebrew)
brew install node pnpm python@3.12
brew install --cask temurin

# Verify versions
node --version    # 22+
pnpm --version    # 9+
java --version    # 21+
python3 --version # 3.12+
☐
Verify
All four version commands return the correct minimum versions
8

Install dependencies

pnpm install
☐
Verify
Command completes without errors
info

If setup-dev.sh exists in the repo root, run it — it automates steps 7-8. Otherwise, follow dev environment setup for detailed per-platform instructions.

Read the context files​

These five files total ~3000 tokens and give you the full picture of how the project works:

9

Read the L1 context files

# Read them in this order (5 min total):
cat .context/AI_RULES.md      # Hard rules and dev workflow
cat .context/ARCHITECTURE.md   # 5-layer pipeline overview
cat .context/CONVENTIONS.md    # Coding standards per language
cat .context/TECH_STACK.md     # Technologies and versions
cat .context/GLOSSARY.md       # Domain terminology
☐
Verify
You can explain what the 5-layer pipeline does and name all five layers

Verify your setup​

10

Backend compiles

cd backend/platform && ./gradlew build
☐
Verify
BUILD SUCCESSFUL appears in output
11

Frontend starts

cd frontend/apps/console && pnpm dev
# Opens http://localhost:3000
☐
Verify
Browser shows the Aucert dashboard at localhost:3000
12

Cluster access (if granted)

kubectl get pods -n internal-platform
☐
Verify
You see running pods (or get a clear auth error if cluster access is pending)
13

Documentation builds

cd docs/public && pnpm build
☐
Verify
Build completes with no errors

What's next​