Skip to main content

Maintain Overview

Maintain is the Project workflow for Rules, Scans, Issues and Fixes. You decide what standards the code should meet, an agent searches the code for places that break them, you triage what it finds, and a coding agent or your own agent fixes the Issues that matter.

A Scan is an agent reading the code against your Rules. It is not a run of your test suite, and an Issue is a recorded finding, not a reproduced failure. That is why triage matters.

Open Maintain in the Project sidebar. A Project with no Rules yet shows Get started with Maintain, which walks you through adding Rules, running a Scan, triaging Issues and fixing one.

The workflow​

  1. Rules. Add Rules from the ready-made set, your Rule Library or another Project, write one in Markdown, or ask the Maintain agent to draft one. See Rules.
  2. Scan. Click Run a scan, select the Rules to scan for, and optionally say what to focus on (type @ to mention files or folders), limit the number of Issues, and choose the model.
  3. Triage. Findings land on the Issues board. Confirm the real ones, mark false positives, and archive what you do not want to act on. See Issues.
  4. Fix. Send an Issue to a coding agent with Fix, hand a complex one to a Discovery Run with Fix in Discovery, write a Plan first with Plan a fix, or give it to your own agent with Copy for local agent.
  5. Review. A Fix lands on a Branch, where you verify it, publish it and open a Pull Request.
  6. Resync. As the code moves on, some Issues go out of date. Resync checks whether each finding still matches the code.

The Maintain chat​

The chat panel on the Maintain page talks to the Maintain agent. It reads both the board and the code, so you can describe a problem instead of scanning for it and ask it to raise an Issue once you agree what it is. It can also draft Rules and start Scans and Fixes. Mention #Issues and #Rules to point it at specific ones. Quick prompts include What should I fix first?, Summarise my open Issues and Explain a Rule.

Next steps​