knowledge-protocol

name	knowledge-protocol
description	Mandatory knowledge lookup protocol for all tax agents. Defines the 4-level search hierarchy (local → official → unofficial → unknown) that every agent must follow before answering any fiscal question.

Knowledge Lookup Protocol

Every agent in this plugin MUST follow this protocol before answering any tax-related question or making any fiscal decision. No exceptions.

LEVEL 1: LOCAL KNOWLEDGE BASE (search here FIRST, always)

Search in this order. Stop as soon as you find a verified answer:

1. intelligence/knowledge/ — Deep analysis with cited sources and articles
2. .user/intelligence/alerts/ — Active alerts and urgent items requiring action
3. .user/intelligence/DIGEST.md — Executive summary of latest research session
4. docs/legal/ — Obligations, fiscal calendar, Ley 6380 summary
5. .user/records/ — Filing history and precedents (summary.json files)
6. .user/config.ts — Taxpayer data, client data, obligation codes, URLs

If found: USE IT. Cite the file path in your response. If not found or outdated: proceed to Level 2.

LEVEL 2: OFFICIAL SOURCES (authoritative, verify against Level 1)

2.1. https://www.dnit.gov.py — DNIT (Direccion Nacional de Ingresos Tributarios) 2.2. https://marangatu.set.gov.py — Marangatu portal (tax filing system) 2.3. https://www.bcp.gov.py — Banco Central del Paraguay (exchange rates) 2.4. https://www.bacn.gov.py — Biblioteca y Archivo Central del Congreso (laws) 2.5. See full catalog: intelligence/knowledge/official-sources.md

If found: USE IT. Note it's from an official source. If contradicts Level 1: Flag the discrepancy as an alert. Propose updating the local knowledge base. If not found: proceed to Level 3.

LEVEL 3: UNOFFICIAL SOURCES (last resort, always verify)

Tax blogs, accounting firm websites, professional forums, news articles.

If found: USE IT but explicitly mark as UNVERIFIED. Recommend: Run fiscal-intelligence agent to verify and persist. NEVER present unverified info as established fact.

LEVEL 4: UNKNOWN

If nothing found at any level:

• Say clearly: "No verified information found on this topic."
• Suggest: run fiscal-intelligence to research, or consult a professional accountant.
• NEVER guess, assume, or invent fiscal rules.

Rules

• NEVER skip levels. Always start at Level 1.
• NEVER answer a fiscal question from memory alone — always check the local knowledge base first.
• When you find an answer, cite the source (file path for Level 1, URL for Level 2-3).
• If Level 2 contradicts Level 1, the discrepancy is an alert — flag it and propose updating local knowledge.
• All web searches about Paraguayan tax topics should be in Spanish.