pdd-to-deliver-app-eval

Grade Nova-built CommCare Deliver apps against Product Design Documents for conformance and deployability.

1|2|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/dimagi-internal/ace --skill pdd-to-deliver-app-eval
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdd-to-deliver-app-eval
Source: https://github.com/dimagi-internal/ace/tree/main/skills/pdd-to-deliver-app-eval
Command: npx skills add https://github.com/dimagi-internal/ace --skill pdd-to-deliver-app-eval

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ACE-built Deliver apps often perfectly match a thin PDD's structural skeleton but remain undeployable in production due to missing data validation, unenforced GPS accuracy, absent case property writes on follow-up forms, or missing required language translations. This skill eliminates that gap by grading apps not just on PDD conformance, but on real-world deployability against a CommCare specialist's ship-ready bar, catching silent defects that would cause costly field failures post-handoff.

Core Features & Use Cases

  • Dual-Axis Grading: Evaluates apps on 9 weighted dimensions across two axes: 5 conformance dimensions (45% total weight) checking alignment with the PDD's field count, question order, consent gate semantics, conditional logic, and Connectify wiring, plus 4 fitness dimensions (55% total weight) assessing capture reliability, data quality enforcement, case persistence, and localization compliance.
  • HITL Stub Detection: Automatically detects incomplete human-in-the-loop pending app builds and returns an incomplete verdict instead of generating misleading scores for non-existent app structures.
  • Calibrated Actionable Reporting: Produces a structured YAML verdict and human-readable report with specific Nova edit suggestions to resolve identified gaps, calibrated against known ground-truth build pairs to ensure consistent, reliable scoring.
  • Use Case: For ACE operators building CommCare Deliver apps for Connect public health opportunities, this skill ensures the final app is not just spec-compliant but ready for real-world field deployment, preventing costly rework after handoff to implementation teams.

Quick Start

Invoke the pdd-to-deliver-app-eval skill to evaluate the Nova-built Deliver app for the active Connect opportunity against its PDD specification, producing a structured conformance and fitness verdict with actionable improvement recommendations.

Frequently Asked Questions about pdd-to-deliver-app-eval

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if a CommCare Deliver app conforms to its Product Design Document?

To check CommCare Deliver app conformance against a PDD, grade the app structure on field count, question order, consent gate semantics, and conditional logic. This evaluation identifies alignment gaps between the built forms and the original design specifications.

Why does my CommCare app match the PDD but fail production deployment?

CommCare apps often fail production deployment despite PDD conformance due to missing data validation, unenforced GPS accuracy, or absent case property writes. Fitness grading evaluates capture reliability and data quality enforcement to catch these silent deployability defects.

How do I evaluate CommCare app deployability for Connect public health opportunities?

Evaluate CommCare app deployability for Connect opportunities by grading against a ship-ready bar using dual-axis scoring. This checks PDD conformance alongside real-world fitness dimensions like case persistence, localization compliance, and data quality enforcement.

What is dual-axis grading for Nova-built CommCare apps?

Dual-axis grading for Nova-built CommCare apps evaluates 9 weighted dimensions: 5 conformance dimensions checking PDD alignment and 4 fitness dimensions assessing capture reliability, data quality, case persistence, and localization compliance to ensure field readiness.

How are incomplete human-in-the-loop CommCare app builds detected during evaluation?

Incomplete human-in-the-loop CommCare app builds are detected by checking for pending app structures. The evaluation returns an incomplete verdict instead of generating misleading scores for non-existent app components.