Lfe Hygiene

Conduct a structural audit of the repository to detect "Documentation Drift" or "Spaghetti Files." Use in Phase 5 (Hygiene sub-pipeline, Step 1).

44 stars 3 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add StChiotis/Library-First-Engineering --skill lfe-hygiene
Manual install
git clone --depth 1 https://github.com/StChiotis/Library-First-Engineering.git /tmp/Library-First-Engineering
mkdir -p ~/.claude/skills
cp -r /tmp/Library-First-Engineering/.agents/skills/lfe-hygiene ~/.claude/skills/lfe-hygiene

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# LFE Hygiene Audit

## Position in Pipeline
- **Phase**: 5 (Hygiene sub-pipeline, Step 1)
- **Persona**: Archivist
- **Trigger**: Scheduled every 5 sessions (tracked in `pipeline_status.md`) or manually by human
- **Next Step**: `/lfe-improve-architecture` (Step 2)

## Mission
Ensure the repository remains LFE-compliant. Detect drift between the Library and the physical filesystem, and verify the coordination layer is clean.

## Workflow

### 1. Floor Map Audit
- Read `.docs/README.md`.
- Scan the filesystem.
- **Identify "Illegal" Files**: Files that exist but are not registered in the Floor Map.
- **Identify "Ghost" Files**: Files listed in the Floor Map that no longer exist.

### 2. Coordination Layer Audit
The cleanup tiers in `lfe-archivist/SKILL.md` Step 5a/5b are the source of truth for which files should be present at each lifecycle moment. This audit checks for drift from those rules.

- **Mission complete** (`Mission State == [MISSION COMPLETE]` or `[BLANK CANVAS]`): no execution OR planning files should remain. If any of `01_grill_summary.md`, `02_prd.md`, `03_slices.md`, `plan_critique.md`, `active_plan.md`, `builder_done.md`, `tdd_report.md`, `critique.md`, `inspection_report.md`, `diagnosis_report.md`, `rework_directive.md` still exist, or if `.plans/checks/` contains any files → flag as "Stale Coordination Files".
Read the full skill on GitHub

Details

Skill name
lfe-hygiene
Path
.agents/skills/lfe-hygiene/SKILL.md
License
MIT
Repo updated
14 July 2026

FAQ

What does the Lfe Hygiene skill do?

Conduct a structural audit of the repository to detect "Documentation Drift" or "Spaghetti Files." Use in Phase 5 (Hygiene sub-pipeline, Step 1).

How do I install the Lfe Hygiene skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add StChiotis/Library-First-Engineering --skill lfe-hygiene. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Lfe Hygiene popular?

It lives in StChiotis/Library-First-Engineering, which has 44 GitHub stars and 3 forks.

Related skills

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.