What is aid-housekeep?

A housekeeping workflow that brings project documentation, generated summaries, and leftover work files back into agreement with the code. It runs the cleanup stages in a fixed, gated order on a separate Git branch.

Use it after work lands to update the Knowledge Base, regenerate stale summaries, and clean work-area artifacts.

Project knowledge can become outdated as code changes, and temporary files can accumulate. This workflow identifies those differences and cleans them up through reviewable stages.

aid-housekeep — Skill for Claude Code by AndreVianna/aid-methodology

Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo

git clone --depth 1 https://github.com/AndreVianna/aid-methodology

agentmods

npx agentmods add skills/andrevianna/aid-methodology/aid-housekeep

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/andrevianna/aid-methodology/aid-housekeep/github.svg)](https://agentmods.dev/skills/andrevianna/aid-methodology/aid-housekeep)

Your own site

<a href="https://agentmods.dev/skills/andrevianna/aid-methodology/aid-housekeep"><img src="https://agentmods.dev/badge/skills/andrevianna/aid-methodology/aid-housekeep/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/andrevianna/aid-methodology/aid-housekeep"><img src="https://agentmods.dev/badge/skills/andrevianna/aid-methodology/aid-housekeep.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 158 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 3,632 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits

NVIDIA SkillSpector pass 7 Sept 2026

How audits are shown

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00158	$0.03632
Opus 5.5	$0.00063	$0.01453
Sonnet 5.5	$0.00032	$0.00726
Haiku 4.5	$0.00016	$0.00363

Measured 26d ago against content hash 1ad05377e8bd, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

aid-housekeep scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 26d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/aid-housekeep/SKILL.md · 251 lines

How it starts

The opening of the file, as written. The whole thing — 251 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Knowledge Base Housekeeping

State machine: PREFLIGHT → KB-DELTA → SUMMARY-DELTA → CLEANUP → DONE.

Runs the three standard housekeeping jobs in a safe, fixed order, on a dedicated aid/housekeep-* branch, with one commit per stage. Re-running after a stalled gate resumes at the stalled stage — not job 1.

Prerequisite: A .aid/ directory must exist (init has run). Not Plan Mode (stages write). A git repository must be present and clean enough to branch.

Absent from the mandatory pipeline flow. /aid-housekeep is an optional, on-demand skill (REQUIREMENTS.md FR6). It is NOT inserted into the phase-to-skill pipeline mapping and no phase gate references it.

State machine — each /aid-housekeep invocation drives the state machine until it hits a natural pause point per .aid/runtime/templates/state-machine-chaining.md. Mechanical states auto-chain; only PAUSE-FOR-USER-ACTION and HALT stop the run.

aid-housekeep  ▸ one step per run
  [ PREFLIGHT ] → [ KB-DELTA ] → [ SUMMARY-DELTA ] → [ CLEANUP ] → [ DONE ]

Arguments

Argument	Effect
(none)	Full gated sequence: `KB-DELTA → SUMMARY-DELTA → CLEANUP` (FR7 default).
`--cleanup-only`	Jump straight to CLEANUP, skipping KB and summary (AC10). Sets `Mode: cleanup-only`. KB/Summary stage rows are left `—` (a deliberate cleanup-only run does not violate C1 — REQUIREMENTS.md FR7). `--grade X` is ignored under `--cleanup-only` (SUMMARY-DELTA is bypassed).
`--grade X`	Pass-through to the SUMMARY-DELTA delegation to `/aid-summarize`. Format: `[A-F][-+]?` (e.g., `A`, `A-`, `B+`). Without this, resolved via `bash .aid/runtime/scripts/config/read-setting.sh --skill summary --key minimum_grade --default A`. Ignored when `--cleanup-only` is also given.

--fetch / offline: The online-first / permissioned-offline gate (REQUIREMENTS.md C2, AC3) is feature-002's concern. The skeleton does not parse a --fetch flag; it simply routes into KB-DELTA, whose body (feature-002) performs git fetch origin and the offline-permission prompt.

Read the full file on GitHub · 251 lines

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

26d ago Changed 1ad05377e8bd
1mo ago Changed · +2 lines c08934382b91
2mo ago First seen · 249 lines · 158 tokens per session scan A ef84a48b4546

Subscribe to this mod's changes

aid-housekeep is a skill published in the GitHub repository AndreVianna/aid-methodology (6 stars, last pushed 11d ago), licensed MIT. It adds 158 tokens to every session and 3,632 once invoked, about $0.0006 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Git and workflow Project management

aid-housekeep next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
aid-housekeepAndreVianna/aid-methodology	Skill	6	11d ago	MIT	A	158	Claude Code
merge-batchdiegosouzapw/OmniRoute	Skill	85k	today	MIT	A	46	Claude Code
prowler-commitprowler-cloud/prowler	Skill	15k	yesterday	Apache-2.0	A	44	Claude Code, Codex
gh-auth-isolationgithub/gh-aw	Skill	5.6k	today	MIT	A	20	Claude Code, Codex
comet-githubrpamis/comet	Skill	3.3k	today	MIT	A	72	Claude Code, Codex
github-skillzeenie-ai/OpenCompany	Skill	1.1k	3d ago	MIT	A	51	Claude Code
re0-mergeLilMGenius/paperthin	Skill	1.4k	today	MIT	A	70	Claude Code