AI_AGENT_OS/docs/kci-processing-jobs

KCI Processing Jobs Documentation

This folder documents KCI jobs and processes used to process files, PDFs, imports, exports, scheduled work, cleanup tasks, and related operational workflows.

The goal is to make each job understandable, supportable, verifiable, and safer to change.

Start Here

• Job Inventory
• Job Runbook Template
• File Processing Conventions
• Troubleshooting Guide

Job Runbooks

• Mail Manager
• Purple Envelope

Documentation Rules

• Do not store passwords, credentials, private keys, connection strings, or sensitive customer data in these files.
• Mark unknowns clearly instead of guessing.
• Separate environment-specific details when production, test, and local behavior differ.
• For every job, define how success is verified.
• For file-processing jobs, document input locations, output locations, naming conventions, retention, and reprocessing rules.

Suggested Documentation Flow

1. Add the job to Job Inventory.
2. Copy Job Runbook Template into jobs/<job-name>.md.
3. Fill in verified facts first.
4. Mark unresolved items as Unknown.
5. Review security notes before committing.
6. Have someone familiar with the job validate the runbook.