PrimeCompass Documentation

PrimeCompass is an intelligent application testing and monitoring platform that continuously understands how your application behaves, tracks changes over time, and gives teams early, objective insight into risk and release readiness.

The platform automatically maps your entire application, discovers user journeys, creates test scenarios, detects changes between releases, and provides AI-powered insights — all without manual test scripting.

How It Works

The Dashboard is your central hub for managing all applications. Each application card displays its current status, key metrics, and quick actions.

Application Status

• New — Application registered but no discovery has been run yet.
• Discovered — At least one discovery run has completed.
• Baselined — A baseline has been created, ready for comparison.

Metrics at a Glance

Each application card shows the number of discoveries, baselines, scenarios, and personas — giving you an instant picture of coverage and activity.

Discovery is PrimeCompass's core capability. It runs an intelligent, AI-guided crawler that explores your application, identifies pages, forms, interactions, and workflows, then generates executable test scenarios automatically.

Setting Up a Discovery

Discovery Results

After a discovery completes, the Overview page provides a comprehensive breakdown:

• All discovered pages with types (Form, List, Detail, Navigation, etc.)
• Scenarios grouped by business module
• Step-by-step actions with pre/post screenshots
• Entity data created or modified during exploration
• AI-generated insights and suggested follow-up actions

A Baseline is a snapshot of your application's expected behaviour — the set of scenarios, workflows, and structures that represent the "known good" state.

Creating a Baseline

Create a new baseline with a name and description, then populate it by importing scenarios from discovery runs, recordings, the composer, or external files.

Baseline Detail

Drift detection compares your baseline (expected state) against a new discovery run to identify what has changed between releases.

How Comparison Works

Select a baseline and a discovery run, then start the comparison. PrimeCompass uses a multi-pass matching engine to align scenarios and identify differences.

Comparison Results

AI-Generated Insights

The comparison overview includes AI-powered insight cards that highlight the most impactful changes, risk areas, and recommended actions — with links to drill down into details.

The Recorder captures your manual interactions with your application and converts them into executable test scenarios. Use it when you want to capture specific workflows that automated discovery may not reach.

Recording a Workflow

1. Enter your application URL and select the environment.
2. Optionally assign a persona for the recording session.
3. Click Start Recording — PrimeCompass opens your application in a browser.
4. Interact with your application naturally. Every click, form fill, navigation, and selection is captured automatically.
5. Stop the recording when your workflow is complete.

Recording Output

Each recording generates a timeline of actions with screenshots. You can export recordings in multiple formats: human-readable scenarios, Playwright scripts, or BDD feature files.

The Composer is a visual tool for designing complex test workflows by arranging scenarios into parallel lanes.

Building a Composition

CompAssist is PrimeCompass's built-in AI assistant, available from any page via the chat panel on the right side of the screen.

Capabilities

• Ask natural-language questions about your discoveries, baselines, and comparisons
• Generate charts and visualizations on demand
• Get summaries and risk assessments for discovery runs
• Export answers as Excel, CSV, or PDF reports
• Context-aware prompts that adapt to the page you're on

Example Prompts

PrimeCompass automatically generates multiple test artifact formats from discovered scenarios, ready for integration into your CI/CD pipeline.

Generated Formats

CI/CD Integration

Download generated scripts as a ZIP archive and commit them to your repository. Run them with any standard test runner — Playwright Test, Jest, GitHub Actions, GitLab CI, Jenkins, or Azure Pipelines.

Personas represent different user roles that interact with your application. PrimeCompass uses personas to discover role-specific workflows and validate access controls.

Multi-Persona Discovery

• Log in as each persona separately and map their unique views
• Identify pages and features accessible to one role but not another
• Discover approval workflows, admin-only functions, and permission boundaries
• Generate per-persona scenario sets for targeted regression testing

Role Comparison

Compare what different personas can see and do. Identify access gaps, shared workflows, and role-specific scenarios to ensure your permission model works as intended.

Import Sources

• Discovery runs — Import all or selected scenarios with preview
• Recordings — Convert manual recordings into baseline scenarios
• Composed workflows — Import saved compositions
• External files — CSV, Excel, JSON, BDD feature files, or Playwright scripts

Long-running imports are processed in the background with progress tracking, notifications on completion, and the ability to reimport from any source.

Export Options

• Download all test scripts as a ZIP archive
• Export comparison reports as CSV or Excel
• Export scenarios by module, persona, or format
• Export system configuration as JSON for backup or team sharing

Configure PrimeCompass to match your team's workflow and infrastructure.

Configuration Categories

Search any setting by keyword, export your configuration as JSON, or reset individual settings to their defaults.