Sessions To Blog

Overview

sessions/articles

Workflow

1. Resolve project standards and output location
   • Find the project's MDX article standards and output location (check repo docs, AGENTS, README, or content guidelines).
   • If standards or location are not found, ask the user before drafting.
2. Clarify scope and output
   • Ask for date range, audience, and desired length if not provided.
   • Use the language of the user's prompts in the logs; confirm if mixed or unclear.
3. Gather source entries
   • Read the relevant

     sessions/articles/YYYY-MM-DD.md

     blocks for the selected dates.
   • Extract: intent, actions, artifacts, decisions, progress, open questions, and any file paths.
4. Plan the post
   • Build a short outline using the template in

     references/examples.md

     .
   • Select 3 to 7 key highlights; prioritize user intent and outcomes.
5. Draft in the defined style
   • Follow

     references/style-and-structure.md

     .
   • Keep facts grounded in the logs; mark uncertainty explicitly.
6. Apply internal linking rules
   • Follow

     references/linking-rules.md

     for links to source logs, files, and related posts.
7. QA pass
   • Check for missing sources, broken links, and inconsistent tense.
   • Ensure the post is readable without the raw logs.

References

• references/style-and-structure.md

  for voice, tone, structure, and language rules.

• references/linking-rules.md

  for internal links and citation conventions.

• references/examples.md

  for input and output examples and a lightweight template.