neat-freak

Start ARIS autonomous rounds from compact live-state artifacts and reconcile TODO and job manifests.

Updated May 20, 2026
One-click install
npx skills add https://github.com/lightrain-a/medtrace-aris --skill neat-freak-lightrain-a
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neat-freak
Source: https://github.com/lightrain-a/medtrace-aris/tree/main/.codex/skills/neat-freak
Command: npx skills add https://github.com/lightrain-a/medtrace-aris --skill neat-freak-lightrain-a

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents ARIS from repeatedly rereading long research artifacts by re-centering execution on compact, current state files while keeping task execution synchronized across rounds.

Core Features & Use Cases

  • Fast-Start Read Order: Prioritizes execution snapshot, TODO queue, remote GPU job manifest, supervisor state, and referenced progress files to answer the next action quickly.
  • On-Demand Long Reads: Loads large documents only when the next action requires clarification on scope, method/claim logic, literature/novelty changes, or paper-facing edits.
  • State Contract & Round Hygiene: Defines clear “single source of truth” files and update requirements for snapshot, TODO, status logs, and remote job provenance after substantive rounds.
  • Job Running Guardrails: Enforces evidence-based “running” detection, prevents duplicate launches into shared output directories, and marks stale-progress jobs as BLOCKED/VERIFY.
  • Use Case: When an ARIS executor is continuing research work or handing off between autonomous rounds, it uses this skill to reconcile status/TODO, update provenance, and resume with minimal I/O.

Quick Start

Use the neat-freak skill to resume the next ARIS autonomous round by reading the execution snapshot and TODO queue first, then executing the highest-priority concrete task and updating the snapshot, TODO, status, and remote job manifest.

Frequently Asked Questions about neat-freak

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

FAQPage Schema
How do I start autonomous rounds from live state without rereading long research documents?

Start autonomous rounds from live state by reading the execution snapshot and TODO queue first, loading large documents only when scope clarification or paper-facing edits are needed. This prioritizes compact state files to answer the next action quickly.

What is execution state synchronization for remote GPU jobs in ongoing experiments?

Execution state synchronization tracks remote GPU jobs using a defined read order across execution snapshots, TODO queues, and job manifests. It enforces evidence-based running detection and prevents duplicate launches into shared output directories.

How do I reconcile progress and status logs between autonomous research rounds?

Reconcile progress between autonomous rounds by applying strict update rules to snapshot, TODO, status logs, and remote job provenance after substantive work. This ensures the next round resumes with minimal I/O and accurate state.

How do I prevent duplicate launches into shared output directories for remote GPU jobs?

Prevent duplicate launches by enforcing job running guardrails that require evidence-based running detection. The skill checks the remote GPU job manifest and marks stale-progress jobs as BLOCKED or VERIFY before authorizing new launches.

When do I need to load full research documents instead of compact state files?

Load full research documents on demand when the next action requires clarification on scope, method or claim logic, literature and novelty changes, or paper-facing edits. Compact state files handle routine execution and status updates without long reads.

Can I use compact state files for experiment handoff cleanup and status reconciliation?

Use compact state files for experiment handoff cleanup and status reconciliation by defining a single source of truth for snapshots, TODO queues, and status logs. Update provenance after substantive rounds to maintain document hygiene.