GitLab merge requests

Tip

You can set up this trigger by hand as this page describes, or ask Promptless in Slack or Microsoft Teams to do it for you. For example, “@Promptless add a GitLab merge request trigger for my acme/backend project.” See Ask Promptless to update your configuration.

Promptless monitors your GitLab projects for merge requests. When a merge request is opened or updated, Promptless analyzes the changes and creates documentation suggestions if needed.

How it works

When a merge request event occurs in your monitored GitLab projects:

1. Automatic Detection: Promptless receives notification of the new or updated merge request.
2. Analysis: The system processes the code diff, MR title, and MR description to understand the context.
3. Relevance Assessment: Promptless determines if the changes require documentation updates.
4. Suggestion Creation: If relevant, Promptless creates documentation suggestions.

Note

Information from merge requests is processed in real-time and not stored by Promptless. The analysis happens only when the configured trigger event occurs.

Configuration

Configure GitLab merge request triggers in your Configuration page using the triggers section:

triggers:
  gitlab-mrs:
    trigger_type: gitlab_mr
    match:
      - repos:
          - acme/backend
          - acme/api
        trigger_on:
          - opened
          - merge
        trigger_directories:
          - src/

See the Configuration Reference for all available options.

Replay recent merge requests

When setting up a new GitLab MR trigger, you can enable “Replay recent MRs” to process merge requests from the last 30 days. This generates an initial batch of suggestions, which helps you:

• Calibrate Promptless with your documentation style before going live
• Catch up on documentation that may have been missed
• Evaluate how Promptless handles your typical MR content

After enabling this option, your Project card shows the replay progress:

• Processing last 30 days of MRs with a spinner while replay is running
• Processed recent MRs with a checkmark once replay completes

Note

Replay runs in the background and doesn’t block normal trigger processing. New MRs opened while replay is running are still processed immediately.

Directory-specific triggers

Use the trigger_directories field to only trigger when changes are made to specific directories. When specified, Promptless considers only merge requests that contain changes to those directories.

Automatic PR creation

When automatic PR creation is enabled in your publishing policies, Promptless automatically creates a new PR in your documentation repository with suggested changes.

Source MR comments

Promptless posts a summary comment on source merge requests linking to any documentation changes. This keeps documentation updates visible alongside the code changes that triggered them.

The comment links directly to the documentation suggestions, so reviewers can see proposed updates while reviewing the code.

Tip

Slack notifications are separate from source MR comments and are always sent according to your project’s notification settings.

Comment mention acknowledgment

When you @mention @promptless in a comment on a merge request, Promptless adds a 👀 reaction to your comment so you know it saw the request. This works for comments on both a source merge request and a merge request Promptless opened for your documentation.

Note

The reaction shows up even when Promptless decides no documentation change is needed, so a missing suggestion doesn’t mean your mention was ignored.

Configuration files and dot-directories

Promptless automatically skips merge requests that only contain changes to dot-directories (like .gitlab/, .gitlab-ci/) or root-level dot-files (like .gitignore, .gitlab-ci.yml). These are typically CI and tooling configuration rather than product changes that need documentation updates.

If an MR contains both dot-files and regular source files, Promptless processes it normally—it only skips when the entire MR is dot-file changes.

Setup instructions

To connect GitLab to Promptless, see the GitLab Integration setup guide.