reachableceo/ResumeCustomizer
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
d7682ee87ddb7a575e621a64e0864353f20dae4d
ResumeCustomizer/output/AGENTS.md

1.4 KiB
Raw Blame History

Output Agent Guide

Scope

The output/ tree houses the delivery pipeline that watches for approved Markdown resumes, converts them to DOCX/PDF using Pandoc, and archives the source material. It is intended to run independently from the input/ authoring workflow.

Key Components

  • ForRelease/inbox: manually populated with a single vetted .md resume for conversion.
  • ForRelease/outbox: timestamped folders containing generated DOCX/PDF pairs ready for sharing.
  • ForRelease/processed: timestamped archives of Markdown files that converted successfully.
  • ForRelease/failed: Markdown originals for conversion attempts that Pandoc could not render.
  • Docker/: container definition, watcher script, and wrapper to run the stack without root-owned outputs.

Operational Rules

  • Always launch the service with Docker/run-output-processor.sh so the container inherits the caller’s UID/GID.
  • Before testing, ensure ForRelease/inbox is empty; this watcher expects at most one Markdown file at a time.
  • Monitor logs via ./run-output-processor.sh logs -f while converting to confirm the Markdown leaves inbox and the exports appear in outbox.
  • If Pandoc fails, the Markdown moves to ForRelease/failed; fix the content there, then move it back to inbox for another run.
  • Only remove history from outbox/ or processed/ after you are certain the artifacts are no longer needed.