← ClaudeAtlas

filinglisted

Give received artifacts a canonical home AND an index entry so recall can reach them. Intake, placement, indexing. Not a filesystem beautification pass.
0xUrsanomics/utopia-os · ★ 2 · AI & Automation · score 76
Install: claude install-skill 0xUrsanomics/utopia-os
# filing ## Why this exists A whole class of confident false negatives has one root cause. In one session, four separate "we don't have that" assertions were all wrong: a log, two record entries, and a batch of scanned reports. Every one existed. The cause was not carelessness. It was that **hundreds of files sat in the inbox referenced by zero scripts and indexed in zero recall sources.** Artifacts with no canonical home and no index produce confident false negatives, which is the most expensive kind of wrong: it looks like an answer. ## The one rule that matters **The index is the point, not the tidy tree.** Moving a file to a prettier path fixes nothing on its own. What failed was RECALL. So: - Every artifact gets an `archive/INDEX.jsonl` row **even when it cannot be classified**. - `archive/unsorted/` is a first-class destination, not a failure state. - An indexed unsorted file is findable. A perfectly-filed unindexed file is not. If you ever have to choose between placing something correctly and indexing it at all, index it. ## Procedure ### 1. Dry run first, always ```bash python3 scripts/pipeline/file_intake.py --verbose ``` Dry run is the default and `--apply` is required to write anything. Read the subject and label distribution before applying. If the distribution looks wrong, the signatures are wrong; fix `SIGNATURES` / `OCR_SIGNATURES` in the script rather than hand-filing. ### 2. Apply ```bash python3 scripts/pipeline/file_intake.py --apply