aieos-auditar

Audits AI-ENGINEERING-OS volumes via a subagent and records dated reports with status updates.

Updated Aug 3, 2026
One-click install
npx skills add https://github.com/GuilhermeBrancalhao/ENGINE-CODEX --skill aieos-auditar-guilhermebrancalhao
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aieos-auditar
Source: https://github.com/GuilhermeBrancalhao/ENGINE-CODEX/tree/main/acervo/.claude/skills/aieos-auditar
Command: npx skills add https://github.com/GuilhermeBrancalhao/ENGINE-CODEX --skill aieos-auditar-guilhermebrancalhao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Volumes in the AI-ENGINEERING-OS knowledge base need an objective quality gate before being marked PRONTO, and manual review is inconsistent. This Skill runs a structured audit between gate 2 and gate 3, dispatching a dedicated auditor subagent, recording a dated report, and updating the volume status based on strict scoring criteria. ## Core Features & Use Cases - Subagent-based auditing: Dispatches the auditor-fable subagent with the volume id, section files, dependencies, and a mandatory output format including a media: N.N line. - Machine-readable reports: Saves the auditor output verbatim to auditorias/VOL-NN-auditoria-AAAA-MM-DD.md and verifies the score line is parseable by status.py. - Strict pass criteria: Marks a volume PRONTO only if the average score is at least 8.0, no section scores below 6, and all three validation gates pass; otherwise sets REQUER_REVISAO or RASCUNHO. - Use Case: After finishing a draft volume, run the audit to get an independent scored review, a permanent report in auditorias/, and an automatic status update in _VOLUME.yml and the CHANGELOG. ## Quick Start Audit volume 05 of the acervo by running the gates, dispatching the auditor subagent, and updating its status based on the resulting score.

Frequently Asked Questions about aieos-auditar

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

FAQPage Schema
How do I audit a volume in the AI-ENGINEERING-OS acervo?▼

Run the validation gates with python -m ferramentas.validar NN and the example tests, then dispatch the auditor-fable subagent with the volume id, section files, and dependencies. Save its output to auditorias/ and update the status based on the score.

What score does a volume need to be marked PRONTO?▼

A volume is approved only if its average score is at least 8.0 and no individual section scores below 6. All three validation gates must also pass; any red gate forces the status back to RASCUNHO.

Why is my audit score not being read by the status tool?▼

The status tool matches a line exactly like 'media: N.N' using a strict regex. Scores in bold, inside tables, with a /10 suffix, uppercase, or accents will not match; fix the line format rather than the regex.

Can I audit multiple volumes in one pass?▼

No. Each audit dispatch must cover exactly one volume, because auditing two volumes in the same pass mixes contexts and produces an average score across different things.

What happens when a volume fails the audit?▼

The status is set to REQUER_REVISAO (or RASCUNHO if any gate fails), the feedback is applied to the flagged sections, and the cycle repeats. Old reports stay in auditorias/ as history; a new dated file is written on the next pass.