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

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,565 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.03565
Opus 5	$0.00079	$0.01783
Sonnet 5	$0.00032	$0.00713
Haiku 4.5	$0.00016	$0.00357

Measured 8d ago against content hash ef84a48b4546, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, 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 8d 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.

.claude/skills/aid-housekeep/SKILL.md · 249 lines

How it starts

The opening of the file, as written. The whole thing — 249 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 .claude/aid/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 .claude/aid/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 · 249 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.

8d 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 (5 stars, last pushed yesterday), licensed MIT. It adds 158 tokens to every session and 3,565 once invoked, about $0.0008 per session on Opus 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

mcore-split-pr

Split a PR into multiple PRs to reduce the number of required CODEOWNERS reviewer groups.

NVIDIA/skills · 25 tokens

shiplog

Recap of everything shipped since the last run - cross-repo PRs, security fixes, star deltas, and X traction, synthesized into a digest article and a ready-to-post shiplog in your voice.

aeonfun/aeon · 46 tokens

llxprt-issue-workflow

Use this skill when asked to address, fix, or work on a GitHub issue in the llxprt-code repository. Covers the complete issue lifecycle - branch setup, gh CLI usage, test-first planning, subagent delegation and review loops, the full verification cycle (including the stepfun-37 smoke test), open code review (ocr), PR…

vybestack/llxprt-code · 87 tokens

aid-housekeep