filing

Solid

Give received artifacts a canonical home AND an index entry so recall can reach them. Intake, placement, indexing. Not a filesystem beautification pass.

AI & Automation 2 stars 0 forks Updated 3 days ago MIT

Install

View on GitHub

Quality Score: 78/100

Stars 20%
16
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# 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 ...

Details

Author
0xUrsanomics
Repository
0xUrsanomics/utopia-os
Created
4 days ago
Last Updated
3 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

artifact-lint

Scans a project's generated-artifact surface (08-Generated/ + promoted folders) and runs five graph-integrity checks — orphan, sibling duplicate, stale draft, displaced content, version chain — reading the horizontal-lineage frontmatter (parent_artifact / sibling_topic / supersedes) so duplicate, orphaned, stale, or displaced generated content is surfaced for operator approval instead of silently accumulating. Read-and-recommend only — no automatic file moves or deletes. Triggers: "lint the generated artifacts", "check 08-Generated for duplicates", "scan for orphaned artifacts", "find stale drafts", "run artifact lint", "are there duplicate generated artifacts", "check the artifact lineage graph", "version-chain check the generated folder."

0 Updated today
cody-hutson
AI & Automation Listed

ai-agents-failure-archaeology

The chronicle of this repo's settled battles. Maps each major incident to symptom, root cause, evidence path, and the artifact that fixed it, so nobody re-fights a decided question. Use when you say `has this failed before`, `why does this rule exist`, `failure archaeology`, `what happened with issue 2205`. Do NOT use for triaging a live failure (use `ai-agents-debugging-playbook`) or for extracting learnings from the current session (use `retrospective`).

38 Updated today
rjmurillo
AI & Automation Listed

pattern-retrospective

Apply rigorous pattern-retrospective analysis to Claude transcripts. Triggers on writing studies, blog posts, handoff docs, retrospectives, specs, or improvement proposals that draw conclusions from past Claude sessions — phrasings like "handoff to X", "lessons from session Y", "pattern Z over time", "spec for X", "improvements to X", "audit my use of W" all match. Enforces target-system audit BEFORE specifying its requirements, streaming JSONL parsing (never load whole files), 5-tuple extraction with provenance tags, self-falsification of every cited claim including system-state claims, Bayesian confidence smoothing, and correlation-not-causation discipline. Designed to prevent the credulous-handoff failure mode where ~60% of proposed requirements turn out to already exist in the target system.

0 Updated today
BryceEWatson