aurora-development_skill

Overview

This skill provides expert Angular development guidance and patterns specifically for Aurora projects. It covers building and wiring detail and list components, forms, GraphQL services, action handling, grid configuration, and resolvers. Use it as the authoritative implementation guide when adding or changing Angular code in Aurora modules.

How this skill works

The skill prescribes a strict pre-flight routine: read required reference docs for the target files, follow enum conventions, and format changes with Prettier. It explains which reference files to consult for lists, details, forms, grids, confirmation dialogs, and GraphQL services, and enforces using enums instead of raw strings. It also maps common tasks to the correct patterns and companion skills (Angular, Material, Tailwind, TypeScript).

When to use it

• Implementing or editing any list or detail component in an Aurora module
• Creating or updating forms, including layout and validation
• Adding or editing GraphQL services, queries, or resolvers
• Configuring au-grid columns, actions, row actions, or selection behavior
• Adding confirmation dialogs for destructive actions or custom actions

Best practices

• Always open and read the specific reference docs for the file type before writing code
• Never compare or assign raw string values for enums; import and use the defined enum constants
• Run Prettier (npx prettier --write <file>) after every file change
• Reuse Aurora base components and default imports from foundations to stay consistent
• Combine this skill with Angular, Angular Material, Tailwind, TypeScript, and aurora-cli as needed

Example use cases

• Create a list component with au-grid that includes a custom action and delete confirmation
• Implement a detail component form with validation rules from au-form and a confirmation dialog for destructive edits
• Add a GraphQL service and related .graphql.ts file following graphql-service patterns
• Configure grid column actions, row actions, and actionsMenu while referencing au-grid.md for patterns
• Introduce a resolver that fetches data via the project GraphQL service and wires results into a detail component