arrow_back Back to Catalog
workflows Beginner

Workflow /inbox

Categorize files from _inbox/ into their permanent PARA locations with smart project context awareness.

The /inbox workflow automatically categorizes incoming files from the _inbox/ directory into their permanent locations within the PARA structure. It acts as a smart file router.

Commands Overview

/inbox                    # Review and categorize all files in _inbox/
/inbox [filename]         # Categorize a specific file

Categorization Flow

Scan inbox → Classify file type → Check project context → Move to target → Report

1. Scan Inbox

Lists all files currently in _inbox/ for processing.

2. Categorization Logic

The agent classifies files based on type and content indicators:

CategoryIndicatorsTarget Directory
Code Templates.tsx, .jsx, .vueResources/references/code/components/
Logic Snippets.ts, .js, .pyResources/references/code/snippets/
Design Patterns.md regarding designResources/references/code/patterns/
IntegrationsAPI/Webhook codeResources/references/code/integrations/
Research/Tutorials.md how-to guidesResources/references/articles/tutorials/
Project Assets[p]-logo.png, .csvProjects/[name]/artifacts/assets/
LearningNotes, best practicesAreas/Learning/

2.5. Project Context Check

Before moving files to any project directory, the agent reads the project’s existing structure first.

If the target is a Projects/[name]/ directory:

  1. Reads the project’s docs/README.md to understand layout
  2. Lists top-level folder structure
  3. Matches the file to an existing folder — does NOT create new directories without confirmation

3. Move File

  1. Duplicate check — If target file exists, appends _YYYYMMDD timestamp
  2. Directory creation — Ensures target directory exists (known paths only)
  3. Move and report — Moves the file and confirms the action

Notes

  • Large files (>10MB): Asks for confirmation before moving
  • Unidentified files: Stays in _inbox/ — agent asks for clarification
  • Files moved to Projects/ must match an active project

→ Workflow /learn — Package lessons into Areas/Learning → Workflow /para — Master workspace controller