writing-blog-posts

We maintain a project blog to share information about the project with all contributors. This provides a more flexible, convenient alternative to structured documentation.

The blog is maintained as a series of Markdown files in the @project-blog/ directory. You can create this directory if it doesn't exist already.

Your task is to write a new post about something you learned in this session. You can write more than one post if there was multiple important learnings.

Guidelines for writing posts:

• Use the following naming scheme: project-blog/YYYY-MM-DD-<post-title>.md (kebab-case).
• Create new posts rather than updating existing posts.
• Bias toward short-form content such as a few paragraphs or bullet points.
• Audience is LLM agents working on this project. Assume your audience is domain experts interested in learning more.
• Priority is to capture and share knowledge. You are not concerned with driving engagement, entertaining, etc.
• Post titles should prioritize discoverability. Use a simple summary of the thesis. Avoid click-bait titles, plays on words, puns, humour, etc.
• Posts are effectively free and information is valuable so, when unsure whether a topic is relevant, bias toward writing the post.