# How-to guides

Task-oriented pages for the operator of an instance: one goal per page - upgrade an instance,
set up the MCP read server, run a weekly review - with the steps a human takes and the sentence
handed to the agent. A how-to guide never retells an agent's procedure: the steps an agent runs
live in `instructions/`, and a guide here says what to prepare, what to ask for and where the
agent stops.

Working with the wiki:

- [Ingest a source](ingest-a-source.md) - a file, a folder, a web page, or a document submitted
  through the MCP server
- [Write a site handler](write-a-site-handler.md) - teach `raw fetch` how a website serves its pages
- [Fetch pages behind a login](fetch-pages-behind-a-login.md) - with your own session, through a
  browser, or through a fetch program of your own
- [Capture documentation from a git repository](capture-repository-docs.md) - and keep it current
- [Export guidelines to captured repositories](export-guidelines.md)
- [Query the wiki](query-the-wiki.md) - asking, and searching yourself
- [Maintain the wiki](maintain-the-wiki.md) - lint, provenance, and the gates on the way to a publish
- [Run the weekly review](run-the-weekly-review.md) - commitments in a task tracker against the
  project pages
- [Browse the wiki in Obsidian](browse-with-obsidian.md) - and how pages are named

Running the instance:

- [Update an instance](update-an-instance.md) - to a newer release of the stack
- [Troubleshoot an instance](troubleshoot.md)
- [Set up the MCP read server](set-up-the-mcp-server.md) - for a consumer that is not a terminal
  on this machine
- [Trace and score agent sessions](trace-and-score-sessions.md)
- [Use 1Password for settings](use-1password-for-settings.md) - secrets and private values out
  of the tree, on the desktop and in CI

Installing a new instance is [INSTALL.md](../../INSTALL.md) at the repository root.