The Curative Triad: separating planning from execution.

Most file organization tools do one thing: they act. You click a button, and your files are moved, renamed, or deleted. The logic may be sophisticated, even AI-powered, but the interaction model is the same — input flows directly to action.

FileMayor takes a different approach. It introduces a separation between understanding, planning, and execution.

explain → cure → apply

This is the Curative Triad.

Why separation matters

When software acts too quickly, it removes your ability to reason about its behavior. This is especially dangerous when dealing with large directories, mixed file types, and ambiguous naming conventions. You do not just want results. You want confidence.

Step 1 — explain

$ filemayor explain ~/Downloads

This step modifies nothing. It analyzes your files, categorizes them, and surfaces patterns — duplicates, large files, misplacements. The goal is simple: make the state of your filesystem legible.

Step 2 — cure

$ filemayor cure ~/Downloads

Now FileMayor proposes a plan: where files should go, how they should be grouped, what should be removed or deduplicated. Nothing is applied yet. You are looking at a draft of the future state. This is the critical step most tools skip.

Step 3 — apply

$ filemayor apply

Only now does FileMayor act. And when it does, every change is tracked, every operation is reversible, the system remains observable.

Planning vs execution

The Triad enforces a boundary:

• Planning can be complex, exploratory, even probabilistic.
• Execution must be deterministic, safe, and reversible.

By separating the two, FileMayor avoids a common failure mode of AI tools: confident decisions applied without visibility or control.

Psychological safety

There is a subtle effect here. When you know that nothing happens without your approval, every step is visible, and every action can be undone, you are more willing to run the tool on important directories, experiment with strategies, and trust the system over time.

The deeper idea

The Curative Triad is not just a feature. It is a pattern. It can be applied to infrastructure changes, database migrations, any system where actions are costly or irreversible.

Understand first. Plan second. Act last.

File organization is not just about moving files. It is about making decisions on your behalf. The Triad ensures those decisions are visible, reviewable, controlled. And that makes all the difference.