Prepare NBJ OB1 Agent Memory ClawHub launch

Author: justfinethanku

AGENTS.md

@@ -13,3 +13,6 @@
 - Treat inferred or generated memory as evidence by default. Instruction-grade memory requires human confirmation or trusted import.
 - Avoid raw transcript, model reasoning trace, secret, and large-code-block storage by default.
 - Prefer diagram-first documentation for this work: diagram, short explanation, copy-paste setup, then deeper reference.
+- Carry Nate B. Jones / OB1 provenance through product surfaces, docs, diagrams, screenshots, and starter seed data. Keep it subtle and useful: micro-branding, source labels, logo marks, and provenance language instead of loud marketing copy.
+- Treat public OB1 assets as helpful-first audience growth for Nate Jones. Every public guide, recipe, tutorial, package page, release note, and walkthrough should point back to Nate's Substack and site in a natural way: https://substack.com/@natesnewsletter and https://natebjones.com.
+- Make the case by being genuinely useful. The CTA should feel earned: "Nate gives away practical systems like this" rather than generic marketing copy.

docs/assets/agent-memory/promotional/README.md

@@ -0,0 +1,32 @@
+# NBJ OB1 Agent Memory Promotional Assets
+
+Reusable launch images for ClawHub, GitHub, tutorials, Substack, and video end cards.
+
+Built by Nate B. Jones / OB1. Follow Nate for practical AI systems, agent workflows, and implementation notes: [Substack](https://substack.com/@natesnewsletter) and [natebjones.com](https://natebjones.com).
+
+## Asset Set
+
+| File | Size | Use |
+| ---- | ---- | --- |
+| `final/nbj-ob1-agent-memory-hero-16x9.png` | 1536x864 | Tutorial hero, YouTube/Remotion frame, docs hero |
+| `final/nbj-ob1-agent-memory-clawhub-banner.png` | 1536x512 | ClawHub/GitHub package banner |
+| `final/nbj-ob1-agent-memory-social-square.png` | 1024x1024 | Social posts, Substack card |
+| `final/nbj-ob1-agent-memory-loop-card.png` | 1536x1024 | Explainer image for recall/write-back loop |
+
+## Images 2 Background Prompts
+
+### Hero
+
+Clean editorial technology poster background for a serious open-source AI memory system. Dark graphite workspace, faint olive-green data grid, subtle repeated microtype pattern, quiet light leaks, precise technical atmosphere, no people, no readable text, lots of negative space on the left, premium documentation aesthetic, not corporate stock, not glossy sci-fi.
+
+### ClawHub Banner
+
+Wide clean banner background for an AI developer plugin launch. Matte black and graphite, subtle olive and bone-white accents, faint modular circuit traces, thin pinstripe microtype texture, practical engineering feel, no readable text, no logo, high-end open-source documentation aesthetic.
+
+### Social Square
+
+Square promotional background for an open-source agent memory tool. Dark textured surface, minimal technical diagram feel, soft olive-green glow, precise grid alignment, faint cards and provenance tags as abstract shapes, no readable text, no people, clean and trustworthy.
+
+### Loop Card
+
+Editorial explainer background for a governed agent memory loop. Four abstract stations connected by thin lines, dark graphite board, olive and cream highlights, subtle source/provenance cues as abstract labels, no readable text, no logos, clean technical diagram atmosphere.

docs/assets/agent-memory/promotional/build_promotional_assets.py

@@ -0,0 +1,170 @@
+from __future__ import annotations
+
+from pathlib import Path
+from PIL import Image, ImageDraw, ImageFont, ImageFilter
+
+
+ROOT = Path(__file__).resolve().parent
+BACKGROUND = ROOT / "generated-backgrounds"
+FINAL = ROOT / "final"
+BRAND = ROOT.parent / "brand"
+
+FONT_REGULAR = "/System/Library/Fonts/Supplemental/Arial.ttf"
+FONT_BOLD = "/System/Library/Fonts/Supplemental/Arial Bold.ttf"
+
+INK = (236, 239, 225, 255)
+MUTED = (171, 176, 162, 255)
+OLIVE = (174, 207, 119, 255)
+BLUE = (141, 196, 212, 255)
+GOLD = (216, 193, 103, 255)
+LINE = (216, 228, 188, 90)
+DARK = (11, 14, 12, 220)
+
+
+def font(size: int, bold: bool = False) -> ImageFont.FreeTypeFont:
+    return ImageFont.truetype(FONT_BOLD if bold else FONT_REGULAR, size=size)
+
+
+def load_bg(name: str) -> Image.Image:
+    return Image.open(BACKGROUND / name / "openai-gpt-image-2" / "image.png").convert("RGBA")
+
+
+def fit_logo(size: int) -> Image.Image:
+    logo = Image.open(BRAND / "ob1-beanie-mark-cream.png").convert("RGBA")
+    logo.thumbnail((size, size), Image.Resampling.LANCZOS)
+    return logo
+
+
+def overlay_gradient(img: Image.Image, opacity: int = 150) -> Image.Image:
+    w, h = img.size
+    layer = Image.new("RGBA", (w, h), (0, 0, 0, 0))
+    px = layer.load()
+    for x in range(w):
+        for y in range(h):
+            left = 1 - (x / max(w - 1, 1))
+            bottom = y / max(h - 1, 1)
+            alpha = int(opacity * (0.35 + 0.65 * left) + 42 * bottom)
+            px[x, y] = (6, 8, 7, min(alpha, 235))
+    return Image.alpha_composite(img, layer)
+
+
+def add_microtype(img: Image.Image, text: str = "NBJ OB1") -> Image.Image:
+    w, h = img.size
+    layer = Image.new("RGBA", (w, h), (0, 0, 0, 0))
+    draw = ImageDraw.Draw(layer)
+    f = font(12, bold=True)
+    for y in range(-20, h + 40, 86):
+        for x in range(-20, w + 180, 182):
+            draw.text((x, y), text, font=f, fill=(230, 240, 205, 18))
+    layer = layer.filter(ImageFilter.GaussianBlur(0.15))
+    return Image.alpha_composite(img, layer)
+
+
+def label(draw: ImageDraw.ImageDraw, xy: tuple[int, int], text: str, fill=OLIVE) -> None:
+    x, y = xy
+    f = font(22, bold=True)
+    pad_x, pad_y = 14, 8
+    box = draw.textbbox((x, y), text, font=f)
+    draw.rectangle(
+        (x - pad_x, y - pad_y, box[2] + pad_x, box[3] + pad_y),
+        outline=(fill[0], fill[1], fill[2], 105),
+        fill=(20, 24, 20, 125),
+        width=1,
+    )
+    draw.text((x, y), text, font=f, fill=fill)
+
+
+def draw_footer(draw: ImageDraw.ImageDraw, w: int, h: int) -> None:
+    footer = "Built by Nate B. Jones / OB1  |  substack.com/@natesnewsletter  |  natebjones.com"
+    draw.text((48, h - 56), footer, font=font(20), fill=(216, 222, 199, 205))
+
+
+def draw_logo_lockup(img: Image.Image, draw: ImageDraw.ImageDraw, x: int, y: int, logo_size: int = 74) -> None:
+    logo = fit_logo(logo_size)
+    img.alpha_composite(logo, (x, y))
+    draw.text((x + logo_size + 18, y + 8), "NBJ / OB1", font=font(24, bold=True), fill=INK)
+    draw.text((x + logo_size + 18, y + 40), "AGENT MEMORY", font=font(16, bold=True), fill=(OLIVE[0], OLIVE[1], OLIVE[2], 220))
+
+
+def save(img: Image.Image, name: str) -> None:
+    FINAL.mkdir(parents=True, exist_ok=True)
+    img.convert("RGB").save(FINAL / name, quality=95, optimize=True)
+
+
+def hero() -> None:
+    img = overlay_gradient(load_bg("hero-16x9"), 165)
+    img = add_microtype(img)
+    draw = ImageDraw.Draw(img)
+    draw_logo_lockup(img, draw, 64, 58, 82)
+    draw.text((64, 205), "NBJ OB1", font=font(44, bold=True), fill=OLIVE)
+    draw.text((64, 260), "Agent Memory", font=font(92, bold=True), fill=INK)
+    draw.text((64, 356), "for OpenClaw", font=font(58, bold=True), fill=(209, 218, 194, 250))
+    draw.text((68, 455), "Recall before the task. Write back after. Inspect everything.", font=font(31), fill=(218, 224, 204, 230))
+    label(draw, (70, 545), "ClawHub plugin + skill")
+    label(draw, (342, 545), "provenance-aware")
+    label(draw, (592, 545), "human review")
+    draw_footer(draw, *img.size)
+    save(img, "nbj-ob1-agent-memory-hero-16x9.png")
+
+
+def banner() -> None:
+    img = overlay_gradient(load_bg("clawhub-banner"), 145)
+    img = add_microtype(img)
+    draw = ImageDraw.Draw(img)
+    draw_logo_lockup(img, draw, 44, 42, 68)
+    draw.text((44, 166), "NBJ OB1 Agent Memory", font=font(58, bold=True), fill=INK)
+    draw.text((48, 235), "OpenClaw plugin + skill for governed recall and write-back.", font=font(29), fill=(219, 224, 204, 232))
+    label(draw, (50, 320), "@natebjones/ob1-agent-memory")
+    label(draw, (475, 320), "nbj-ob1-agent-memory-openclaw", fill=BLUE)
+    draw.text((48, 446), "Follow Nate: substack.com/@natesnewsletter  |  natebjones.com", font=font(20), fill=(216, 222, 199, 205))
+    save(img, "nbj-ob1-agent-memory-clawhub-banner.png")
+
+
+def square() -> None:
+    img = overlay_gradient(load_bg("social-square"), 165)
+    img = add_microtype(img)
+    draw = ImageDraw.Draw(img)
+    draw_logo_lockup(img, draw, 62, 58, 76)
+    draw.text((64, 228), "Agents need", font=font(58, bold=True), fill=INK)
+    draw.text((64, 292), "memory they", font=font(58, bold=True), fill=INK)
+    draw.text((64, 356), "can trust.", font=font(74, bold=True), fill=OLIVE)
+    draw.text((68, 478), "NBJ OB1 Agent Memory gives OpenClaw", font=font(29), fill=(222, 227, 207, 232))
+    draw.text((68, 520), "scoped recall, write-back, review queues,", font=font(29), fill=(222, 227, 207, 232))
+    draw.text((68, 562), "and recall traces.", font=font(29), fill=(222, 227, 207, 232))
+    label(draw, (72, 660), "evidence is not instruction")
+    label(draw, (72, 724), "inspectable by default", fill=BLUE)
+    draw.text((68, 930), "Nate B. Jones / OB1", font=font(21), fill=(216, 222, 199, 210))
+    draw.text((68, 958), "substack.com/@natesnewsletter  |  natebjones.com", font=font(19), fill=(216, 222, 199, 190))
+    save(img, "nbj-ob1-agent-memory-social-square.png")
+
+
+def loop_card() -> None:
+    img = overlay_gradient(load_bg("loop-card"), 135)
+    img = add_microtype(img)
+    draw = ImageDraw.Draw(img)
+    draw_logo_lockup(img, draw, 58, 48, 72)
+    draw.text((58, 160), "The governed agent memory loop", font=font(58, bold=True), fill=INK)
+    draw.text((62, 232), "OpenClaw acts. OB1 remembers what is useful, sourced, and reviewable.", font=font(30), fill=(218, 224, 204, 230))
+    nodes = [
+        ((90, 420), "1", "Recall", "Scoped context\n+ use policy", OLIVE),
+        ((455, 420), "2", "Work", "Agent task\nacross models", BLUE),
+        ((820, 420), "3", "Write back", "Compact operational\nmemory", GOLD),
+        ((1185, 420), "4", "Review", "Confirm, edit,\nor reject", OLIVE),
+    ]
+    for idx, ((x, y), num, title, body, color) in enumerate(nodes):
+        draw.rounded_rectangle((x, y, x + 270, y + 220), radius=8, fill=(18, 22, 19, 190), outline=(color[0], color[1], color[2], 155), width=2)
+        draw.text((x + 24, y + 24), num, font=font(28, bold=True), fill=color)
+        draw.text((x + 24, y + 72), title, font=font(35, bold=True), fill=INK)
+        draw.multiline_text((x + 24, y + 124), body, font=font(21), fill=(216, 222, 199, 215), spacing=8)
+        if idx < len(nodes) - 1:
+            draw.line((x + 290, y + 110, x + 345, y + 110), fill=LINE, width=3)
+            draw.polygon([(x + 345, y + 110), (x + 329, y + 101), (x + 329, y + 119)], fill=LINE)
+    draw_footer(draw, *img.size)
+    save(img, "nbj-ob1-agent-memory-loop-card.png")
+
+
+if __name__ == "__main__":
+    hero()
+    banner()
+    square()
+    loop_card()

docs/assets/agent-memory/promotional/final/nbj-ob1-agent-memory-clawhub-banner.png

@@ -0,0 +1,45 @@
+# Agent Memory Branding DNA
+
+OB1 Agent Memory should carry Nate B. Jones provenance without turning the product into a billboard.
+
+## Visual Defaults
+
+- Use the OB1 mark in dashboard shells, login surfaces, screenshots, tutorial frames, and launch diagrams.
+- Use the beanie/glasses OB1 mark as the canonical visual signature for Agent Memory launch assets.
+- Use `NBJ / OB1` as microtype, pinstripe texture, stamps, footers, and provenance labels.
+- Prefer subtle ownership marks over big promotional copy: small mono labels, source badges, screenshot watermarks, and diagram captions.
+- Keep workflow UI dense and operational. Brand should sit in the material system, not compete with review actions, traces, or memory content.
+
+## Product Language
+
+- Default to `NBJ OB1 Agent Memory` for public launch surfaces and `OB1 Agent Memory` for contract-level runtime-neutral docs.
+- Use `NBJ OB1 Agent Memory for OpenClaw` for the OpenClaw launch path.
+- Tie public-facing recipes back to Nate's framing: practical AI strategy, zero hype, governed continuity, provenance, review, and reusable operating knowledge.
+- When a page, guide, or diagram introduces the system, make Nate/OB1 provenance visible in the first viewport or first frame.
+
+## Nate Jones Audience Path
+
+- Public docs are part of the Nate Jones funnel, but the product value has to lead. Be useful first, then point people to Nate for more systems like this.
+- Every major public artifact should include one concise Nate link block with:
+  - Substack: https://substack.com/@natesnewsletter
+  - Site: https://natebjones.com
+- Treat Nate's site as a destination and CTA, not as visual source material. Do not borrow its louder visual styling for OB1 Agent Memory assets.
+- Prefer language like: "Built by Nate B. Jones / OB1. Follow Nate for practical AI systems, agent workflows, and implementation notes."
+- Do not turn technical docs into ad copy. Put the CTA in a footer, intro note, sidebar, release note, or tutorial end card.
+- Tutorial videos should include a first-frame or final-frame NBJ/OB1 mark and a Substack subscribe CTA.
+- Screenshots and PDFs should include subtle NBJ/OB1 provenance in the footer or frame treatment.
+
+## Documentation And Launch Assets
+
+- Every major Agent Memory guide should open with a diagram that includes an OB1/NBJ signature.
+- Tutorial screenshots should use Nate continuity demo data, not generic smoke-harness rows.
+- Starter-knowledge seed packs should include source-backed reference memories for the OB1 repo, Nate's public channels, and the Agent Memory launch architecture.
+- Keep copied/forked screenshots and diagrams recognizable as Nate Jones / OB1 assets through embedded micro-branding.
+- Include Nate's public channels in starter docs and seed data when relevant: Substack, natebjones.com, YouTube references, OB1 repo, and Agent Memory launch architecture.
+
+## Current Asset Pack
+
+- Dashboard public assets live in `dashboards/open-brain-dashboard-next/public/brand/`.
+- Tutorial/provenance assets live in `docs/assets/agent-memory/brand/`.
+- The current app mark is derived from a `gpt-image-2` generation based on the beanie/glasses outline, then converted into transparent UI-safe PNGs.
+- The original supplied outline is preserved in the docs asset pack so the visual provenance stays inspectable.