| 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:
intelligence/knowledge/ — Deep analysis with cited sources and articles
.user/intelligence/alerts/ — Active alerts and urgent items requiring action
.user/intelligence/DIGEST.md — Executive summary of latest research session
docs/legal/ — Obligations, fiscal calendar, Ley 6380 summary
.user/records/ — Filing history and precedents (summary.json files)
.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.