Set up and run a maintenance program

Set up and run a maintenance program

Maintenance programs are currently in early access. Reach out to your Slite contact to have them turned on for your workspace.
A maintenance program tells the Slite Agent which docs to look after, what to do on them and who reviews its work. This guide covers how to pick a routine, create a program and run it.

How it works

A maintenance program covers either one doc and its sub-docs, or the whole workspace for global maintenance programs.
Each program has:
  • Maintainers – the people who review the Agent's suggestions. Admins are maintainers who can also change the program, its members and its sources.
  • Schedule – how often the program runs: daily, weekly or monthly, weekly by default
And for maintenance programs set on docs:
  • Sources – what the Agent checks your docs against
  • Custom routine – optional, it lets you set your own instructions for what to generate and change
  • Policy doc – optional, a doc with rules the program should follow
On each run, the Agent reviews every doc in scope against your sources. When something needs to change, it opens a  change request⁠ . Your maintainers review them and decide what gets applied.
Program runs only use the sources every admin and maintainer can access among the ones selected.
Some sources such as BigQuery or Salesforce can’t be used.

Three kinds of maintenance programs

1. Fact-check program (default)

This is the default routine when you set a program on a set of docs. The Agent checks each doc against your sources and can:
  • Edit content that no longer matches your sources
  • Update the doc's title
  • Verify the doc when it's accurate, for 6 months by default
  • Suggest a new owner
  • Flag the doc as Outdated, naming the doc that replaces it
  • Ask the doc's owner to verify it when a source conflicts with it
  • Suggest archiving a doc that's no longer relevant

2. Custom maintenance program

You can write your own instructions for the Agent, up to 12,000 characters. Use it for jobs that go beyond checking existing content. For example, scaffold an org chart doc and keep it up to date from your sources.

3. Workspace maintenance program

A workspace admin can turn on some maintenance programs working on your entire workspace.
The first available of this kind is the Check docs most used by AI program. Each of its runs takes the unverified docs your Agents cited or read most over the last 12 weeks, up to five from each of the two usage lists, reviews them and routes suggested changes and verification to each doc's owner.

How to create a program

    Go to /app/maintenance-programs/new, or click in a doc header Agent maintenance → Maintenance Program.
    Pick the Doc the program will maintain.
    Set the Schedule. Choose the frequency (daily, weekly, monthly), and the days of the week it will run. Programs run weekly by default.
    Leave Custom routine off to fact-check the docs, or turn it on to give the Agent your own prompt.
    Add your Maintainers and choose who's an admin. Each maintainer must have read access to the program's doc.
    Add a Policy doc. This is optional, and allows you to define rules the program should follow.
    Select the Sources the Agent can use. At least one source is required.
    Click Create program.

Manage a program

Each program has Settings, Runs and Analytics tabs. Its status shows whether it's Draft, Active, Running or Paused.
From the program menu, you can Activate, Pause or Delete it. A program without sources stays paused, and a single warning notice explains why.
You can see some stats regarding the runs via the Analytics tab.

Run a program

Programs run on their schedule. Each program’s Runs tab lists its runs.
Only one run per program can be in progress at a time.

Review change requests

For programs set on docs, when a doc needs a change, the Agent opens a change request for your admins and maintainers to review. Each change request is assigned to one admin or maintainer, and nothing changes in the doc until someone approves it. Workspace programs, such as Check docs most used by AI, assign each change request to the doc's owner instead.