audit-data-contracts

Audit field type and nullability consistency across FacturaRecord, SelectionVM, and report dataframes.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/ElPoot/contabilidad --skill audit-data-contracts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-data-contracts
Source: https://github.com/ElPoot/contabilidad/tree/main/.agents/skills/audit-data-contracts
Command: npx skills add https://github.com/ElPoot/contabilidad --skill audit-data-contracts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents silent reporting and export bugs by validating that domain models and view-model fields remain type- and nullability-consistent across the FacturaRecord → SelectionVM → report dataframe pipeline.

Core Features & Use Cases

  • Field-by-field contract auditing: Compares each declared field in FacturaRecord with the corresponding field types and nullability in SelectionVM and other state/view layers.
  • Export contract verification: Checks that dataframe report column types and conversion logic match what the domain expects, including handling of None/nulls and string-encoded numeric fields.
  • Document state integrity: Detects scattered or inconsistent usage of allowed status values (pendiente, pendiente_pdf, sin_xml, clasificado), and verifies whether they are centralized.

Quick Start

Ask it to audit the current codebase for contract inconsistencies between FacturaRecord, SelectionVM, MainWindowState, and the export report dataframe logic.

Frequently Asked Questions about audit-data-contracts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check data contract consistency between Python view models and domain records?

To check data contract consistency, compare declared fields in FacturaRecord with corresponding types and nullability in SelectionVM and MainWindowState. This detects ambiguous fields, inconsistent nullability, and duplicated derived data across layers to prevent silent reporting and export bugs.

Why does my report export have nullability mismatches in the dataframe columns?

Report export nullability mismatches occur when dataframe report column types and conversion logic do not match domain expectations, such as improper handling of None values or string-encoded numeric fields. Auditing the export contract verifies alignment between dataframe logic and domain models.

How do I verify document state integrity for invoice classification status values?

Verify document state integrity by detecting scattered or inconsistent usage of allowed status values like pendiente and clasificado. This process checks whether status values are centralized across the codebase to ensure consistent invoice classification workflows.

What is the best way to catch type mismatches across domain models and view models?

The best way to catch type mismatches is performing field-by-field contract auditing that compares each declared field in FacturaRecord with corresponding types in SelectionVM. This enforces reading implementation files and reporting real findings with clear evidence.

When should I audit data contracts in my invoice classification workflow?

Audit data contracts during invoice classification and report export workflows when code mentions models like FacturaRecord or view models like SelectionVM. This catches potential type issues across layers before they cause silent reporting bugs in production.