reading-data

Installation
SKILL.md

Skill: TraceMem Reading Data (Data Products)

Purpose

This skill teaches how to safely and correctly read data using TraceMem Data Products. Direct database selection or API calls are prohibited; all data access must be mediated by TraceMem.

When to Use

  • When you need to retrieve information (database rows, API results, resource state).
  • When you need to search or query for specific records.

When NOT to Use

  • Do not use for writing data (use decision_write / insert product).
  • Do not try to use standard SQL libraries or HTTP clients for governed data.

Core Rules

  • Decision Envelope REQUIRED: You MUST have an active decision_id from decision_create before calling decision_read. Reading data without a decision envelope will FAIL.
  • Data Products Only: You must access data via a named "Data Product".
  • Operation Specificity: A Data Product usually supports only ONE operation. Use a "read" product (e.g., customers_read) for reading.
  • Purpose is Mandatory: You must declare a purpose string for every read. This purpose must be in the product's allowed_purposes list.
  • Least Privilege: Only request the data you strictly need.
Related skills
Installs
13
GitHub Stars
1
First Seen
Jan 23, 2026