Cxas Cuj Report Generator

Critical User Journey (CUJ) Transcript & Report Generator Skill

Use this skill when asked to extract dialogue transcripts or compile interactive Critical User Journey (CUJ) reports from a directory of customer requirement documents (such as diagrams, BRDs, code etc.).

Core Protocols

To ensure 100% coverage and zero data loss, you MUST follow these core rules:

• Robust Extraction: Follow the protocol defined in the cxas-protocol-robust-extraction skill.
• Two-Phase Ingestion: Follow the protocol defined in the cxas-protocol-two-phase-ingestion sub-protocol inside protocols/cxas-protocol-two-phase-ingestion/.
• Checklist Mandate: The orchestrator and all subagents MUST follow the agent-protocol-checklist protocol to maintain a local task_checklist.json file, ensuring they track their progress and not lose coverage during execution.
• Orchestrator Delivery Assurance: The orchestrator MUST act as a strict, independent Delivery Auditor. BEFORE closing subagents, terminating the watchdog, or reporting campaign success to the user, the orchestrator MUST physically verify the existence, size bounds, and schema compliance of all registered deliverables (specifically gecx_customer_report.html and gecx_cuj_report.html) on disk. Under no circumstances may the orchestrator assume completion without executing a physical file-presence check.
• Auditing: The orchestrator MUST periodically check the subagent's scratch directory to ensure the task_checklist.json file is being created and maintained. If the file is missing or not updated, the orchestrator MUST terminate the subagent and respawn it with stronger enforcement instructions.

Core Workflow Steps

Follow this 5-step structured workflow to execute the task:

1. Scoping & Type Discovery: Prepare the environment and identify required skills.

   • Access Files: Ensure you have access to the source artifacts in your local workspace.

     • Tip (Drive Links): If the source is a Google Drive link or folder ID, you MUST use the gdrive skill to access them.

   • Detect Inventory Types: To identify framework signatures and map them to correct Ingestors, you MUST use the framework detector agent defined in agents/framework_detector.md. Using this agent, scan the input files to inventory all file extensions and detect potential frameworks. Spawn parallel Framework Detector subagents to scan partitions of the file tree.

   • Map Ingestors: Use the scoping report generated by the Framework Detector to select or create the correct specialized skills in ingestors/frameworks/ or ingestors/files/.

     • Precedence Rule: Framework-specific ingestors take precedence over generic file-extension ingestors (e.g., use ingestors/frameworks/adk/ instead of ingestors/files/py/ if both apply).

2. Discovery: Spawn specialized expert subagents based on the discovered types to identify sub-intents (see the agents/ directory for role definitions). Dynamically discover and use specialized ingestor skills in ingestors/frameworks/ and ingestors/files/.

   • Mandatory Handoff: Subagents MUST report back:

     1. Frameworks detected,
     2. File types parsed, and
     3. Any files/patterns skipped as out-of-scope.

   • Exhaustive Use: Use all relevant ingestors by applying the most specific one applicable to each file.

   • Fallback: If no specialized ingestor exists for an out-of-scope file type, the orchestrator MUST delegate the analysis:

     1. Spawn Analyzer: Spawn a specialized Analysis Subagent to inspect a sample of the unknown file.
     2. Research: Instruct the subagent to search online or in internal documentation for format standards if the structure is not clear.
     3. Report & Codify: The subagent must report the best parsing strategy back to the orchestrator and SHOULD attempt to create a new specialized skill in ingestors/frameworks/ or ingestors/files/ to capture this knowledge.

3. Exhaustion: Loop until no new intents are found.

4. Clustering: Group into Parent CUJs. To ensure consistent and accurate category discovery:

   • Noise Reduction: Do NOT pass full objects with raw transcripts or code.
   • Summary Format: Provide a clean YAML list with id, name (stripped of technical tags), and a 1-sentence synthesized intent.
   • Guidance: Instruct the agent that a reasonable number of categories is typically between 5 and 10.

5. Execution: Generate transcripts and reports using the tools in this directory.

   • Mandatory: Limit batch sizes to 5-10 items per subagent to prevent LLM context exhaustion and truncation.
   • Title Synthesis: For each transcript, the agent MUST synthesize a short, human-readable scenario title based on the dialogue content and the title of the CUJ and store it in the subintent_name field, rather than using raw technical IDs.
   • Immediate ID Verification: Always assume that sensitive numbers like Account Number or Order ID are checked in a backend system immediately after being provided by the user, and insert a webhook_call or tool_call accordingly.
   • Agent-First Transcripts: Every single transcript MUST start with a standard welcome greeting: "Hello! Thanks for calling [Brand]. How can I help you today?" (or a generic welcoming if no brand is specified, e.g. "Hello! Thanks for calling. How can I help you today?") with absolutely no exceptions or alternative phrasing, even if raw requirements suggest another name.
   • Voice Realism (No Spoken URLs): Agents on the voice channel cannot speak long URLs. You MUST NEVER write raw URLs (e.g., https://...) in Agent turns. Instead, the Agent must verbally state they are texting or emailing the link (e.g., "I've texted that tracking link to your phone").
   • Standardized End Session: Every conversation MUST close with a structured 3-turn sign-off sequence:
     1. Agent: "Is there anything else I can help you with today?"
     2. User: "No, that's all. Thank you."
     3. Agent: "Thank you for calling [Brand]! Goodbye." (or equivalent brand sign-off, e.g., "Thank you for calling Customer Support! Goodbye.", or "Thank you for calling! Goodbye." if no brand is specified) with absolutely no alternative phrasing allowed. The final Agent turn MUST trigger the end_session system tool call. Do NOT omit this tool call under any circumstances. It must match this CXAS schema: yaml tool_call: name: end_session payload: session_escalated: false reason: "Conversation completed successfully" response: result: "success"
   • Dual Reports: The agent MUST generate both a CUJ report (limiting examples to at most 3) AND a comprehensive full report (including all examples).
   • Usage: Run construct_report.py with --cuj_report=True to generate the CUJ report, and with --cuj_report=False to generate the comprehensive full report.