Skip to content

Add agent instructions and form-porting guide#72

Open
nllong wants to merge 1 commit into
mainfrom
docs-porting-forms-guide
Open

Add agent instructions and form-porting guide#72
nllong wants to merge 1 commit into
mainfrom
docs-porting-forms-guide

Conversation

@nllong

@nllong nllong commented Jul 16, 2026

Copy link
Copy Markdown
Member

Summary

Adds a consistent starting point for the many agents porting legacy AngularJS screens/forms into this Angular app, to reduce churn and rediscovery.

  • .github/copilot-instructions.md — auto-loaded by Copilot CLI / coding agents. A short router that points to DEVELOPER.md and the porting guide, names canonical example components, and lists the non-negotiables: standalone components + MaterialImports, reactive forms, the @seed/api service pattern, SnackBarService / ErrorService, Transloco, routing/nav wiring, and the pnpm lint + pnpm build gate.
  • docs/porting-forms.md — the detailed recipe: fetching the legacy source, a canonical-examples table, the reusable integration points (which service exposes cycles/columns/access levels/profiles), full-page and modal component skeletons, the validation + save flow, routing/navigation, the Transloco + Lokalise workflow (Lokalise is the source of truth; update-translations only pulls), a definition of done with the common lint gotchas, and a copy-into-PR checklist.

Docs-only; no code or build impact. Split out from the Create Inventory form PR (#71), which serves as the golden full-page-form example referenced by the guide.

Add a starting point for agents porting legacy AngularJS screens into
this app, to keep output consistent and reduce churn:

- .github/copilot-instructions.md: auto-loaded router pointing to
  DEVELOPER.md and the porting guide, listing canonical examples and
  non-negotiables (standalone + MaterialImports, reactive forms, @seed
  service pattern, SnackBar/Error services, Transloco, routing/nav, and
  the pnpm lint + build gate).
- docs/porting-forms.md: step-by-step recipe (legacy fetch, canonical
  examples, reusable integration points, component/modal skeletons,
  validation + save flow, routing/nav, Transloco + Lokalise workflow,
  definition of done, and a PR checklist).

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant