Flow: Job Packaging
This doc contains the step-by-step flow. For inputs, tools, outputs, and safety, see /.system/skills/ssot/repo/scaffolding/devops-packaging-job/SKILL.md.
Step-by-Step Flow (AI + Human)
Step 1: Collect Parameters (AI -> Human)
AI asks human for:
- •Job name for the image
- •Which module to package
- •Job entrypoint (script or command)
- •Optional: schedule, timeout, retry policy
Human checkpoint: Confirm parameters before proceeding.
Step 2: Validate Inputs (AI)
AI validates:
- •Module exists and has source code
- •Job name follows naming conventions
- •Entrypoint file exists
Step 3: Preview Changes (AI)
AI runs orchestrator with --dry-run:
bash
python scripts/devops/scaffold/devops_packaging_job.py --job-name "<job_name>" --module-id "<module_id>" --entrypoint "src/jobs/main.py" --dry-run
AI presents planned_changes to human.
Human checkpoint: Review and approve planned changes.
Step 4: Execute Scaffold (AI)
AI runs orchestrator without --dry-run:
bash
python scripts/devops/scaffold/devops_packaging_job.py --job-name "<job_name>" --module-id "<module_id>" --entrypoint "src/jobs/main.py"
Step 5: Review Generated Files (AI + Human)
AI presents generated files for review:
- •Dockerfile
- •Run script
- •Job configuration
Human checkpoint: Review generated files and customize if needed.
Step 6: Record in Workdocs (AI)
AI records scaffold execution in /ops/packaging/workdocs/:
- •Job name and module
- •Configuration decisions
- •Follow-up tasks (build, push, schedule)