← Change Slack app choice

Selected path Existing Slack app

Set up Scrum Master with an existing Slack app.

Complete the Slack app, agent settings, access rules, integrations, and final checks below.

01
SLACK API // YOUR APPS

Select the existing app.

Open Slack apps ↗
  1. 01.1

    Open Slack API → Your Apps.

    Sign in at api.slack.com/apps ↗.

  2. 01.2

    Select the app and workspace.

    Open the app that should run Scrum Master. Confirm the workspace before changing its manifest.

02
SLACK APP // APP MANIFEST

Apply the recipe manifest.

The name and description are already set for Scrum Master.

  1. 02.1

    Open Features → App Manifest.

    Choose App Manifest and select the JSON tab.

  2. 02.2

    Back up the current manifest.

    Copy the existing JSON to a secure working document before changing it so workspace-specific settings can be preserved or restored.

  3. 02.3

    Replace or merge the configuration.

    Copy the manifest below. Merge it when the existing app has settings your team still needs.

  4. 02.4

    Save the manifest.

    Review Slack's change summary, then click Save Changes.

JSON MANIFEST
{
  "display_information": {
    "name": "AgentBarn_Scrum_Master",
    "description": "Runs sprint ceremonies, tracks blockers, and keeps the team on cadence in Slack.",
    "background_color": "#CC4400"
  },
  "features": {
    "app_home": {
      "home_tab_enabled": false,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "bot_user": {
      "display_name": "AgentBarn_Scrum_Master",
      "always_online": true
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "canvases:read",
        "canvases:write",
        "channels:history",
        "channels:join",
        "channels:read",
        "chat:write",
        "chat:write.customize",
        "chat:write.public",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "search:read.users",
        "users:read",
        "users:read.email"
      ]
    },
    "pkce_enabled": false
  },
  "settings": {
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true
    },
    "org_deploy_enabled": false,
    "socket_mode_enabled": true,
    "token_rotation_enabled": false,
    "is_mcp_enabled": false
  }
}
03
SLACK APP // SOCKET MODE

Create the app-level token.

  1. 03.1

    Open Basic Information → App-Level Tokens.

    Click Generate Token and Scopes.

    Slack App-Level Tokens area focused on Generate Token and Scopes
    Generate Token and Scopes.
  2. 03.2

    Name the token and add the scope.

    Use AgentBarn_Scrum_Master, add connections:write, and click Generate.

    Slack app-level token dialog with the connections write scope
    Name → connections:write → Generate.
  3. 03.3

    Copy the xapp- value.

    Keep it ready for the Agent Barn App-level token field.

    Slack app-level token with the value blurred and Copy button visible
    The value is blurred; use Copy.
04
SLACK APP // WORKSPACE INSTALL

Install the app and copy the bot token.

  1. 04.1

    Open Install App.

    Click Install to [your workspace].

    Slack Install App page with Install to workspace
    Install App → Install to workspace.
  2. 04.2

    Review the workspace and permissions.

    Confirm the workspace, review the requested access, and choose Allow.

    Slack app permission review with workspace selection and Allow button
    Confirm workspace → review access → Allow.
  3. 04.3

    Copy the Bot User OAuth Token.

    In Installed App Settings → OAuth Tokens, copy the xoxb- value.

    Slack OAuth Tokens section with the token blurred and Copy button visible
    Bot User OAuth Token → Copy.
05
AGENT BARN // SLACK CREDENTIALS

Connect both Slack values.

APP-LEVEL TOKENxapp-…

Paste the value from App-Level Tokens.

BOT TOKENxoxb-…

Paste the Bot User OAuth Token.

  1. 05.1

    Enter the values in their matching fields.

    Paste the complete xapp- and xoxb- values, then save.

  2. 05.2

    Confirm the connected app.

    Check that Agent Barn resolves the expected Slack app and workspace.

06
AGENT BARN // SETTINGS

