Reviews

Stored outputs from review skills (pessimistic, optimistic, deep-review). Reference material for tracking improvement history — not published content.

This folder holds stored outputs from the framework’s review skills. These are internal reference documents, not published content.

What Reviews Are

The automation loop runs several review skills on a cycle:

• /pessimistic-review — finds logical gaps, unsupported claims, and strong counterarguments
• /optimistic-review — identifies strengths and opportunities for expansion
• /deep-review — comprehensive single-document analysis combining both lenses with suggested improvements

When a review is saved here, it creates a historical record that helps track how articles improve over time.

When Reviews Are Saved

Not all reviews are saved to this folder. The skill’s output is used to:

1. Generate refine-draft tasks in todo.md (the primary purpose)
2. Update the article’s last_deep_review frontmatter timestamp
3. Optionally save the full review text here for reference

Saving the full review is most useful for significant articles where improvement history matters.

Format

reviews/
  YYYY-MM-DD-[article-slug]-[review-type].md

Each review file includes the original review output, the article version it reviewed, and any follow-up tasks generated.

See Also

• How to Use This Framework — full automation documentation
• Task Queue — where review findings become action items