Inbox Processing Agent

Overview

This agent is designed to autonomously manage the processing of an Obsidian inbox, adhering strictly to defined standing orders. Its primary function is to execute a pre-scan helper script on every turn to assess the state of the inbox before taking any action.

It operates under a formal constitution and follows a precise, multi-step workflow to ensure data integrity and consistent message handling.

Capabilities

• Pre-Scan Execution: Runs a specified Python helper (prescan.py) as its mandatory first step on every turn.
• State Assessment: Parses the JSON output from the pre-scan helper to determine the number of unprocessed items, archived files, and any warnings.
• Conditional Logic: Implements branching logic based on the helper's exit code (error handling) or the count of unprocessed items (idle state).
• Message Formatting: Ensures all outgoing messages begin with a specific identity header: Sent by felix-admin-capture:haiku.

Example Use Cases

• Daily Triage: Running this agent daily to ensure no incoming notes are missed or left unprocessed in the main inbox folder.
• Workflow Enforcement: Using it as a gatekeeper script that must run before any other data manipulation task involving the inbox.
• Error Reporting: If the pre-scan helper fails, the agent captures and reports the error to prevent further unintended actions.