メニュー
How to save, load, and manage tax filing records. Covers directory structure, summary.json schema, screenshot conventions, and annual totals. Used by agents that need to persist or read operation results.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
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.
Complete guide for navigating Marangatu portal (Paraguay tax system). Covers login, AngularJS sidebar navigation, form field mapping, invoice emission, and error recovery. Used by browser automation agents.
Legal framework, tax rules, exemption criteria, and filing procedures for Paraguayan fiscal obligations. Covers Ley 6380/2019, IVA treatment, IRP rules, progressive rates, and filing sequence. Used by all agents that make fiscal decisions.
Complete taxpayer and client data for fiscal operations. Contains identity, RUC, address, client details, tax treatment, and billing configuration. Used by agents that need to fill forms or verify taxpayer info.
| name | record-management |
| description | How to save, load, and manage tax filing records. Covers directory structure, summary.json schema, screenshot conventions, and annual totals. Used by agents that need to persist or read operation results. |
.user/records/
├── YYYY/
│ ├── MM/
│ │ └── YYYY-MM-DD/
│ │ ├── summary.json ← Operation data
│ │ ├── screenshots/ ← Evidence captures
│ │ └── pdfs/ ← Invoices and receipts
│ ├── IRP/
│ │ └── YYYY-MM-DD/ ← Annual IRP records
│ ├── health/
│ │ └── YYYY-MM-DD/ ← Health check reports
│ ├── profile/
│ │ └── latest.json ← Latest profile scrape
│ └── communications/
│ └── latest.json ← Latest communications check
See src/record.ts for the full TypeScript interface (TaxRecord).
Key fields:
date: ISO date of operation (YYYY-MM-DD)period: Fiscal period (YYYY-MM)type: "monthly" or "annual"gs_amount: Amount in guaranies (REQUIRED)invoice: Invoice details (number, timbrado, date, status)iva: IVA declaration details (form, amount_exempt, status)irp: IRP details (for annual records)Number screenshots sequentially with descriptive names:
01-bcp-exchange-rate.png
02-marangatu-login.png
03-invoice-form-before.png
04-invoice-form-filled.png
05-invoice-confirmation.png
06-iva-form-before.png
07-iva-form-filled.png
08-iva-confirmation.png
summary.json to .user/records/YYYY/MM/YYYY-MM-DD/.user/facturas/.user/records/YYYY/MM/YYYY-MM-DD/screenshots/.user/memory/MEMORY.md with the new declaration state| Script | Purpose |
|---|---|
npm run check-records | List all records with totals per year |
npm run irp-calc | Calculate annual IRP (supports -- YEAR --json) |
npm run exchange-rate | Get current BCP USD/PYG exchange rate |
npm run health-check | Automated Marangatu health check |
The TypeScript functions in src/record.ts:
listRecords() — all records sorted by dateloadRecord(period) — latest record for a YYYY-MM periodgetAnnualTotal(year) — sum of Gs amounts for a year (excludes annulled)getAnnualRecords(year) — all valid records for a yearisAnnulled(record) — check if invoice was cancelled