authgear/authgear-server

update-portal-ui

Guidelines for updating or designing pages in the portal React frontend (portal/src). Covers component conventions, link rendering rules, i18n patterns, and common pitfalls.

review-pr

Produce a structured code review report for the current branch's PR (purpose, API interface changes, code quality, bugs, security, performance), with a mandatory second verification pass. Use when the user asks "what does this PR do", "review this branch/PR",…

update-feature-config

Add or change a feature config field/section in pkg/lib/config (authgear.features.yaml). Use when adding a new feature config field, adding a new top-level section, or touching an existing section's Merge implementation.

update-deps

Audit and fix dependency vulnerabilities in Go and Node.js packages. Runs govulncheck for Go and npm audit for each package.json directory. Commits fixes directory by directory.

bootstrap-local-dev

Set up a fresh authgear-server development environment from scratch. Use when onboarding a new contributor, setting up a new machine, or when the user says "set up local dev from scratch" / "first-time setup". Covers the asdf + Homebrew install path on macOS;…

update-email-templates

Update Authgear email templates using the correct source files, translation files, and commit order. Use when editing email wording, email structure, or subject lines.

add-go-test

Write or extend Go unit tests in this repo. Use when the user asks to add or update Go tests.

write-implementation-plan

Draft or update detailed implementation plans for authgear-server specs, design changes, and docs/plans files. Use when Codex needs to turn a spec or outdated plan into a concrete implementation plan with exact files, exact methods, runtime call flow,…

write-e2e-test

Write end-to-end (e2e) tests for authgear-server. Use when the user asks to write, add, or create e2e tests. The tests live in e2e/tests/ and are YAML-driven.

new-siteadmin-api

Full pipeline for adding a new Site Admin API feature — from OpenAPI spec through implementation plan to working service. Use when adding a new endpoint or filling in real data for an existing stub.

add-portal-admin-api-mutation

Add a Portal Admin GraphQL mutation under portal/src/graphql/adminapi/mutations.

add-portal-admin-api-query

Add a Portal Admin GraphQL query under portal/src/graphql/adminapi/query.

api-design

Review or design APIs for Authgear. In review mode, evaluates a design draft against the checklist. In ideation mode, develops a design from a description and self-reviews it.

portal-admin-api-graphql

Deprecated alias for add-portal-admin-api-query and add-portal-admin-api-mutation.

update-go-version

Update the Go toolchain version across the repo.

update-important-modules

Refresh the repo's important Go modules when the dependency set drifts.

update-vettedpositions

Update .vettedpositions after harmless line-number moves in goanalysis output.

generate-schemas-and-gentype

Use when updating GraphQL schema or generated frontend types in authgear-server. Always regenerate checked-in schema/type artifacts with make export-schemas and portal npm run gentype instead of editing generated files by hand.

add-portal-screen

Add screens or components to the portal frontend. Use when the user asks to create a new portal page, screen, tab, or UI component.