Sessions To Blog

Overview

Create publishable MDX blog posts from sessions/articles session logs with consistent voice, structure, and internal links, aligned to project standards.

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.