Skip to main content

Documentation Index

Fetch the complete documentation index at: https://bytestream.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Agents are more useful when they can reason from business context.

​
Build the chain

  1. Create a goal with a target date.
  2. Attach one or more KPIs.
  3. Create initiatives expected to move those KPIs.
  4. Link initiatives to projects, milestones, and tasks.
  5. Record KPI snapshots as work changes the metric.

​
Example

Goal: Reach 100 paying customers by Q2
KPI: paying_customers
Initiative: Content pipeline
Milestone: Launch public docs
Task: Publish API quickstart
If the KPI is off pace and the initiative has blocked tasks, heartbeat can show that unblocking the docs launch is more important than a lower-priority unrelated task.

​
KPI snapshots

Snapshots update KPI current value and create attribution history. 
{
  "value": 34,
  "source": "agent",
  "attribution_note": "Checked Stripe dashboard",
  "attributed_to_initiative_id": "initiative-uuid",
  "attributed_to_issue_id": "issue-uuid"
}

​
Initiative health

Heartbeat summarizes linked execution:
  • Total issues
  • Completed issues
  • Stalled issues
  • Blocked issues
  • Expected KPI impacts
Link tasks to initiatives when the work exists to move a KPI. Leave routine chores unlinked unless they truly affect a strategic objective.