codebase-inode-audit

Audit ML experiment codebases for inode-heavy file patterns before scale-up runs.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/dongzhuoyao/deepresearch --skill codebase-inode-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-inode-audit
Source: https://github.com/dongzhuoyao/deepresearch/tree/main/.codex/skills/codebase-inode-audit
Command: npx skills add https://github.com/dongzhuoyao/deepresearch --skill codebase-inode-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Parallel filesystems used by HPC and ML training clusters have strict inode quotas, and unoptimized experiment code that writes millions of small files (such as per-sample images, per-epoch artifacts, or unbounded Slurm logs) can exhaust these quotas mid-run, causing costly job failures and wasted compute resources.

Core Features & Use Cases

  • High-Risk Pattern Detection: Identifies common inode-heavy code patterns including per-sample image/latent dumps, per-epoch artifact directories, uncurated Hydra multirun output trees, and unbounded Slurm log storage.
  • Quantitative Inode Pressure Estimation: Calculates projected total file counts for each risky output surface to measure potential inode usage against backend quotas.
  • Readiness Gate Enforcement: Blocks progression to dryrun and fullrun stages if projected file counts exceed 80% of the target backend's inode quota, and mandates implementation of inode-safe fixes such as tar sharding, delete-after-score workflows, or output directory pinning.
  • Real-World Use Case: Before launching a large-scale image generation training run on the LUMI supercomputer, run this audit to catch a pattern where the code writes one PNG per generated sample per evaluation step, which would produce 2 million files and exhaust the project's inode budget.

Quick Start

Use the codebase-inode-audit skill to scan your ML experiment codebase for inode risks before running a scale-up dryrun or fullrun.

Frequently Asked Questions about codebase-inode-audit

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

FAQPage Schema
Why do my HPC training jobs fail due to parallel filesystem inode quota exhaustion?

Unoptimized ML experiment code writes millions of small files, such as per-sample images or unbounded Slurm logs, which exhaust strict parallel filesystem inode quotas and cause costly job failures. An inode audit identifies these patterns before scale-up runs.

How do I audit my ML codebase for inode pressure before a scale-up dryrun?

To perform an inode audit, scan your ML experiment codebase for high-risk small file patterns like per-epoch artifact directories or Hydra multirun output trees, then estimate projected total file counts against target backend quotas to enforce pre-dryrun readiness gates.

What is the best way to prevent inode quota crashes on LUMI or Snellius during ML scale-up?

The best way to prevent inode quota crashes is integrating code-level inode risk assessment into pre-fullrun validation workflows, which blocks progression if projected file counts exceed 80% of the target backend's quota and mandates fixes like tar sharding.

Can I use an inode audit to measure projected file counts for uncurated Hydra multirun outputs?

Yes, an inode audit quantitatively estimates projected total file counts for risky output surfaces like uncurated Hydra multirun output trees, measuring potential inode usage against HPC backend quotas before launching scale-up experiments.

Does this inode audit work with training pipelines running on RunPod?

Yes, this inode audit applies to pre-dryrun and pre-fullrun validation workflows for ML training pipelines running on backends including RunPod, LUMI, and Snellius, ensuring repeatable code-level inode risk assessment across different HPC environments.

What are common high-risk inode patterns in ML experiment codebases?

Common high-risk inode patterns include per-sample image or latent dumps, per-epoch artifact directories, uncurated Hydra multirun output trees, and unbounded Slurm log storage, all of which generate excessive small files on parallel filesystems during scale-up runs.