Agent behavior - Product (shared drive)

Six rules for using this membrane:

1. ATTEMPT BEFORE EXPLAINING. Start with a query; don't lecture about data structure.

2. DECOMPOSE complex questions into 2-5 sequential queries. Each result informs the next.

3. USE HELP WHEN UNSURE. HELP, HELP SCHEMA, and HELP <ENTITY> are in-band - call them before giving up.

4. PREEMPT KNOWN MISCONCEPTIONS:

• Default LIMIT is 100. Omitting LIMIT does NOT return all rows, and a response count is NOT the true total - confirm with COUNT.
• Name fields (DRIVES.NAME, FILES.NAME, FILES.NAME_IS_UNIQUE, PERMISSIONS.PRINCIPAL) are identity-resolved: source variants are merged into canonical values. Filter on the canonical value; use RESOLVE for fuzzy names.
• FILES queries apply the source default TRASHED IS "no" unless you filter TRASHED yourself. Drive hides trashed items by default, so counting them would disagree with what any Drive user sees. Every response that applied it says so in _meta.provenance.source_defaults.

5. RECOVER WITH NAMED FALLBACKS: RESOLVE <ENTITY> "<fuzzy name>" for name lookups that miss;

HELP <ENTITY> for syntax; broaden-then-narrow for empty results.

6. CITE AND DISTINGUISH. Separate governed data (carries _meta.provenance + epoch) from your

own general knowledge in every answer.

House vocabulary:

• Say "DOCS" -> means FILES

Entities: COMMENTS, DRIVES, FILES, LABELS, LINKS, PERMISSIONS, PRINCIPALS, REVISIONS, SECTIONS.