Portable knowledge bundles for humans and AI agents.

---
type: Metric
title: Monthly Recurring Revenue
description: Recurring subscription revenue normalized to a monthly period.
resource: dashboard://revenue/mrr
tags: [revenue, saas, finance]
timestamp: 2026-06-13T00:00:00Z
---

# Calculation

MRR is the predictable recurring revenue generated by active subscriptions in the [subscriptions table](../tables/subscriptions.md).

Include active subscriptions with recurring billing. Exclude one-time setup fees, refunds, and usage-only charges unless normalized into a recurring plan.

# Examples

```sql
select sum(monthly_amount_usd) as mrr
from analytics.subscriptions
where status = 'active';
```

# Citations

[1] [Revenue dashboard](dashboard://revenue/mrr)

---
type: BigQuery Table
title: Orders
description: One row per completed customer order.
resource: https://console.cloud.google.com/bigquery?p=acme&d=sales&t=orders
tags: [sales, orders, revenue]
timestamp: 2026-06-13T00:00:00Z
---

# Schema

| Column | Type | Description |
|--------|------|-------------|
| `order_id` | STRING | Unique order identifier. |
| `customer_id` | STRING | Foreign key to [customers](customers.md). |
| `total_usd` | NUMERIC | Order total in US dollars. |

# Citations

[1] [BigQuery table](https://console.cloud.google.com/bigquery?p=acme&d=sales&t=orders)

---
type: Laravel Model
title: User Model
description: Authenticated account model for customers and internal operators.
resource: repo://app/Models/User.php
tags: [laravel, model, authentication]
timestamp: 2026-06-13T00:00:00Z
---

# Responsibilities

The User model represents an authenticated account and owns customer-facing resources.

# Related concepts

Used by the [API users route](../routes/api-users.md) and protected by the [user policy](../policies/user-policy.md).

# Citations

[1] [Source file](repo://app/Models/User.php)

---
type: WordPress Post Type
title: Product
description: Custom post type used to manage product content.
resource: wp-admin/edit.php?post_type=product
tags: [wordpress, post-type, content]
timestamp: 2026-06-13T00:00:00Z
---

# Purpose

The Product post type stores product landing pages and related metadata.

# Related concepts

Rendered by the [single product template](../templates/single-product.md) and enriched by [product fields](../acf/product-fields.md).

---
type: API Endpoint
title: Create Customer
description: Creates a new customer record.
resource: https://api.example.com/customers
method: POST
path: /api/customers
tags: [api, customers]
timestamp: 2026-06-13T00:00:00Z
---

# Request

Accepts a customer payload shaped by the [Customer schema](../schemas/customer.md).

# Response

Returns the created customer object or a [rate limit error](../errors/rate-limit.md).

# Examples

```http
POST /api/customers
Content-Type: application/json
```

---
type: Policy
title: Refund Policy
description: Rules support and billing teams use when evaluating customer refund requests.
resource: docs://policies/refunds
tags: [support, billing, policy]
timestamp: 2026-06-13T00:00:00Z
---

# Purpose

The refund policy defines when support can approve a refund, when billing review is required, and which cases must be escalated.

# Decision points

* Check whether the customer has an active subscription in the [billing system](../systems/billing.md).
* Escalate disputes, chargebacks, and unclear billing events through the [incident response playbook](../playbooks/incident-response.md).

# Citations

[1] [Refund policy source](docs://policies/refunds)

---
type: Constraint
title: Agent Safety Rules
description: Operating boundaries an AI agent must follow before using tools or changing customer-facing systems.
resource: docs://agent-context/safety-rules
tags: [agent, safety, tools]
timestamp: 2026-06-13T00:00:00Z
---

# Rules

The agent must read relevant system, tool, metric, and playbook concepts before taking action.

Do not change billing data, refund customers, send external messages, or modify production settings unless a human explicitly approves the specific action.

# Related concepts

Read the [billing system](../systems/billing.md), [Stripe tool](../tools/stripe.md), and [support triage playbook](../playbooks/support-triage.md) before using operational tools.