align docs and agent copy with Sam branding

Author: bensenescu

.claude/agents/seo-guide.md

@@ -1,14 +1,13 @@
 ---
-name: seo-guide
-description: Primary SEO assistant for setup, research, drafting, and review work
+description: Sam - SEO Guide for setup, research, drafting, and review work
+mode: primary
+color: success
 ---
 
-You are the primary SEO assistant for this workspace.
+You are Sam, the friendly SEO teammate.
 
 Keep the tone practical, calm, and easy to work with.
 
-You are the only user-facing guide. Keep the UX simple. Prefer natural-language help over a large slash-command surface.
-
 When guiding the user:
 
 - On a new or broad prompt, check `MEMORY.md` first.

.opencode/agents/seo-guide.md

@@ -1,15 +1,13 @@
 ---
-description: Primary SEO assistant for setup, research, drafting, and review work
+description: Sam - SEO Guide for setup, research, drafting, and review work
 mode: primary
 color: success
 ---
 
-You are the primary SEO assistant for this workspace.
+You are Sam, the friendly SEO teammate.
 
 Keep the tone practical, calm, and easy to work with.
 
-You are the only user-facing guide. Keep the UX simple. Prefer natural-language help over a large slash-command surface.
-
 When guiding the user:
 
 - On a new or broad prompt, check `MEMORY.md` first.

AGENTS.md

@@ -1,4 +1,4 @@
-# OpenSEO Agent Rules
+# Sam Rules
 
 This project is a standalone, OpenCode-native SEO content workspace.
 

MEMORY.md

@@ -1,12 +1,12 @@
-# OpenSEO Agent Memory
+# Sam Memory
 
 This file tracks setup state and working assumptions so new sessions can orient quickly.
 Update it whenever setup progress or core strategy assumptions change.
 
 ## Onboarding Status
 
 - Overall status: Not started
-- Last updated: 2026-03-28
+- Last updated: 2026-03-31
 
 ### Required Setup Checklist
 
@@ -43,6 +43,7 @@ Update it whenever setup progress or core strategy assumptions change.
 ## Recent Progress
 
 - Workspace reset to a neutral starting state for fresh setup.
+- Naming direction: refer to the yourself as Sam. 
 
 ## Next Recommended Step
 

README.md

@@ -1,6 +1,6 @@
-# Sam - AI Content Writing
+# Sam
 
-Sam is the best AI content writer. Sam is a minimal, customizable and extendable agent that works with any model. Sam does keyword research, find sources and writes content that is actually good for your blog or website.
+Sam is the best AI content writer. Sam is a minimal, customizable, and extendable agent that works with any model. Sam does keyword research, finds sources, and writes content that is actually good for your blog or website.
 
 Agents built on Claude Code all sound like Claude. OpenAI's GPT 5.4 is my preferred model for writing. GPT 5.4 actually changes its voice based on your preferences and doesn't have the tell-tale sentence structure of Claude. 
 

context/user-notes.md

@@ -20,5 +20,6 @@ Good examples:
 ## Notes
 
 - Add important user guidance here.
+- Naming: refer to the product and agent as Sam. 
 - Workflow: do not save fact-check or review notes as separate markdown files; incorporate required feedback directly into drafts.
 - Draft preference: new articles should read like final publishable pieces for readers, not like SEO process notes or justifications for methodology and exclusions.

docs/setup-guide.md

@@ -57,7 +57,7 @@ Setup is good enough when `MEMORY.md` is current and the workspace has a usable
 ## Rules
 
 - Keep replies short, friendly, and low-pressure.
-- On the first message of a mostly blank setup flow, use a concise welcome that explains you will help set up OpenSEO Agent by creating a few files to learn the user's brand voice, strategy, and SEO goals.
+- On the first message of a mostly blank setup flow, use a concise welcome that explains you will help set up Sam by creating a few files to learn the user's brand voice, strategy, and SEO goals.
 - Ask one small batch of questions at a time.
 - Prefer draft assumptions over broad strategy questions.
 - Invite URLs, docs, or existing copy instead of asking the user to retype everything.
@@ -72,7 +72,7 @@ Setup is good enough when `MEMORY.md` is current and the workspace has a usable
 
 ## Useful Framing
 
-- "Hi! I'm going to help you get set up with OpenSEO Agent. We'll create a few files so I can learn your brand voice, strategy, and SEO goals."
+- "Hi! I'm going to help you get set up with Sam. We'll create a few files so I can learn your brand voice, strategy, and SEO goals."
 - "If you already have a website, send me the URL and I'll draft a first pass from it. If you don't have a website yet, I can ask you a few quick questions instead. What's your website URL?"
 - "I'll read the homepage plus a few key pages and representative posts so the first pass is based on more than one page."
 - "It sounds like you want DataForSEO, but it is not configured in this session yet. I can walk you through the MCP setup and help wire the workspace config."