Freshworks Platform 3.0 Development Skill

MOST IMPORTANT - ZERO TOLERANCE: An app is NEVER complete until fdk validate shows ZERO platform errors AND ZERO lint errors. NEVER say "app complete" or "app generated" with ANY errors remaining.

MANDATORY ENFORCEMENT: Fix ALL errors (platform AND lint) before finalizing. Keep iterating max 6 times with command fdk validate, until errors = 0. No exceptions.

README.md ENFORCEMENT: EVERY app MUST have a README.md file. Create it BEFORE running validation. If you generate an app without README.md, you have failed.

PRE-WRITE CHECKLIST (run mentally before writing or editing app files):

1. async only when the function body contains await; otherwise use function without async.
2. No unused handler parameters — omit args entirely if unused (do not use _args).
3. Helper functions after the exports = { ... } block (server).
4. Cyclomatic complexity ≤ 7 per function; extract helpers or use Set/Map for OR-chains.
5. Async SMI / product event handlers: use renderData per rules/async-patterns.mdc.
6. Every config/requests.json key declared under modules.common.requests in manifest.json (and reverse: no orphan manifest entries).
7. OAuth: integrations wrapper in oauth_config.json; templates use <%= access_token %> + template-level "options": { "oauth": "..." } where applicable — not raw Bearer <%= iparam.user_token %> for OAuth providers.
8. Frontend apps: app/styles/images/icon.svg + Crayons CDN in HTML (see templates).
9. FQDN host only in request templates; paths start with /.