> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pnbr.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Work with project knowledge

> Choose the Runtime workflow for adding sources, finding evidence, extracting information, or reviewing changes.

Use the Runtime MCP for day-to-day work inside a Penumbra project. Start by
checking the active project, then choose the task you need.

## Choose a task

<Columns cols={2}>
  <Card title="Check the active project" icon="compass" href="/runtime/orient">
    See the current project, its Shapes, and the kinds of records available.
  </Card>

  <Card title="Add a Shape to the project" icon="shapes" href="/runtime/choose-shape">
    Search the catalog, compare the best matches, and add one after review.
  </Card>

  <Card title="Add a source" icon="file-plus" href="/runtime/add-source">
    Save text, a public web page, or a file and confirm you can retrieve it.
  </Card>

  <Card title="Find knowledge and evidence" icon="magnifying-glass" href="/runtime/find-knowledge">
    Read complete records and quote the source passages behind them.
  </Card>

  <Card title="Extract a source" icon="wand-magic-sparkles" href="/runtime/extract-source">
    Estimate the cost, run extraction through a Shape, and inspect what it produced.
  </Card>

  <Card title="Capture a new record" icon="pen-to-square" href="/runtime/capture-knowledge">
    Add a fact, finding, decision, or relationship in a reviewable workspace.
  </Card>

  <Card title="Edit an existing record" icon="pen" href="/runtime/change-knowledge">
    Check out a live record, stage the edit, validate it, and submit it.
  </Card>
</Columns>

## Before a write

Ask the agent to show the active project, the Shape it will use, and the
proposed workspace contents. For paid extraction, ask for the dry-run estimate.
For captures and edits, ask it to wait for approval before submission.

See [How review works](/getting-started/operating-principles) for the difference
between staged, submitted, pending, and live results.

<Card title="Connect the Runtime MCP" icon="plug" href="/getting-started/connect-agent">
  Add Runtime to Codex, Claude Code, Cursor, or another MCP-capable agent.
</Card>