Documentation

Reports And Asks

Understand which agent messages need action and which ones are informational updates.

Kindship agents can send both asks and reports. They should feel different.

An ask needs your input. A report keeps you informed.

Asks Need Action

Asks are messages where the agent is waiting for you before it can continue safely or correctly.

Common asks include:

  • Questions - The agent needs a free-text answer.
  • Choices - The agent needs you to pick an option.
  • Approvals - The agent needs permission before doing something.
  • Calls to action - The agent needs you to complete a step outside Kindship and mark it done.

Badges and task lists should prioritize asks because asks are the messages that create work for you.

Reports Are Informational

Reports are status updates, summaries, or completed-work notes. They should not imply that you need to confirm anything.

Read reports when they are useful. Ignore them when they are not relevant to your current attention.

If a report sounds like it needs a decision, the agent should turn it into an ask instead of hiding the request inside a status update.

Where Reports Appear

Reports can appear in the inbox, activity surfaces, notifications, or Telegram depending on your settings.

Kindship is moving reports toward shorter, higher-signal summaries:

  • Reports should avoid repeated agent-name prefixes when the surrounding channel already gives that context.
  • Telegram updates should lead with the content instead of making every message start with the same header.
  • Long iterative progress should be summarized before it reaches you.
  • Reports should not create separate planning-chat threads just to be visible.

How To Triage

When you open an inbox or notification surface:

  1. Handle asks first.
  2. Skim reports only when you need context.
  3. Follow deep links when you want the originating thread, file, or run.
  4. Leave informational reports alone when no reply control is shown.

This keeps the agent's true need from disappearing inside routine updates.

Telegram Updates

On Telegram, the most useful update is usually the content itself: what changed, what matters, and whether anything needs action.

If a Telegram update includes buttons or asks for a reply, treat it as actionable. If it is only a concise summary, treat it as a report.

Troubleshooting

I see a badge but only reports are listed

Badges are intended to focus on asks. If reports are increasing an action count, treat that as a noise issue rather than a request to answer every report.

A report seems to require approval

Ask the agent to restate the decision as an approval ask. Reports should not be used as hidden confirmation prompts.

Telegram updates are too long

Ask the agent for shorter reports and clearer asks. The best report is the minimum context needed to understand what changed.