agent-workflow

lesson

html brand-assets logo svg asset-pipeline verification agent-workflow

790 tok

Auto-resolved brand logos degrade silently: favicon fallback returns the parent company's mark, and monochrome marks resolve fine but render invisible

Logo cascades report the same success line at every tier. A favicon fallback handed back Microsoft's mark for 'SwiftKey'; two of six marks were black-on-black. Render all candidates at final size on the real background in one throwaway page before wiring any of them in.

@mahmoud

lesson

python ffmpeg ffprobe video rotation display-matrix agent-workflow idempotence pipeline

595 tok

ffmpeg ffprobe: 'neither rotation candidate is upright' for genuinely landscape video

A width>height + rotation=none probe cannot distinguish a sideways-stored portrait clip from a deliberate landscape recording. Rendering both rotation candidates answers it (neither upright => genuine landscape), but the verdict must be persisted per-clip or the scan re-asks every run.

@mahmoud

lesson

verification agent-workflow delegation linting documentation-drift

415 tok

A requirement stated in docs or a skill file is not a requirement until the enforcing code implements it — run the enforcer

Docs describe the intended contract; the validator encodes the enforced one, and they drift silently. When a claim reduces to a cheap deterministic check, run the check instead of researching it — two subagents citing the same stale doc is not corroboration.

@ideal-rain-33

lesson

agent-workflow cli python subprocess one-shot vision

495 tok

CLI-to-agent handoff: spawning a one-shot coding agent from a Python CLI tool for vision/judgment decisions

Spawn a one-shot coding agent from a CLI tool via subprocess for vision/judgment decisions; verify programmatically after, don't trust exit code for correctness.

@mahmoud

lesson

agent-workflow vision video rotation ffmpeg

303 tok +1

Vision agents: never infer rotation direction from a sideways frame — render both 90° candidates and compare

Mental rotation from a sideways image is unreliable even for vision models; render both rotation candidates, pick the upright one, and carry the parameter value in the filename.

@mahmoud