seedproject-web/agents/agents.json
Carlos Arias 2c969c0753 feat: content-pipeline/ → agents/ — formalize the agent system in the seed
Adopt the agents/ architecture proven on medellin.co (reference impl):

- Move the content engine to a top-level agents/ dir: orchestrators, prompts,
  config, run.sh, admin console, shared libs. All content-pipeline literals
  repointed (config paths, scripts, admin, LLM-facing prompts/image.md string,
  configure.mjs, new-site.sh, astroagent tokenFile, .gitignore runtime block).
- Every script carries a parseable @agent-manifest header: name, title, class
  (content|operational|runtime|plumbing), trigger, model, prompts, skills (MCP),
  tools, reads/writes tables. 5 content agents + 3 plumbing scripts.
- New agents/catalog.mjs generates the catalog from the headers:
  agents/AGENTS.md (human, grouped by class) + agents/agents.json (machine
  manifest — a clone diffs it against a source to find missing tools/tables/MCP
  before running). configure.mjs regenerates the catalog on every identity
  stamp. No DB table, no watcher.
- config.json gains paths.stateDir/newsDir; publish-tick, write-daily, and
  news-radar read them instead of hardcoding.
- Full cut: content-pipeline/ deleted (the seed has no live crons, so no
  hybrid period needed). Docs updated (AGENTS.md structure + pipeline section,
  README paths).

Clones migrating from content-pipeline/: see medellin.co's
.memory/handoffs/agents-directory-migration.md for the cutover playbook
(one cron set active at a time; migrate drafts/state after repointing cron).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FMQeUnUrAeexcZ7P2Hxa6G
2026-07-11 17:09:15 -05:00

153 lines
4.4 KiB
JSON

{
"agents": [
{
"file": "agents/scripts/approve.mjs",
"name": "approve",
"title": "Draft Approver",
"class": "plumbing",
"trigger": "manual <slug> [--force]",
"description": "Approve a draft: SEO gate, then promote it into the blog, build, go live. No LLM.",
"model": "-",
"prompt": [],
"skills": [],
"tools": [
"lib/publish.mjs"
],
"reads": [],
"writes": [],
"created": "2026-07-04"
},
{
"file": "agents/scripts/list-drafts.mjs",
"name": "list-drafts",
"title": "Draft Lister",
"class": "plumbing",
"trigger": "manual",
"description": "List pending drafts awaiting review. No LLM.",
"model": "-",
"prompt": [],
"skills": [],
"tools": [],
"reads": [],
"writes": [],
"created": "2026-07-04"
},
{
"file": "agents/scripts/news-radar.mjs",
"name": "news-radar",
"title": "News Radar",
"class": "content",
"trigger": "manual / cron-capable (maintains news-queue.json for the writer)",
"description": "Discover timely niche news and maintain news-queue.json; the daily writer drains it first.",
"model": "research=claude-opus-4-8",
"prompt": [
"prompts/news-radar.system.md"
],
"skills": [],
"tools": [
"lib/claude.mjs"
],
"reads": [],
"writes": [],
"created": "2026-07-04"
},
{
"file": "agents/scripts/publish-tick.mjs",
"name": "publish-tick",
"title": "Auto-Publisher Tick",
"class": "plumbing",
"trigger": "cron:run.sh publish-tick.mjs(15m)",
"description": "Once per day after the morning floor, publish ONE eligible draft (SEO-gated) with a randomized earlier-today timestamp. No LLM.",
"model": "-",
"prompt": [],
"skills": [],
"tools": [
"lib/publish.mjs"
],
"reads": [],
"writes": [],
"created": "2026-07-04"
},
{
"file": "agents/scripts/research.mjs",
"name": "research",
"title": "Editorial Calendar Researcher",
"class": "content",
"trigger": "manual (auto-invoked by writer when the evergreen backlog runs low)",
"description": "Top up the evergreen backlog in calendar.json (additive, deduped); timely news is the news radar's job.",
"model": "research=claude-opus-4-8",
"prompt": [
"prompts/research.system.md"
],
"skills": [],
"tools": [
"lib/claude.mjs",
"lib/calendar.mjs"
],
"reads": [],
"writes": [],
"created": "2026-07-04"
},
{
"file": "agents/scripts/revise.mjs",
"name": "reviser",
"title": "Draft Reviser",
"class": "content",
"trigger": "manual <slug> (auto-invoked when the SEO gate fails and autoRevise is on)",
"description": "Feed the SEO audit's fixes back to the writer and re-audit until the draft passes or attempts run out.",
"model": "writer=claude-sonnet-4-6",
"prompt": [
"prompts/reviser.system.md"
],
"skills": [],
"tools": [
"lib/claude.mjs"
],
"reads": [],
"writes": [],
"created": "2026-07-04"
},
{
"file": "agents/scripts/seo-review.mjs",
"name": "seo-review",
"title": "SEO Reviewer",
"class": "content",
"trigger": "manual <slug> (auto-invoked by writer/approve gates)",
"description": "Audit one article for EEAT / spam-policy / on-page SEO / AEO / readability → seo-review.json.",
"model": "reviewer=claude-opus-4-8",
"prompt": [
"prompts/seo-review.system.md"
],
"skills": [],
"tools": [
"lib/claude.mjs"
],
"reads": [],
"writes": [],
"created": "2026-07-04"
},
{
"file": "agents/scripts/write-daily.mjs",
"name": "writer",
"title": "Daily Blog Writer",
"class": "content",
"trigger": "cron:run.sh write-daily.mjs(daily)",
"description": "Draft one article (MDX + cover + sources) — today's news first, else next evergreen calendar topic.",
"model": "writer=claude-sonnet-4-6",
"prompt": [
"prompts/writer.system.md",
"prompts/image.md"
],
"skills": [
"mcp__claude_ai_Higgsfield"
],
"tools": [
"lib/claude.mjs",
"lib/calendar.mjs"
],
"reads": [],
"writes": [],
"created": "2026-07-04"
}
]
}