---
name: writing-blog-posts
description:
  Write blog posts sharing knowledge about the project. Use when writing blog posts, capturing knowledge, or adding to
  the project knowledge base.
argument-hint: "<topic>"
allowed-tools: Read, Write, Glob, Grep
---

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.