Documentation / Projects

Housekeeping

Rules for an organization's files, checked on a schedule, with fixes a person approves.

Files drift. Names stop following the office convention, the same PDF is uploaded three times, a result document falls behind its study, a file lands in the wrong project. Housekeeping checks every file in an organization against the organization's rules and reports what it finds, with a proposed fix for each. Nothing changes until someone applies a fix.

A run checks every file and proposes a fix for each problem. Nothing changes until a person applies the fix, and every applied fix goes in the activity log where it can be undone.

Open it from the dashboard: Organization → Housekeeping.

Who sees what

RoleRulesFindings and activityChange rules, schedule, Run now
Owner, adminReadEvery workspaceYes
Workspace leadReadTheir workspacesNo
Everyone elseReadNoNo

Everyone can read the rules, because a naming convention people cannot see cannot be followed. Applying a fix needs edit access to the file's project (lead or editor).

Rules

Each rule is on or off for the whole organization. A workspace can have its own version of a rule, which replaces the organization's rule in that workspace only.

RuleWhat it checksProposed fix
Namingthe name follows a template such as {project}_{kind}_{date}rename
Stale filesnobody has opened the file for a number of daysarchive, or report only
Duplicatesthe same content uploaded more than once; the oldest copy is keptarchive the newer copies
Unsupported filesa file type no longer acceptedarchive
Result documentsa document written from a study that has a newer result, or whose study was deletedregenerate, or archive
Classificationthe kind of document, and whether it belongs in its projectmove to the right project

Naming templates

A template is made of tokens in braces and the text between them:

TokenBecomes
{project}the project's name
{kind}the document kind, from the classification rule
{date}the date the file was added, YYYY-MM-DD
{title}the file's current name
{service}the study, for result documents
A template filled from the project's name, the file's classified kind, and the date it was added. The file type is never part of the template.

Choose whether words are joined with underscores or hyphens (both lower-case the words), or kept as typed. The file type is never part of the template: in the project Riverside, Site plan.pdf renamed to {project}_{kind}_{date} with underscores becomes riverside_drawing_2026-09-24.pdf. The rule's card shows an example as you type.

A pattern (a regular expression) can replace the template as the check, for offices whose names follow a code such as ABC-123_.... The template still proposes new names.

Classification

List the kinds of document your organization uses (drawing, specification, report, …); other is always added. Housekeeping asks the assistant's evaluation model which kind each file is, from the start of its text, and fills {kind} with the answer. With Check the project on, it also asks whether the file belongs in another project of the same workspace, and proposes a move only when the answer is clear.

Each file is asked once: the answer is kept for as long as the file's content is the same. If the organization has turned the assistant off, classification is skipped and the other rules still run.

In a project

The rules are set on the organization and apply where the files are. On a project's Data tab, a File rules strip under the files lists the rules that apply there and who set them; a rule marked with a workspace's name is that workspace's own version.

Files the rules flag are marked in the list (naming, stale, duplicate, file type). Open a file to see why. If the name breaks the naming rule, anyone who can edit the project can rename it from there: the box starts on the suggested name, and you can change it before pressing Rename. When the template uses {kind}, the box starts on the name the last run suggested from the file's content, and choosing another kind fills in the name that kind gives. The rename is recorded in Activity like any other fix.

A project checks its own files as soon as they are uploaded, so a new file is marked straight away. Duplicates across projects and classification only appear in Findings, after a run.

Schedule and runs

Owners and admins choose whether runs happen on a schedule and how many times a day (1 to 24), and cap how many files a run may classify. Run now starts a run straight away. The overview lists the recent runs: files checked, new findings, files classified.

Findings

Each finding names the file, its project, what is wrong and the proposed fix.

  • The fix's button (Rename, Archive, Move to …, Regenerate) makes the change. A proposed new name can be edited first. A naming finding without a proposed name still has the box, so you can type a name yourself.
  • Dismiss hides the finding; later runs leave it dismissed. Reopen brings it back.
  • A finding whose problem is gone is resolved by the next run.
  • Renames and archives can be ticked and applied together with Apply selected. Moves, regenerations and deletes are applied one at a time.
  • A file only moves to a project in the same workspace. Moving it to another workspace would change who can open it; move the whole project instead (Project settings → Workspace).

Archive keeps a file but hides it from the project and from the assistant. It is the suggested fix for files nobody needs, and it can be undone.

Delete… is offered next to Archive, never by a run and never in bulk. It asks you to type the file's name, removes the file for everyone, and cannot be undone.

Activity

Every applied fix is listed with who applied it and when, and recorded in the organization's audit log. Renames, moves and archives can be undone as long as the file is still as the fix left it; if someone changed it since, undo the later change first.