Agent builds / AI agents

Agent build · v1

Site-first article and explainer agents

What it does: Two Claude Code agents that publish to your own site first: one writes a data-backed article per run, the other turns articles and projects into pages that each answer one searched question.

Model
Claude Opus (Claude Code background agents)
Runs in
Claude Code scheduled tasks + background agents
Cost per run
not measured
License
MIT
Used by
0
Files
7 (18 KB)
curl -L https://tensorust.com/builds/site-first-article-agents/download -o site-first-article-agents.zip

Receipts

Receipt
#674
This Week in Rust issue that featured the article agent's crates.io data piece
Source
https://this-week-in-rust.org/blog/2026/10/21/this-week-in-rust-674/
Measured
Oct 21, 2026
Check
Number found on the source page by our checker
Stamp
ZUIl8enHLWxfHuELNhLDQ85Hzc-h63Xs
Receipt
80%
share of 90 days of downloads on 69 Rust crates that arrived within a day of a new version, from the agent's own crates.io API pull
Source
https://tensorust.com/articles/crates-io-download-count/
Measured
Oct 17, 2026
Check
Number found on the source page by our checker
Stamp
W3nPiJOC2p9HAOdZLXUR8pjXD0CPjnXv

Files

README.mdraw
# Site-first article and explainer agents

Two Claude Code agents that publish to your own site first. The flagship article agent writes one data-backed article per run and sends only the strongest few a day to other platforms. The explainers agent turns those articles and your projects into short pages that each answer one searched question.

## Files
```
schedule.example.json          two scheduled jobs with their exact prompts and prechecks
agents/articles/ROLE.md        the flagship article playbook (topic scoring, data, publish order)
agents/articles/QUALITY.md     the checklist every article passes before publishing
agents/articles/SITE_PUBLISH.md  build, deploy, verify, IndexNow, canonicals, Search Console
agents/explainers/ROLE.md      the explainer and guide playbook
agents/explainers/QUEUE.example.md  the topic queue format
```

Both agents also expect the shared files from the outreach team build: posts.json (the action log), VOICE.md, NOTES.md per role, and a locks/ folder.

## Adapting it
- Replace the build and deploy commands in SITE_PUBLISH.md with your own site's.
- Pick your topic list and your offers.
- Keep the two-step precheck: the main session counts posts.json entries itself and only spawns an agent when there is room.

README

Two scheduled Claude Code agents that grow a site with search traffic in mind. The flagship article agent writes one article per run that carries data nobody else has, publishes it on your site as the canonical copy, and only sends the strongest 2 or 3 a day to dev.to, X and LinkedIn. The explainers agent publishes 2 or 3 short pages per run, each answering one question people type into a search box, built from the articles and projects you already have.

Why site first: on tensorust.com one data article (a fresh crates.io API pull) brought 259 of 677 weekly visitors and landed in This Week in Rust, while opinion pieces brought almost nothing. Search became the second biggest referrer. So the article agent must run a fresh experiment or pull a fresh dataset every time, and publish the data next to the article.

Layout:

schedule.example.json: both jobs, with the exact prompts. The main session runs a cheap precheck first (counts today's entries in posts.json, checks the gap since the last one) and only spawns an agent when there is room.
agents/articles/ROLE.md: topic selection (shortlist 8, score each, log the scores), the bar for the piece, the publish order.
agents/articles/QUALITY.md: the checklist every article passes before it publishes.
agents/articles/SITE_PUBLISH.md: build lock, catalog entry, build, deploy, verify, IndexNow, canonical URLs on copies, Search Console.
agents/explainers/ROLE.md and QUEUE.example.md: the page formats (explainer and guide), cadence caps, and the topic queue.

How to run it:

1. Set up the shared files from the outreach team build (posts.json, VOICE.md, a NOTES.md per role, a locks/ folder).
2. Replace the build and deploy commands in SITE_PUBLISH.md with your own. The original is a Python static build deployed with the Vercel CLI.
3. Create the two jobs in Claude Code from schedule.example.json.

What to change: your topics, your offers, your site commands, and the caps. Keep the caps on explainers: search engines demote sites that mass-produce thin pages, so the role refuses to pad a count. Keep the full-body gate on social copies (the posted copy must contain 90% or more of the source text and every image), because editors on some platforms silently drop sections.

The dev.to step needs an API key. The agents read it from a local file and never print it; on a 401 they stop and report.

0 comments

Log in to comment