What application certification means
Application certification confirms the app passed defined security, code, and design checks at the time of review. Those checks match the security, data, and UX standards that builders are trained against in builder certification.What it does not mean
- Certification does not verify that the app is fit for the customer’s specific purpose.
- Certification does not mean the app is bug-free.
When you need it
- Active builder certification (valid, not expired).
- Enterprise license to Cursor, Claude Code, or another agentic coding tool (required to run the certification skills).
- A Flows custom app created with
npx @cognite/cli@latest apps create.
How the certification flow works
Capture the App Brief
/flows-app-brief immediately after creating the app, before you start building.The skill acts as a certification coach: it pre-scans app.json and any spec files for context, then asks targeted questions about your user, the problem the app solves, the one-sentence value statement, and how you’ll measure success. It writes App-Brief.md at the repo root.App-Brief.md is the user-context document reviewers read first. The final submit skill blocks submission until every required field is populated.Build the app
npx @cognite/cli@latest apps skills pull) so AI coding agents stay aligned with current Cognite best practices.Run the code review
/flows-code-review to perform the technical review.The skill produces three artifacts under reviews/code-review/feedback-round-N/:code-review-report.md— scored report covering correctness, SDK usage, dependencies, test coverage, dead code, patterns, Data Modeling Service (DMS) query efficiency, pagination, rate limiting, and Aura usage.review-files.md— per-file inventory.review-packages.md— dependency audit includingnpm auditresults.
Summary block reports a Must Fix open: count. Re-run the skill (it creates a new feedback-round-N) until the count is 0.Run the design review
/flows-design-review to score the app against the 10 design quality questions.The skill is semi-automated: for each question it runs concrete repo probes (grep, lint, build) and proposes a draft 1–5 score. You confirm or override each score after walking your tasks end-to-end in the running app. It writes design-review-report.md under reviews/design-review/feedback-round-N/.Target overall average: 3.8 or higher.Verify and submit
npx @cognite/cli@latest apps deploy— builds the app automatically (npm run build) and uploads it, creating the deploy bundle at.cognite-bundles/<externalId>-<versionTag>.zipnpx @cognite/cli@latest apps sign— signs the bundle and writes.dev.sig
/flows-external-app-submit. The skill verifies five gates before packaging anything:npx @cognite/cli@latest apps submit, which collects the source archive (src-<sha>.zip) and the deploy bundle into dist/certification/, then prompts you to add your screen recording to that folder before opening the pre-filled Zendesk form.Submit through Cognite Zendesk
dist/certification/ (the CLI prompts you to do this), then attach all files from that folder:src-<sha>.zip— source archive (committed code only;design-review-report.mdis included inside)<externalId>-<versionTag>.zip— deploy bundle; required for signature verification- Screen recording of the application walking through the primary tasks (required for the design review)
Respond to the review outcome
- Feedback: Address reviewer comments, re-run the relevant skills, commit the updated artifacts, and reply in the same Zendesk ticket with a fresh
dist/certification/folder (newsrc-<sha>.zip, deploy bundle, and updated screen recording if the UI changed). - Approval: Download the
.cert.sigfrom the Yopass link in the ticket. Place it alongside your.dev.sigfile, runnpx @cognite/cli@latest apps publish, thennpx @cognite/cli@latest apps activate.
App tiers
The App Brief asks you to pick a tier so reviewers can calibrate expectations. Pick the closest match; “not sure” is fine, and the reviewer can adjust.Submission requirements
Self-check before submitting
Run this checklist immediately before you open the Zendesk ticket:- The app is targeting a production project without Dev status (skip certification for Dev status projects).
-
App-Brief.mdexists at the repo root and every required field is populated. - The latest
reviews/code-review/feedback-round-N/code-review-report.mdreportsMust Fix open: 0. - The latest
reviews/design-review/feedback-round-N/design-review-report.mdreportsAverage score:of 3.8 or higher. - All skill-generated artifacts (
App-Brief.mdand the latestreviews/reports) are committed to git (git add+git commit); the submit skill packages only committed files. -
npx @cognite/cli@latest apps deployhas been run; deploy bundle exists at.cognite-bundles/. -
npx @cognite/cli@latest apps signhas been run;.dev.sigexists. -
/flows-external-app-submitran and printed PASS for every gate. - Screen recording of the app’s primary tasks has been placed in
dist/certification/. - All files in
dist/certification/(src-<sha>.zip, deploy bundle, screen recording) are ready to attach.
Troubleshooting common issues
/flows-external-app-submit keeps blocking on Must Fix items
/flows-external-app-submit keeps blocking on Must Fix items
reviews/code-review/feedback-round-N/code-review-report.md and work the Must Fix section top to bottom. Re-run /flows-code-review after each batch of fixes; it creates a new feedback round so reviewers can see your progression. Submission stays blocked until the most recent round reports Must Fix open: 0.My design average is below 3.8 but my app feels fine
My design average is below 3.8 but my app feels fine
/flows-design-review in a new feedback round, override the scores you disagree with, and add an Improvement note explaining the reasoning so reviewers can follow your thinking.What counts as a production project?
What counts as a production project?
production (or similar) in the name. If you’re unsure, ask the project’s CDF administrator. When in doubt, certify, or request Dev status for non-production projects.Can I submit without a screen recording?
Can I submit without a screen recording?
The app changed after it passed. Do I need to recertify?
The app changed after it passed. Do I need to recertify?
Even for a one-line bug fix?
Even for a one-line bug fix?
Reviewers asked for changes. How do I resubmit?
Reviewers asked for changes. How do I resubmit?
/flows-code-review and /flows-design-review (each in a new feedback round), then re-run /flows-external-app-submit to produce a fresh zip. Open a new Zendesk ticket and note in the description that this is a re-certification, referencing the original ticket number.Further reading
- Builder certification — Qualify to build Flows custom apps in customer environments before you certify an app version for production.
- Dev status — Skip application certification on non-production projects.
- Quality guidelines — The 10 design quality questions the design review skill scores against.
- Skills — How skills are delivered and refreshed in your app.
- Get started with Flows — Scaffold a new app.