# Rules and the report

> Let a project fill itself, then see how it was read.

Kind: guide · ~2 min · Verified v0.162.2 · Next: [Use a template](https://pr-1704-stg.superartifacts.app/docs/templates.md)

![A project rule with a slug prefix and its matching controls.](https://pr-1704-stg.superartifacts.app/screenshots/docs/project-rule-light.05ed2a5c.webp)

*The Rule card describes what joins the project.*

Your project can gather matching artifacts as they are published.

**Fill a project with weekly updates**

```prompt
Add a rule to <project> that pulls every artifact whose slug starts with weekly-. Keep automatic admission off when the project is shared, and leave private artifacts out unless I opt in. Send me the project and report links.
```

## What the rule finds

A rule can match a slug prefix such as `weekly-`, text inside a slug or a title, a collection, a kind, a template or a visibility, and sorts what it finds newest first, oldest first or by title. Every filled field must match, and a rule needs at least one. A workspace can have up to 20 rule projects. The rule gathers existing matches and later publishes; **From rule** marks the items it added. Hand-added items stay separate.

In a shared or public project, new finds wait for the owner unless **Admit automatically** is on. Held finds tell the owner by email, at most once a day per project. In those projects, private matches are skipped unless **Include private artifacts** is on; a project only you can open includes them either way. Admitting them opens them through the project to the people you share with.

![The From rule badge on an item added by the project rule.](https://pr-1704-stg.superartifacts.app/screenshots/docs/project-rule-items-light.926425da.webp)

*From rule tells you why an item is here.*

## The report

![The project report with views, readers, responses and the artifacts it counts.](https://pr-1704-stg.superartifacts.app/screenshots/docs/project-report-light.6375db6a.webp)

*The report belongs to the owner.*

The report gathers reading and response counts from the artifacts, plus their fields and recent activity. A source that could not be read is marked, rather than counted as zero.

## Check it worked

The Rule card shows the saved match. Matching items carry **From rule**. The report lists the artifacts and shows their counts; an unread project can have no reading activity yet.

Next: [Use a template](https://pr-1704-stg.superartifacts.app/docs/templates.md).
