aped-purge

Regenerate an APED documentation index and classify output files.

2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/yabafre/aped-claude --skill aped-purge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aped-purge
Source: https://github.com/yabafre/aped-claude/tree/main/src/templates/skills/aped-purge
Command: npx skills add https://github.com/yabafre/aped-claude --skill aped-purge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

APED projects can accumulate stale, unknown, or orphaned documentation under the output directory, making it hard to keep a clean canon and a reliable entry-point index.

Core Features & Use Cases

  • Doc hygiene audit + classification: Walks {{OUTPUT_DIR}}/** and classifies each entry as canonical, archived, allowlisted, or unknown.
  • Always-on index regeneration: Rewrites {{OUTPUT_DIR}}/INDEX.md from the current filesystem state so downstream tooling and future runs stay accurate.
  • Interactive unknown triage with safety rails: Surfaces unknown files with a per-file menu that supports archiving, inlining into canonical artefacts, allowlisting, deleting (typed confirmation), or skipping—read-only by default.

Quick Start

Run aped-purge to audit docs/aped, regenerate INDEX.md, and interactively resolve any unknown or orphaned documentation.

Frequently Asked Questions about aped-purge

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

FAQPage Schema
How do I find orphaned documentation files in my APED output directory?

To find orphaned documentation files, run an APED doc hygiene audit to walk the output directory and classify each artefact as canonical, archived, allowlisted, or unknown. Unknown files are surfaced for interactive triage so you can decide whether to archive, inline, allowlist, delete, or skip them.

How does INDEX.md regeneration work from the live filesystem?

INDEX.md regeneration works by walking the live filesystem state of the output directory and rewriting the INDEX.md file. This ensures the documentation index accurately reflects current canonical, archived, and allowlisted artefacts for downstream APED pipeline tooling.

Can I safely triage unknown APED docs without accidentally deleting files?

You can safely triage unknown APED docs because the system is read-only by default and requires explicit per-file user choices for any moves or deletes. Deleting requires typed confirmation, preventing accidental file removal during the documentation hygiene audit.

What is the best way to maintain doc hygiene and canon conformance in an APED pipeline?

The best way to maintain doc hygiene and canon conformance is to run an APED triage audit that classifies all output directory files and regenerates the INDEX.md. This interactive process resolves orphaned files and ensures the documentation canon stays clean and reliable.

Does APED triage support archiving and allowlisting files during the audit?

APED triage supports archiving and allowlisting files during the audit. The interactive per-file menu allows you to archive unknown artefacts, inline them into canonical docs, add them to an allowlist, or delete them with typed confirmation.

Why does my APED documentation index keep showing stale or missing files?

Your APED documentation index shows stale or missing files because it is not being regenerated from the live filesystem. Rewriting INDEX.md during a doc hygiene audit walks the current output directory state, ensuring the index accurately reflects all existing canonical and archived artefacts.