# Rules and the report

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

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

![A project rule with a slug prefix and its matching controls.](https://pr-765-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-`, words in a title, a kind or a collection. Every filled field must match. The rule gathers existing matches and later publishes; **From rule** marks the items it added. Hand-added items stay separate.

In a shared project, new finds wait for the owner unless automatic admission is on. Held finds tell the owner by email, at most once a day per project. Private matches are skipped unless **Include private artifacts** is on. 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-765-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-765-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-765-stg.superartifacts.app/docs/templates.md).
