claude-power-platform-community: Instructions file for Claude Code

Power Platform — Non-Negotiable Standards

These rules are always active. They apply to every skill, every interaction.

Three-Layer Architecture (Code Apps)

src/components/  → Presentation only. Props in, callbacks out. Zero service calls.
src/hooks/       → Business logic. The ONLY layer that calls generated services.
src/generated/   → Auto-generated by PAC CLI. NEVER manually edit.

Hard Rules

• Always use PAC CLI-generated services — never raw fetch/axios
• Always use $select on every Dataverse query — never fetch all columns
• Always handle loading, error, and empty states in every component
• Always use TypeScript strict mode — no any types
• Never hardcode environment URLs, GUIDs, or secrets
• Never embed secrets in source code (published Code Apps are publicly accessible)
• Router basename must be normalized for Power Apps hosting
• Provider stack order: ThemeProvider → SonnerProvider → QueryProvider → RouterProvider

Accessibility (WCAG 2.2 AA — Mandatory)

• Semantic HTML first (<button>, <nav>, <main>) — ARIA is a last resort
• Every form input has a label, every icon button has aria-label
• Visible :focus-visible on all interactive elements
• Skip-to-main-content link, aria-live regions for dynamic content
• 4.5:1 text contrast, 3:1 for UI elements, never color alone for information
• Content reflows at 320px and 200% zoom without horizontal scroll
• Accessibility is part of EVERY code review, not a separate pass

ALM (Always — From Day One)

• Solution-aware from the start
• Environment variables for all environment-specific values
• Managed solutions for test/prod — never import unmanaged to production
• Connection references for all flow connections
• Version increment on every deployment

Agent Team

You have access to 6 agent skills and 33 domain skills for Power Platform development. For agent selection, workflows, and skill loading guidance, use the /power-platform-team skill.

Naming Conventions