pdd-to-app-journeys

Generate archetype-specific user journeys from PDDs for Connect mobile QA testing.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual, error-prone work of creating inconsistent expected user journey sets for Connect mobile app QA, which leads to false-positive and false-negative test results that delay product launches.

Core Features & Use Cases

  • Archetype-Branched Journey Generation: Automatically generates opp-specific user journeys tailored to the PDD's declared archetype (atomic-visit, focus-group, multi-stage) to match the app's actual user flow.
  • Comprehensive Coverage Enforcement: Includes happy paths, error recovery edge cases, negative input paths, and mandatory Learn app smoke tests for two-app opportunities to meet all Phase 6 QA requirements.
  • Use Case: For a new household survey Connect opportunity, this Skill generates the full set of expected user journeys (including eligibility edge cases, duplicate handling, and bad-input recovery paths) that app-test-cases and app-ux-eval use for automated and deep quality assurance.

Quick Start

Use the pdd-to-app-journeys skill to generate the complete expected user journey set for the approved PDD in the current ACE opportunity run.

Frequently Asked Questions about pdd-to-app-journeys

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

FAQPage Schema
How do I generate user journeys for mobile app QA from a product design document?

You can generate user journeys by deriving opp-specific expected paths directly from approved Product Design Documents (PDDs). This process extracts happy paths, error recovery edge cases, and negative input paths to serve as ground truth for automated and deep QA testing.

What user journey categories are required for Connect mobile app QA testing?

Required user journey categories include happy paths, error recovery edge cases, negative input paths, and mandatory Learn app smoke tests for two-app opportunities. These categories enforce strict coverage rules to prevent false-positive and false-negative QA evaluation failures in Phase 6 app testing.

How do app user journeys differ for atomic-visit versus multi-stage archetypes?

App user journeys branch based on the PDD's declared archetype (atomic-visit, focus-group, multi-stage) to generate contextually relevant journey sets. Each archetype enforces specific required categories and measurable pass criteria tailored to match the app's actual user flow.

Can I use a draft PDD to generate expected QA test cases for Connect applications?

No, you need an approved Product Design Document (PDD) to derive expected user journeys. Using an approved PDD ensures the generated journey sets contain reliable ground truth, measurable pass criteria, and deployability-exercising paths required for accurate Phase 6 app testing.

Why do my mobile app QA test results show false positives and false negatives?

False-positive and false-negative QA evaluation failures often result from inconsistent expected user journey sets. Generating archetype-branched journeys with strict coverage rules and measurable pass criteria from approved PDDs eliminates the manual, error-prone work causing these test failures.