narrative-blog

name

narrative-blog

description

WHAT: produce Blog 1 of a framework CHAPTER — the narrative chapter-opener — for an already-built AIOS/package by reconstructing its journey from its own dir (CLAUDE.md, README, dev log) and FILLING framework.JourneyCore, then rendering with render_blog1 (never hand-write the blog). WHEN: when making a framework/chapter from something already built, when you need the story post that opens a chapter, or when the user says blog organ / narrative blog / skill2framework (any of).

narrative-blog — Blog 1, the narrative opener (stage 1 of skill2framework)

Ported 2026-07-10 from the proven doc-mirror narrative-blog-from-aios prompt-skill (score 1.00, FULL_E2E 2026-06-03). DIY adaptation: the journey source is the AIOS's OWN dir (CLAUDE.md + README + any dev log), and the renderer is framework.journey (no external renderer dependency). This port has not itself been E2E-scored yet.

Your ONE job: turn the AIOS's real journey into Blog 1 by FILLING the JourneyCore model and letting render_blog1 produce the markdown. You do NOT hand-write the blog — fill the model, run the renderer (deterministic output).

Inputs (given at dispatch)

• AIOS/package name + root dir
• Journey source: the dir's CLAUDE.md, README.md, changelog/dev-log — read them FULLY
• Plugin / code URL
• Output path for the rendered markdown

Step 1 — reconstruct the journey (grounded, never invented)

From the journey source, extract the Hero arc AS ACTUALLY LIVED: status_quo (the painful before) · obstacle (the blocker + the moment seen) · overcome (the shift + what was built) · accomplishment (the after, feeling + proof) · the_boon (the ONE transferable reframe) · demo_description · why_this_matters · universal_application · hook (AUTHORED — one clean opening sentence you write).

IS vs VISION discipline: narrate only what the source supports. Do not invent capabilities or results. Mark each field GROUNDED (cite where) vs INFERRED in your report.

Step 2 — fill + render (the whole mechanism)

from framework import JourneyCore, render_blog1
core = JourneyCore(journey_name="...", domain="...", hook="...",
                   status_quo="...", obstacle="...", overcome="...",
                   accomplishment="...", the_boon="...", demo_description="...",
                   why_this_matters="...", universal_application="...",
                   github_url="...", plugin_url="...")
open(OUTPUT, "w").write(render_blog1(core))

If the import fails, REPORT THE EXACT ERROR — never hand-write the blog as a workaround.

Step 3 — report

The path written + the full markdown + the per-field GROUNDED/INFERRED check.