Sprint 56f: Human-readable file naming - Chapter_N_draft/review_a/b/c/final

2026-03-22 18:57:33 -04:00
parent d8b566e7c4
commit 177acdfa35
21 changed files with 940 additions and 64 deletions
--- a/templates/blog_series_outline.yml
+++ b/templates/blog_series_outline.yml
@@ -0,0 +1,118 @@
+name: blog_series_outline
+description: "Plan a blog series — generate a numbered multi-post outline with title, brief, and keywords per post."
+debug: true
+system: agent_prompt
+
+agent_prompt:
+  - "= identity.md"
+  - "agent.rag.json"
+
+sections:
+  - agent
+  - project
+  - rag
+  - deliverables
+  - message
+  - instructions
+
+steps:
+  - type: think
+    hint: |
+      You are planning a blog series for the project described above.
+
+      Read the project description and current message to understand:
+        - SERIES TOPIC: What is the overall theme or subject?
+        - TARGET READER: Who is this series for? What is their experience level?
+        - VOICE: What tone should the posts use? (e.g., conversational, authoritative, peer-to-peer)
+        - POST COUNT: How many posts? (default to 10 if not specified)
+        - POST LENGTH: Target word count per post? (default to 800-1200 if not specified)
+
+      First, organize the series into 3-5 thematic clusters. Each cluster covers one
+      dimension of the topic. This ensures the series doesn't repeat itself and builds
+      progressively.
+
+      Think through:
+        - What does a beginner need to know first?
+        - What intermediate topics will add depth?
+        - What advanced or nuanced topics complete the picture?
+        - What "quick win" or highly shareable posts should be included?
+
+      Output a CLUSTER PLAN:
+        Cluster A: [Name]
+          - [3-4 post ideas that belong here]
+        Cluster B: [Name]
+          ...
+
+      Stop here — the numbered outline comes in the next step.
+
+  - type: think
+    model: power
+    hint: |
+      Using the cluster plan above, write the COMPLETE numbered outline.
+
+      For each post, output exactly this format on ONE LINE:
+        N. [Post Title] — [2-3 sentence brief covering what the post does]. Keywords: [kw1, kw2, kw3]
+
+      Rules:
+        - Titles must be specific and curiosity-driven (not "Introduction to X" — instead "Why X breaks and how to fix it")
+        - Briefs must be 2-3 sentences describing the actual content (not the title restated)
+        - 3 keywords per post: 1 primary, 2 supporting (naturally integrated, not stuffed)
+        - Number sequentially from 1 to N
+        - Posts should build logically — early posts don't assume knowledge from later posts
+        - Vary post types: how-to, analysis, checklist, case study, opinion, beginner explainer
+        - At least 2 posts should be "highly shareable" (strong opinion, surprising finding, or practical quick-win)
+
+      Output ONLY the numbered list. No prose, no cluster headings, no commentary.
+
+  - type: document
+    filename: "{{task_name_slug}}-outline"
+
+  - type: package
+    packet_type: IntakeResponse
+    hint: |
+      Convert every post from the numbered blog outline above into a create_task action.
+
+      RULES:
+      - One action per post, in order
+      - task_name: "Write Post N: [Post Title]" where N is the exact post number from the outline
+      - agent_name: "Iris"
+      - task_type: "blog_write"
+      - description: Start with the post title, then the 2-3 sentence brief, then "Keywords: [keywords]"
+        Full format:
+          "[Post Title]
+
+          [Full brief from the outline — 2-3 sentences describing what the post covers]
+
+          Keywords: [comma-separated keywords from the outline]"
+      - depends_on: "" (all posts can be written in parallel)
+
+      Produce ONLY the numbered actions. No prose, no commentary.
+    schema:
+      actions:
+        - type: create_task
+          task_name: "string"
+          agent_name: "string"
+          task_type: "blog_write"
+          description: "string"
+          depends_on: "string"
+
+  - type: close
+    rag_update: true
+
+adjudication:
+  enabled: true
+  pass_threshold: 65
+  deliverable_type: coordination
+  criteria:
+    completeness:
+      weight: 35
+      description: "All posts have title, brief, and keywords in the correct format"
+    variety:
+      weight: 30
+      description: "Posts cover different angles, formats, and difficulty levels — no redundancy"
+    progression:
+      weight: 20
+      description: "Series builds logically; posts don't assume knowledge the series hasn't covered"
+    shareability:
+      weight: 15
+      description: "At least 2 posts have obvious viral or sharing potential"