Configure the agent.

  1. 06.1

    Name the agent.

    Use AgentBarn_Scrum_Master, or another role-specific name your team will recognize.

  2. 06.2

    Select and test the model.

    Choose an available model, then run one representative Scrum Master task before connecting broader access.

  3. 06.3

    Choose command approval.

    Command approval options: Auto, Manual, and Off
    Auto · Manual · Off
    Auto

    Runs low-risk commands automatically.

    Manual

    Asks before every command.

    Off

    Runs without approval prompts.

  4. 06.4

    Choose response detail.

    Response detail options: Verbose and Concise
    Verbose · Concise
    Verbose

    Shows progress while working.

    Concise

    Returns the result without step narration.

  5. 06.5

    Configure the recipe trigger and workflow.

    Trigger: A scheduled ceremony, configured work-item change, or stand-up window.

    1. Collect updates. Ask for stand-up updates or read configured project activity.

    2. Track blockers. Identify pending work and blockers from the available context.

    3. Prepare summary. Create a concise update for the team’s agreed cadence.

    4. Keep moving. Post reminders and the sprint summary in Slack.

  6. 06.6

    Apply the recipe requirements and review rule.

    Template

    Ceremony cadence, question format, and summary structure.

    Skills

    Jira access for the relevant project or sprint information.

    Policies

    The Slack channels and direct-message rules for the team.

07
SLACK // ACCESS

Set Slack access rules.

  1. 07.1

    Choose channel access.

    Channel access options: Allowlist and Open
    Allowlist · Open
    Allowlist

    Respond only in channels you add.

    Open

    Respond in any channel the app can reach.

  2. 07.2

    Choose direct-message access.

    Direct-message options: Off, Allowlist, and Open
    Off · Allowlist · Open
    Off

    Ignore direct messages.

    Allowlist

    Reply only to approved people.

    Open

    Reply to anyone who can reach the app.

  3. 07.3

    Add and test the intended destinations.

    Invite the Slack app to each allowed channel, add the same channels or people in Agent Barn, and send one test request.

08
AGENT BARN // INTEGRATIONS

Connect the skills for Scrum Master.

REQUIRED

Jira

Read sprint, issue, assignee, status, and blocker information for the configured team.

Credential
An Atlassian account email, site URL, and scoped or non-scoped API token.
Permissions
Projects and boards: read · Issues and sprint state: read · Comments or updates: omit unless the team explicitly enables them
  1. Select the board, project, and active sprint sources.
  2. Keep write actions disabled for the initial coordination pilot.
  3. Validate summaries against the board before automating reminders.
  1. 08.1

    Select only this recipe’s integrations.

    Keep required skills. Where a card says “choose one,” connect the provider that owns the relevant data.

  2. 08.A1

    Atlassian // Copy the site origin.

    Use the address through .atlassian.net; omit Jira project and Confluence space paths.

    Atlassian address showing the site origin
    Site URL
  3. 08.A2

    Atlassian // Open API tokens.

    Open Profile → Account settings → Security → Create and manage API tokens.

    Atlassian profile menu with Account settings
    Account settings
    Atlassian API token manager link
    API token manager
  4. 08.A3

    Atlassian // Create the matching token type.

    Choose standard or scoped, use the same authentication type in Agent Barn, add a name and expiration, then copy the value.

    Atlassian standard and scoped API token choices
    Choose token type
    Atlassian create API token dialog
    Name · expiration · create
  5. 08.A4

    Atlassian // Complete the credential.

    SITE URL

    Atlassian site origin.

    AUTHENTICATION TYPE

    Match the token type.

    EMAIL

    Atlassian account email.

    API TOKEN

    Copied token value.

  6. 08.A5

    Atlassian // Validate the product boundary.

    Test one permitted Jira project or Confluence space for every connected product, then confirm a location outside the configured boundary remains unavailable.

  7. 08.Z

    Test every selected integration.

    Run one expected action for each skill and confirm resources outside the selected boundary remain unavailable.

09
FINAL CHECK

Verify the complete recipe.

  • The existing Slack app connects with both Slack values.
  • The app responds in an allowed channel.
  • A destination outside the selected access rule receives no response.
  • Each required integration completes one representative task.
  • The command-approval and response-detail choices behave as selected.
  • The configured trigger runs: A scheduled ceremony, configured work-item change, or stand-up window.
  • The result follows Collect updates → Track blockers → Prepare summary → Keep moving.
  • The review rule is applied: Keep the agent focused on coordination and summaries; the team retains ownership of commitments, priorities, and delivery decisions.
RECIPE PATH COMPLETE

Scrum Master is ready for a controlled pilot.

Start with a narrow audience and reversible work, then widen access after observing representative tasks.

Return to recipes →