governing-legacy-retention-and-archives

Classify, archive, and govern legacy documents, skills, evidence, and branches with recoverable retention.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/alsdmlals4-eng/Base --skill governing-legacy-retention-and-archives-alsdmlals4-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: governing-legacy-retention-and-archives
Source: https://github.com/alsdmlals4-eng/Base/tree/main/skills/governing-legacy-retention-and-archives
Command: npx skills add https://github.com/alsdmlals4-eng/Base --skill governing-legacy-retention-and-archives-alsdmlals4-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Legacy cleanup often destroys unique information: files get blanked, backups are moved without metadata, secrets get archived, and branches are deleted without auditing unique commits. This Skill enforces a governed retention workflow that preserves original content while removing legacy material from current authority, default routing, and implementation scope. ## Core Features & Use Cases - Lifecycle and retention classification: Separately assigns lifecycle states (CURRENT, ARCHIVE_HISTORY, DELETE_CANDIDATE, etc.) and retention classifications (COMPATIBILITY_ONLY, EVIDENCE_RETENTION, DELETE_PROHIBITED_SECRET, etc.) so handling stage and preservation duty are never conflated. - Archive records with manifests: Stores original content with SHA-256 hashes, superseded_by references, rollback refs, and enforced active_authority: false / implementation_authority: NONE flags. - Deletion gate and secret handling: Blocks deletion until uniqueness, references, rollback, and validator checks pass, and routes secrets to revoke/rotate/remove instead of archiving. - Use Case: When retiring an outdated design document, the Skill inventories references, classifies it as ARCHIVE_HISTORY, moves the unmodified original into the archive with full metadata, updates active links to the current canonical document, and verifies restore paths. ## Quick Start Use the governing-legacy-retention-and-archives skill to inventory and classify the legacy documents in this repository, then propose an archive plan without modifying anything until I approve.

Frequently Asked Questions about governing-legacy-retention-and-archives

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

FAQPage Schema
How do I archive legacy documents without losing information?

Preserve the original content unmodified, add archive metadata with content hash, superseded_by path, and rollback reference, then record it in a manifest with active_authority set to false. Update active references to point at the current canonical document instead of blanking the old file.

What is the difference between lifecycle state and retention classification?

Lifecycle state describes the processing stage, such as CURRENT, MERGE_TO_CANONICAL, or DELETE_CANDIDATE. Retention classification describes the preservation duty, such as ARCHIVE_HISTORY, EVIDENCE_RETENTION, or DELETE_PROHIBITED_SECRET. The two must be recorded separately, never merged into one field.

Can I archive exposed API tokens or credentials for record keeping?

No. Secrets, tokens, credentials, and private keys are classified DELETE_PROHIBITED_SECRET and must never be archived. They go through revoke, rotate, and remove procedures, and incident records must not copy the secret's original text.

When is it safe to delete a legacy file or Git branch?

Only after the deletion gate passes: unique content is preserved in canon or archive, active references are updated or stubbed, hashes and manifests are verified, a reproducible rollback ref exists, and deletion approval is documented. Branches additionally require a unique-commit audit and optional archive tag.

How do I retire an inactive skill without breaking consumers?

Mark it COMPATIBILITY_ONLY with load_by_default false and routable false, set a replaced_by pointer to the active skill, and update the registry, aliases, tests, and documentation references in the same change. Physical moves without these coupled updates are treated as failures.

What should I do when a legacy item's status is unclear?

Classify it as KEEP_UNRESOLVED and make no changes. Never judge retention by filename or date alone; investigate content, hashes, active references, and unique information until the classification is defensible.