Building and reviewing a charter from Slack

When a team already exists and works in Slack, Particulars can use recent channel history to draft a starting charter and later notice when the work has moved.

The system's output is evidence for an editor. It is not the truth until a person reviews it.

How it works

  1. Install the app. One install per Slack workspace. The button above begins the authorization flow.
  2. Connect the workspace to an organization. After Slack returns you to Particulars, choose or create the organization the workspace belongs to. The bot token is scoped to that organization and encrypted at rest.
  3. Choose a channel. From the organization dashboard, choose Generate from Slack, or connect a channel from a charter's Settings → Sources.
  4. Build a draft. Particulars reads recent messages, identifies evidence about the team's purpose, work, roles, decisions, and interfaces, and proposes a draft. Most channels take 30–90 seconds.
  5. Review the evidence. Edit anything. Remove confident nonsense. Add what the channel cannot know. Nothing becomes the published model until an editor confirms it.
  6. Keep it connected. On a regular cadence, Particulars compares the current charter with recent evidence and flags meaningful drift.

Scopes and data

Particulars requests only the Slack scopes needed for connected channels:

  • channels:history, groups:history — read messages in channels a charter is connected to
  • channels:read, groups:read — list channels so an editor can choose them
  • users:read, users:read.email — resolve Slack IDs to people
  • commands — handle the /charter command
  • chat:write — answer commands, send requested messages, and post enabled team intelligence
  • team:read — display the workspace name

Particulars does not read direct messages, files, or channels that have not been connected.

Raw message text is not kept as a permanent record. Temporary draft-job data is retained only long enough to complete or retry the requested generation, then deleted according to the Privacy Policy. Stored outputs are the charter, the editor-confirmed record, and limited derived signals needed for the product to work.

AI usage and limits

Ordinary AI is unmetered on paid plans. Drafts, scheduled reviews, decision detection, and enabled team intelligence do not create token overages.

The free plan limits how much of the model can be connected and reviewed, rather than presenting a running token counter.

Evidence quality

Warning

For better results, choose a channel with several weeks of substantive discussion about the work. A social channel or a brand-new project channel may not contain enough evidence to describe the team.

Particulars shows the basis for important observations. Editors should reject anything the evidence does not support.

Removing the integration

A Slack workspace administrator can uninstall Particulars from Apps → Manage Apps. Tokens are revoked immediately.

An organization owner can also disconnect Slack from Organization settings → Connectors.

What's next