aurora-development Skill

⛔ PRE-FLIGHT CHECKLIST — MANDATORY BEFORE WRITING ANY CODE

STOP. Complete EVERY step before writing a single line of code.

1. Read the reference files for what you're about to use

⛔ BLOCKING RULE: You MUST use the Read tool to open and read every reference file listed below BEFORE writing or editing ANY code. If you have not called Read on the required reference files, STOP and read them now. The reference files contain CRITICAL patterns (translations, enums, template bindings) that CANNOT be guessed — skipping them guarantees mistakes.

1a. Mandatory references by file type

Match EACH file you plan to edit against this table. Call Read on ALL its references. Do NOT skip any file — each has its own rules.

| Target file pattern | ⛔ Read BEFORE editing | | ------------------------- | -------------------------------------------------------------------------- | | *-list.component.ts | au-grid.md, confirmation-dialog.md | | *-list.component.html | au-grid.md | | *-detail.component.ts | au-form.md, confirmation-dialog.md | | *-detail.component.html | au-form.md | | *.service.ts | graphql-service.md | | *.graphql.ts | graphql-service.md |

1b. Additional references by feature

| Using... | ⛔ Read BEFORE editing | | ------------------------------------------------------------------------------------- | ------------------------------------------------ | | au-grid (columns, actions, row actions, custom actions, actionsMenu, column config) | au-grid.md | | Adding custom actions to au-grid | au-grid.md | | au-grid-select (single/multi) | au-grid-select.md | | Forms (layout, validation) | au-form.md | | Confirmation dialogs | confirmation-dialog.md | | GraphQL service, resolvers | graphql-service.md |

Example: List component with a custom action + delete confirmation → Read au-grid.md + Read confirmation-dialog.md BEFORE any Edit or Write.

2. Enum check — NEVER use raw strings for enum values

Before comparing or assigning ANY enum value:

Open src/app/modules/admin/apps/{bounded-context}/{bounded-context}.types.ts
Search for the enum {BoundedContext}{ModuleName}{FieldName}
If it does NOT exist → CREATE IT with all values from the .aurora.yaml
Import and use the enum constant

// ✅ CORRECT
import { ProductionPlanningProductionOrderHeaderStatusEnum } from '@apps/production-planning';
if (row.status === ProductionPlanningProductionOrderHeaderStatusEnum.PENDING) { ... }

// ❌ WRONG — will be rejected
if (row.status === 'PENDING') { ... }

3. Run Prettier after EVERY file modification

npx prettier --write <file-path>

When to Use

This is the PRIMARY skill for IMPLEMENTING code in Aurora/Angular projects.

Always combine with: prettier, typescript, angular-19, angular-material-19, tailwind-3

Related Skills

| Skill | When to Use Together | | --------------------- | -------------------------------------- | | angular-19 | Angular 19 patterns, signals, inject() | | angular-material-19 | Material components, forms, dialogs | | tailwind-3 | Styling with Tailwind | | typescript | Strict type patterns | | aurora-cli | Regenerate modules after YAML changes | | aurora-schema | Understand entity fields and types | | prettier | Format code after modifications |

Resources

Base Components: src/@aurora/foundations/
Default Imports: src/@aurora/foundations/default-imports.ts
Grid Component: src/@aurora/components/grid/
Example Modules: src/app/modules/admin/apps/iam/, src/app/modules/admin/apps/common/

Agent Skills: aurora-development

Install this agent skill to your local

Skill Files