AI_AGENT_OS/docs/kci-processing-jobs/job-runbook-template.md

Job Name

Status: Draft

Purpose

What business or operational outcome does this job produce?

Owner

• Primary owner:
• Backup owner:
• Escalation contact:

Summary

Short explanation of what the job does in plain language.

Trigger

How does the job start?

• Scheduled task:
• SQL Agent job:
• Service:
• Script:
• Manual action:
• Application-triggered:
• Other:

Schedule

• Frequency:
• Expected start time:
• Expected duration:
• Time zone:
• Blackout windows:

Runtime Location

• Server/workstation:
• Application:
• Script path:
• Working directory:
• Account/context:

Do not document passwords or secrets.

Inputs

Input	Location	Format	Required	Notes
Unknown	Unknown	Unknown	Unknown	Unknown

Outputs

Output	Location	Format	Recipient/System	Notes
Unknown	Unknown	Unknown	Unknown	Unknown

Dependencies

• File shares:
• Databases:
• External systems:
• Printers:
• Email:
• Third-party tools:
• Permissions:
• Network access:

Processing Steps

Document the expected flow.

INPUT
   ↓
VALIDATION
   ↓
PROCESSING
   ↓
OUTPUT
   ↓
ARCHIVE / CLEANUP
   ↓
VERIFICATION

Success Criteria

How do we know the job worked?

• Expected files created:
• Expected records updated:
• Expected logs:
• Expected notifications:
• Expected downstream result:

Failure Modes

Failure	Symptom	Likely Cause	First Check	Escalation
Unknown	Unknown	Unknown	Unknown	Unknown

Troubleshooting

1. Check whether the job started.
2. Check the latest log.
3. Check input files exist and match expected naming/format.
4. Check permissions and file locks.
5. Check downstream/output location.
6. Check whether the job can be safely rerun.

Reprocessing Rules

• Can this job be rerun safely?
• What must be cleaned up before rerun?
• What files or records indicate a partial run?
• What duplicate risks exist?
• Who approves reprocessing?

Retention / Cleanup

• Input retention:
• Output retention:
• Archive location:
• Cleanup schedule:
• Backup requirements:

Security Notes

• Sensitive data handled:
• Access restrictions:
• Secrets/configuration location:
• Logging restrictions:

Do not include secrets in this runbook.

Change History

Date	Change	Author
YYYY-MM-DD	Initial draft	Unknown