Blog: Post Workflow Detail

Level 3 (Detail) — Writing flow, translation rules, image processing.

Concept

Blog articles are created through a structured 5-phase workflow defined in AGENTS.ctx/blog-writer/CONTEXT.md. The workflow separates planning, writing, review, translation, and publication.

Writing Phases

Phase 1: Planning

Before writing, the agent gathers:

  • Article type (which prompt file applies)
  • Article length (lungo/medio/piccolo)
  • Topic, title proposals, key points
  • Source material (memory, chronicle, context)
  • Attribution

Phase 2: Writing (Italian)

The agent reads the selected prompt file from AGENTS.ctx/blog-writer/assets/ and writes the Italian version as content/posts/<slug>/index.it.md.

Phase 3: Review

User reviews the Italian article and requests changes until satisfied.

Phase 4: Translation (English)

The agent reads translation rules from AGENTS.ctx/blog-writer/assets/article-translation.md and creates the English index.md. Rules include:

  • Absolute fidelity (no additions, no omissions)
  • No translation of code blocks, commands, YAML, file paths
  • Standard industry terminology for technical terms
  • Same serious, reflective tone

Phase 5: Publish

  • git add, git commit, git push to blog-src master
  • GitHub Action builds and publishes Docker image
  • Flux detects the new tag and rolls out in cluster

Prompt Files

File: AGENTS.ctx/blog-writer/assets/

FilePurpose
prompt-blog-post.mdTechnical chronicle (DevOps diary) — default
vision-roadmap-prompt.mdMedium-term strategy and projects
perspective-thoughts-prompt.mdOpinion pieces and critical analysis
article-translation.mdIT → EN translation rules

Image Processing

File: AGENTS.ctx/blog-writer/assets/process-blog-image.sh

bash assets/process-blog-image.sh <path/to/featured.png>

Converts PNG → JPG (85% quality) and resizes to max 600×600. Deletes the original PNG.

Requires ImageMagick (sudo apt install imagemagick).

See Also