Axiom Refract + Slack

Receive architectural scan notifications and alerts directly in your Slack channels

How It Works

1

Create Slack App or Webhook

Create an incoming webhook in your Slack workspace by setting up a Slack app with incoming webhook permissions, or use an existing Slack app.

2

Configure Webhook in Axiom

Add the Slack webhook URL in the Axiom dashboard settings under Integrations > Notifications > Slack.

3

Select Notification Channels

Choose which Slack channels receive notifications for different event types — scan completions, new SPOF detections, compliance changes, and threshold alerts.

4

Set Alert Thresholds

Configure which findings trigger Slack notifications. Set thresholds for SPOF count changes, blast radius increases, and compliance status changes.

What You Can Do

Scan Completion Notifications

Receive a summary notification in Slack when a scan completes — including SPOF count, dead code volume, and overall risk assessment in a formatted message.

Regression Alerts

Get alerted when a scan detects architectural regression — new SPOFs introduced, coupling increased, or dead code accumulated beyond threshold.

Compliance Status Changes

Receive notifications when compliance mapping status changes — new gaps detected, previously met controls now failing, or improvements in compliance posture.

Scheduled Digest

Receive a weekly or monthly architectural health digest summarizing trends, top risks, and recommended actions for the engineering team.

Setup

Create an incoming webhook in your Slack workspace (api.slack.com/messaging/webhooks). Copy the webhook URL. In the Axiom dashboard, navigate to Settings > Integrations > Slack and paste the webhook URL. Select which event types should send notifications and configure the target channel. Test the integration by triggering a scan.

# Send an Axiom scan summary to Slack via webhook
curl -X POST https://hooks.slack.com/services/YOUR/WEBHOOK/URL \
  -H "Content-Type: application/json" \
  -d '{
    "blocks": [
      {
        "type": "header",
        "text": {
          "type": "plain_text",
          "text": "Axiom Refract Scan Complete"
        }
      },
      {
        "type": "section",
        "fields": [
          { "type": "mrkdwn", "text": "*SPOFs:* 7 detected" },
          { "type": "mrkdwn", "text": "*Dead Code:* 3,200 LOC" },
          { "type": "mrkdwn", "text": "*Risk Level:* Medium" },
          { "type": "mrkdwn", "text": "*Compliance:* 8/9 frameworks met" }
        ]
      }
    ]
  }'

Why This Matters

Engineering teams live in Slack. Sending architectural scan results, regression alerts, and compliance notifications to Slack channels ensures that structural risk information reaches the team where they already communicate — without requiring them to check a separate dashboard.

Read the Docs →