Data

Tools

Indexes

Applications

Experiments

Open Source Science

experience-notation

Experience Notation (.expn) is a human-readable DSL for modelling structured user journeys. It bridges qualitative design with simulation and LLM-driven analysis.

https://github.com/context-notation/experience-notation

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ✓
    CITATION.cff file
    Found CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ○
    Committers with academic emails
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (11.7%) to scientific vocabulary

Keywords

ai-workflows behavioural-simulation customer-experience cx-automation domain-specific-language dsl ebnf experience-notation journey-mapping json-schema llm-integration persona-modelling structured-data user-journey ux-design
Last synced: 6 months ago · JSON representation ·

Repository

Experience Notation (.expn) is a human-readable DSL for modelling structured user journeys. It bridges qualitative design with simulation and LLM-driven analysis.

Basic Info
Statistics
  • Stars: 0
  • Watchers: 0
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Topics
ai-workflows behavioural-simulation customer-experience cx-automation domain-specific-language dsl ebnf experience-notation journey-mapping json-schema llm-integration persona-modelling structured-data user-journey ux-design
Created 7 months ago · Last pushed 7 months ago
Metadata Files
Readme Contributing License Citation

README.md

Experience Notation (.expn)

Open DSL Grammar EBNF Apache 2.0 Pygments Lexer

Experience Notation is a structured language for modelling user journeys, decisions, personas, and interactions in a readable and simulation-ready format. It is designed for LLM prompting, human authoring, and machine parsing. Originally developed as part of the Demoscope.ai platform — a commercial service for synthetic user feedback — it is now available as an open-source specification.

Key Concepts

Experience Notation is:

  • Readable — Uses indentation and labels to keep files accessible.
  • Structured — Validates via both EBNF and JSON Schema.
  • Expressive — Captures emotional context, UI interaction, branching.
  • Modular — Supports external references and journey composition.
  • LLM-compatible — Can be generated, simulated, and adapted through prompts.

Explore the full Glossary for key terms.

Example

expn Journey: simple-onboarding Title: Simple Onboarding Journey Personas: Persona A: New User Traits: { tech_savvy=false } Experience: Curious and slightly anxious Events: Event 1: App Launch Step 1: User: Persona A Action: Opens the mobile app UI-Element: Splash screen Tag: entry Event 2: Sign-Up Step 1: User: Persona A Action: Enters email and password UI-Element: Registration form Step 2: User: Persona A Action: Taps "Create Account" UI-Element: Call-to-action button Tag: confirmation

Learn More

In Use

Experience Notation powers Demoscope.ai, a commercial platform for synthetic user feedback and behavioural simulation. .expn files are used to structure multi-step journeys and guide persona interactions in production environments.

Grammar & Schema

You can validate .expn files using:

  • $schema field in supported editors
  • ajv-cli for JSON structure validation
  • Experimental tools (see roadmap)

Roadmap

  • [ ] Bidirectional JSON ↔ .expn parser
  • [ ] EBNF validation and linting tool
  • [ ] Web-based editor / playground
  • [ ] SDKs and developer tools

Licence

The Experience Notation DSL and its accompanying JSON Schema are released under the Apache 2.0 Licence.

See the LICENSE file for the full text.

Support & Collaboration

Experience Notation was authored by Nikolaos Maniatis and is maintained by The Cato Bot Company Limited as part of the Context Notation initiative.

For questions about: - Using Experience Notation in your projects - Contributing to development - Research collaborations
- Commercial support options

Feel free to reach out:

📧 hello@context-notation.com
💬 GitHub Discussions
🌐 context-notation.com

Citation

If you use Experience Notation in academic work, please cite:

Nikolaos Maniatis. Experience Notation Schema (v1.1). https://schemas.experience-notation.com/experience-notation.schema@v1.1 Available at: https://github.com/context-notation/experience-notation Licensed under Apache 2.0. Maintained by The Cato Bot Company Limited.

APA:

Maniatis, N. (2025). Experience Notation Schema (v1.1). https://github.com/context-notation/experience-notation

Owner

  • Name: Context Notation
  • Login: context-notation
  • Kind: organization
  • Location: United Kingdom

Citation (CITATION.cff) 

cff-version: 1.2.0
message: "If you use Experience Notation in your research, please cite the following:"
title: "Experience Notation"
version: "1.1.0"
date-released: 2025-07-27
authors:
  - family-names: Maniatis
    given-names: Nikolaos
    affiliation: The Cato Bot Company Limited
license: Apache-2.0
url: https://github.com/context-notation/experience-notation
repository-code: https://github.com/context-notation/experience-notation

GitHub Events

Total
  • Push event: 1
Last Year
  • Push event: 1

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 13
  • Total Committers: 1
  • Avg Commits per committer: 13.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 13
  • Committers: 1
  • Avg Commits per committer: 13.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Nikolaos Maniatis m****s@i****e 13
Committer Domains (Top 20 + Academic)
iamcatobot.me: 1

Issues and Pull Requests

Last synced: 7 months ago