# pm-bot

> A read-only product-manager agent that reports how GitHub and Linear work in flight aligns with product goals.

Source: https://openap.org/docs/pm-bot

pm-bot is a read-only product-manager agent. It reads the GitHub repositories it was granted and
the Linear issues in the linked workspace, then reports how the work in flight aligns with stated
product goals. It never writes to either system.

[Video: Simulated pm-bot: read-only GitHub and Linear work summarized against product goals.](https://openap.org/media/pm-agent-demo.mp4)

## What the demo shows

pm-bot reads its granted repositories and linked issues, groups the work in flight by product
goal, and posts a summary that recommends a next step — without changing anything in GitHub or
Linear.

The demo is a scripted Slack simulation; its people, repositories, issues, and results are
fictional.

## The controls at work

- Which repositories the agent may read is an install question, answered by the administrator who
  installs it — not something the agent discovers at runtime.
- [Safe tools](https://openap.org/docs/safe-tools) — read-only is a property of the tool contracts the session is
  offered, checked on every call.

## Install it

The bundle is in the repository at
[`examples/pm-agent`](https://github.com/authzed/openagentprimitives/tree/main/examples/pm-agent),
packaged as a [`.oap` agent container](https://openap.org/docs/packaging-oap):

```bash
oap agent lint    examples/pm-agent
oap agent install examples/pm-agent --namespace default
```

The install asks its two questions — which repositories the agent may read, and
the read-only GitHub PAT it authenticates with. It applies no privileged
resources, so it is safe to install into a shared namespace.
