# Site guides

Site guides keep short, reusable tips for websites your agents visit. A guide combines tips
provided by Rukou with tips saved by people and agents in your workspace.

## Add a tip

1. Open **Site guides** in the workspace.
2. Enter the website's hostname or a page address.
3. Write one practical tip of up to 280 characters and select **Add**.

A useful tip describes a step that remains useful on the next visit, such as "Open the
navigation menu to find the search field on the mobile layout." Avoid account details,
passwords, codes, or copied private page content.

Agents receive the guide the first time a tab reaches that site in a session. They can read
it again with `rukou_site_guide`. An agent can also add a tip it learned while completing your
task. A tip is advice about using a site; it does not authorize another task or action.

## Keep tips current

Workspace members can edit or delete workspace tips. If another person changed a tip while
you were editing, the app lets you use the latest text or keep your draft before saving.
An archived workspace's guides are read-only.

Rukou's tips are read-only in your workspace. An agent can propose one of its tips to Rukou
with `share: true` when adding it. The team reviews the proposal before making it available
to other customers.