Reward-Generation Gap Blog Implementation Plan
Reward-Generation Gap Blog Implementation Plan
For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (
- [ ]) syntax for tracking.
Goal: Publish an accessible long-form publication page for the POET paper with supporting figures extracted from the arXiv source assets.
Architecture: Reuse the existing publication permalink file for this paper, add locally hosted image assets under /images/poet/, and structure the article to mirror the existing SAGO publication blog style. Keep the implementation content-only with no theme changes.
Tech Stack: Jekyll markdown, static images, existing publication collection layout
Task 1: Prepare static assets and planning docs
Files:
- Create:
docs/superpowers/specs/2026-04-20-reward-generation-gap-blog-design.md - Create:
docs/superpowers/plans/2026-04-20-reward-generation-gap-blog.md - Create:
images/poet/intro_issue.png - Create:
images/poet/delta_means.png Create:
images/poet/prefix_quality.png- Step 1: Confirm the arXiv source figures to extract
Use the extracted source tree under /tmp/poet-src/extracted/figures/ and select:
intro_issue.pdfdelta_means.pdfprefix_quality.pdf- Step 2: Convert the PDF figures into PNG assets
Run:
mkdir -p images/poet
pdftoppm -png /tmp/poet-src/extracted/figures/intro_issue.pdf images/poet/intro_issue
pdftoppm -png /tmp/poet-src/extracted/figures/delta_means.pdf images/poet/delta_means
pdftoppm -png /tmp/poet-src/extracted/figures/prefix_quality.pdf images/poet/prefix_quality
mv images/poet/intro_issue-1.png images/poet/intro_issue.png
mv images/poet/delta_means-1.png images/poet/delta_means.png
mv images/poet/prefix_quality-1.png images/poet/prefix_quality.png
Expected: three PNG files exist in images/poet/.
- Step 3: Verify the images were created
Run:
ls -l images/poet
Expected: the three PNG files are listed with non-zero sizes.
Task 2: Write the publication-page blog
Files:
Modify:
_publications/2025-06-14-scalable-oversight.mdStep 1: Replace the minimal placeholder body with the long-form article
Write sections for:
- opening overview
- problem framing
- key insight
- POET method
- results
- dataset-quality condition
- takeaway
- citation
Include figure blocks that reference:
/images/poet/intro_issue.png/images/poet/delta_means.png/images/poet/prefix_quality.png- Step 2: Keep the tone aligned with the SAGO post
Ensure the final copy:
- is accessible to a general ML audience
- uses intuition-first explanations
- keeps formulas to zero or near-zero
- uses compact tables only where they clarify key numbers
Task 3: Verify rendering and content integrity
Files:
- Verify:
_publications/2025-06-14-scalable-oversight.md - Verify:
images/poet/intro_issue.png - Verify:
images/poet/delta_means.png Verify:
images/poet/prefix_quality.png- Step 1: Run a local Jekyll build
Run:
bundle exec jekyll build
Expected: build completes successfully with the publication page rendered into _site/.
- Step 2: If Jekyll is unavailable, run a syntax-level fallback check
Run:
ruby -e 'require "yaml"; puts YAML.load_file("_publications/2025-06-14-scalable-oversight.md").fetch("title")'
Expected: prints the publication title without YAML parsing errors.
- Step 3: Inspect the final markdown for structure
Run:
rg -n "^## |^<figure>|^```bibtex" _publications/2025-06-14-scalable-oversight.md
Expected: the main sections, figures, and citation block are present.
