aieos-status

Reports the status of 42 knowledge volumes by running a read-only Python status module.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Tracking the state of a 42-volume documentation collection by hand is error-prone: volume types require different section counts, audit notes live in dated report files, and some volumes exist only as scaffolds. This Skill produces an accurate, evidence-based status table in one command. ## Core Features & Use Cases - Status Table Generation: Runs python -m ferramentas.status to output a Markdown table of all 42 volumes with type, status, section counts, latest audit score, and perishability flags. - Derived State Detection: Distinguishes recorded states (RASCUNHO, REQUER_REVISAO, PRONTO) from the derived PENDENTE state for missing folders or missing _VOLUME.yml files. - Audit Note Resolution: Selects the most recent audit report using a (date, revision) grammar rather than alphabetical order, avoiding silent misordering of re-audits. - Use Case: When asked "how much is left" or "which volumes are ready", run the command and paste the literal table plus the summary line as the answer. ## Quick Start Ask the assistant to report the current state of the AI-ENGINEERING-OS volumes by running the status command from inside the project directory.

Frequently Asked Questions about aieos-status

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

FAQPage Schema
How do I check the status of all volumes in the collection?▼

Run `python -m ferramentas.status` from inside the AI-ENGINEERING-OS directory. It prints a Markdown table of all 42 volumes plus a summary line counting volumes by status, exiting 0 on success or 2 if the contract is missing.

What does PENDENTE mean in the volume status table?▼

PENDENTE is a derived state, never written to disk. It appears when a volume is declared in the contract but its folder is missing, or when the folder exists without a `_VOLUME.yml` file. Fix it by creating the missing artifacts, not by editing YAML.

Why does the Secoes column show different totals like 17 versus 18?▼

Expected section counts depend on volume type. BIBLIOTECA volumes swap two sections for a catalog (17 total), and PROCESSO volumes omit the models section (17 total). Comparing counts across types is not meaningful.

Why does the audit column show a dash instead of a score?▼

A dash means either no audit report exists or the report's `media:` line did not match the expected format. Reports are selected by date and revision parsed from the filename grammar, not alphabetically.

Does the status tool modify any files when it runs?▼

No, the status module is strictly read-only and never writes anything. If the reported state looks wrong, the discrepancy is on disk, not in the tool.