From 10195841b3059c0892e78dc5656828e6ec9d36c2 Mon Sep 17 00:00:00 2001 From: Max Ghenis Date: Tue, 28 Oct 2025 21:26:52 -0400 Subject: [PATCH 1/3] Update blog-post-reviewer agent with interactive tools guidance MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Added documentation for external_url pattern used by interactive calculators and tools: - Optional external_url field for linking to app routes instead of markdown posts - Guidance on concise naming (prefer "calculator" over "comparison") - Best practice to avoid redundant location markers on country-specific sites - Example showing the two-child limit calculator pattern This codifies the pattern we established in PR #2783. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .claude/agents/blog-post-reviewer.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/.claude/agents/blog-post-reviewer.md b/.claude/agents/blog-post-reviewer.md index ab0165994..80c553eae 100644 --- a/.claude/agents/blog-post-reviewer.md +++ b/.claude/agents/blog-post-reviewer.md @@ -18,9 +18,11 @@ You review PolicyEngine blog posts to ensure they follow formatting standards, a - **Description length**: < 160 characters (fits in social previews) - **Post ordering**: New posts at beginning of array - **Required fields**: title, description, date, tags, authors, filename, image +- **Optional fields**: external_url (for interactive calculators/tools that link to app routes instead of markdown posts) - **Tags**: Must include country tag ("us" or "uk") plus content tags ("org", "policy", "ai", etc.) - **Date format**: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS - **Authors**: Array of author slugs (e.g., ["max-ghenis", "daphne-hansell"]) +- **Title style**: Avoid redundant location markers on country-specific sites (e.g., "Two-child limit calculator" not "UK two-child limit calculator" when appearing only on UK site) ### Markdown File Standards @@ -37,6 +39,32 @@ You review PolicyEngine blog posts to ensure they follow formatting standards, a - **In-post images**: Must exist in `public/images/posts/` (served at runtime via /images/posts/ URL) - **Format**: PNG or JPG, optimized for web +### Interactive Tools and Calculators + +For research tiles that link to interactive calculators or tools instead of markdown articles: + +- **Use external_url**: Add `"external_url": "/uk/calculator-route"` field to posts.json +- **Dummy filename**: Still provide filename (e.g., `"filename": "calculator-name-dummy.md"`) even though no markdown exists +- **Add comment**: Include `"_comment"` field explaining the external_url usage +- **Title naming**: Use concise names like "Two-child limit calculator" (avoid "policy comparison" or wordy descriptions) +- **Description**: Action-oriented, describing what users can explore/calculate/compare +- **Tags**: Include "interactives" tag plus country and content tags + +**Example**: +```json +{ + "_comment": "This post uses external_url to link to an interactive app instead of a markdown article. The filename is 'dummy' because no markdown file exists - it redirects directly to the app.", + "title": "Two-child limit calculator", + "description": "Explore policy reforms to the two-child benefit limit and their impacts on households, government spending, and child poverty.", + "date": "2025-10-28", + "tags": ["uk", "featured", "policy", "interactives"], + "filename": "uk-two-child-limit-comparison-dummy.md", + "external_url": "/uk/two-child-limit-comparison", + "image": "young-child-exemption-two-child-limit.jpg", + "authors": ["vahid-ahmadi"] +} +``` + ### Writing Style #### For Blog Posts (org, event, behind-the-scenes) From 6d98375d63b73c55ffda634df550f2a37802bc32 Mon Sep 17 00:00:00 2001 From: Max Ghenis Date: Tue, 28 Oct 2025 21:27:40 -0400 Subject: [PATCH 2/3] Add changelog entry for agent documentation update MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- changelog_entry.yaml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/changelog_entry.yaml b/changelog_entry.yaml index 184a6f098..ebeb57cab 100644 --- a/changelog_entry.yaml +++ b/changelog_entry.yaml @@ -1,4 +1,4 @@ -- bump: minor +- bump: patch changes: - added: - - UK two-child limit policy comparison dashboard as a featured tile on UK homepage + changed: + - Updated blog-post-reviewer agent documentation for interactive tools pattern From 7f5626828f47142093839dc1f3bc2ac51a68f40a Mon Sep 17 00:00:00 2001 From: Max Ghenis Date: Wed, 29 Oct 2025 08:40:48 -0400 Subject: [PATCH 3/3] Format blog-post-reviewer agent with prettier --- .claude/agents/blog-post-reviewer.md | 1 + 1 file changed, 1 insertion(+) diff --git a/.claude/agents/blog-post-reviewer.md b/.claude/agents/blog-post-reviewer.md index 80c553eae..39b17ba08 100644 --- a/.claude/agents/blog-post-reviewer.md +++ b/.claude/agents/blog-post-reviewer.md @@ -51,6 +51,7 @@ For research tiles that link to interactive calculators or tools instead of mark - **Tags**: Include "interactives" tag plus country and content tags **Example**: + ```json { "_comment": "This post uses external_url to link to an interactive app instead of a markdown article. The filename is 'dummy' because no markdown file exists - it redirects directly to the app.",