taketomarket 2.2.0 → 2.3.0

package/skills/ttm-update/SKILL.md

@@ -9,8 +9,100 @@ allowed-tools: Bash Read
 
 # /ttm-update
 
+## Step 0: First-run inline education
+
+Read `.taketomarket/CONFIG.md`. Parse `first_run_seen` (object) and `inline_education` (boolean, default true).
+
+If `inline_education` is false: skip this step. Else if `first_run_seen.ttm-update` is not `true`, print the explainer below verbatim, then mark this skill as seen:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/ttm-tools.cjs" first-run mark ttm-update
+```
+
+Use this exact check (bash) to decide whether to print: `node "${CLAUDE_PLUGIN_ROOT}/bin/ttm-tools.cjs" first-run check ttm-update --raw` -- the JSON `seen` field is `true` once the explainer has run before.
+
+### Explainer for `/ttm-update`
+
+`/ttm-update` checks your installed takeToMarket version against the
+npm registry, detects whether you installed via npm or git clone,
+runs the appropriate upgrade path, then reconciles any locally-edited
+skill files against the new source and offers per-file diffs.
+
+Why it matters: skills evolve quickly and an out-of-date install
+silently misses gate improvements and bug fixes. This skill is the
+opinionated upgrader -- it knows the right command for your install
+method and preserves your local edits behind explicit prompts rather
+than overwriting them.
+
+(Canonical source: `references/inline-education-blurbs.md`. Embedded verbatim because workflows do not @-resolve files at runtime.)
+
+---
+
 Check if takeToMarket needs updating and upgrade if available.
 
+## Step: Detect install method
+
+Detect how the user installed takeToMarket before deciding how to upgrade.
+Run this FIRST, before any version or legacy-folder work:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/ttm-tools.cjs" install-detect --raw
+```
+
+Parse the JSON `method` field. The value will be one of:
+
+- **clone** — installed via `git clone`. Upgrades happen with `git pull` in the
+  plugin root, then re-running the installer (`node install.js` or `npx
+  taketomarket@latest --yes` from the cloned directory).
+- **npm** — installed via `npx taketomarket` or `npm install -g taketomarket`.
+  Upgrades happen via `npx taketomarket@latest --yes`.
+- **unknown** — could not locate a plugin root. Print manual instructions and
+  ask the user where takeToMarket is installed before continuing:
+  ```
+  Could not auto-detect your takeToMarket install location.
+  Manual upgrade options:
+    - npm:   npx taketomarket@latest --yes
+    - clone: cd <your-clone>; git pull; node install.js
+  ```
+  Halt the workflow until the user confirms the method to use.
+
+Remember the `method` and `root` values — they are used by the version-check
+branching and the skill-file sync step below.
+
+## Step: Legacy folder migration
+
+Before checking version, detect whether the project still uses the legacy
+`.marketing/` state directory and offer migration to `.taketomarket/`:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/ttm-tools.cjs" legacy-folder check --raw
+```
+
+Parse the JSON `state` field:
+
+- **legacy**: print `WARN: Legacy '.marketing/' detected. Migration will rename it to '.taketomarket/'. Recommend committing or backing up first.` then prompt with `AskUserQuestion`:
+  - question: "Migrate `.marketing/` to `.taketomarket/` now? (recommended before upgrade)"
+  - options: "Yes, migrate now" / "Skip for now"
+  - On Yes:
+    ```bash
+    node "${CLAUDE_PLUGIN_ROOT}/bin/ttm-tools.cjs" legacy-folder migrate --raw
+    ```
+  - On Skip: continue with a note that the upgrade will land alongside the legacy folder.
+- **conflict**: print the error below, then halt before the version check:
+  ```
+  ERROR: Both .marketing/ and .taketomarket/ exist. Manual resolution required before upgrade.
+
+  To resolve:
+    1. Compare contents:  diff -r .marketing .taketomarket
+    2. Merge any unique files from .marketing/ into .taketomarket/.
+    3. Remove the legacy folder once .taketomarket/ is complete:
+       rm -rf .marketing
+    4. Re-run /ttm-update to continue the upgrade.
+  ```
+- **current** or **none**: continue silently.
+
+## Version check
+
 1. Get current installed version:
 ```bash
 cat $HOME/.taketomarket/package.json 2>/dev/null | python3 -c "import sys,json; print(json.load(sys.stdin).get('version','unknown'))" 2>/dev/null || echo "unknown"
@@ -21,9 +113,65 @@ cat $HOME/.taketomarket/package.json 2>/dev/null | python3 -c "import sys,json;
 npm show taketomarket version 2>/dev/null || echo "unknown"
 ```
 
-3. Compare versions. If a newer version is available (latest > installed), run:
-```bash
-npx taketomarket@latest --yes
+3. Compare versions. If already up to date, confirm
+   "takeToMarket vX.X.X is up to date." and skip the install + sync steps below.
+
+4. If a newer version is available, branch by the install `method` detected
+   earlier:
+
+   - **clone** — pull the latest source, then reinstall from the cloned directory:
+     ```bash
+     git -C "<root>" pull --ff-only && node "<root>/install.js"
+     ```
+     (Substitute the `root` returned from `install-detect`.)
+   - **npm** — upgrade via npm:
+     ```bash
+     npm install -g taketomarket@latest
+     ```
+     (Falling back to `npx taketomarket@latest --yes` is acceptable if `npm
+     install -g` is not desired.)
+   - **unknown** — print the manual instructions emitted in the detection step
+     and halt. Do NOT attempt an automatic install.
+
+## Step: Skill-file diff + sync
+
+After the install completes (clone or npm), reconcile any user-installed skill
+files under `~/.claude/skills/ttm-*/` against the freshly installed source under
+`<root>/skills/ttm-*/`. This catches the case where the user edited an installed
+skill or where the installer skipped a file.
+
+For each `ttm-*` skill directory present in BOTH locations:
+
+1. Compare files (e.g., `SKILL.md` and any supporting files) between
+   `~/.claude/skills/<skill>/` and `<root>/skills/<skill>/`.
+2. For every file with a non-trivial diff, show the user a short summary of the
+   diff (filename + a few lines of context). Then use `AskUserQuestion` with
+   priority `critical`:
+   - question: "Overwrite `~/.claude/skills/<skill>/<file>` with the new source?"
+   - options: "Yes, overwrite" / "Skip this file" / "Skip remaining files"
+3. On "Yes, overwrite": copy the source file over the installed copy.
+4. On "Skip remaining files": stop the sync loop and continue to the log step.
+5. Track the count of files actually synced.
+
+If `<root>` is `null` (unknown install method), skip this step entirely.
+
+## Step: Append to UPDATE-LOG.md
+
+Record the upgrade outcome in `.taketomarket/UPDATE-LOG.md` (create the file if
+it does not exist). Append the following block:
+
+```
+## YYYY-MM-DD HH:MM
+- Updated from vX.X.X to vY.Y.Y
+- Method: <clone|npm>
+- Files synced: <count>
+- Folder migration: <yes|no>
 ```
 
-4. If already up to date, confirm: "takeToMarket vX.X.X is up to date."
+`<yes|no>` reflects whether the legacy-folder migration step actually ran a
+rename during this invocation.
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-verify/SKILL.md

@@ -12,3 +12,8 @@ allowed-tools: Read Write Bash Glob Grep Task AskUserQuestion
 # /ttm-verify
 
 Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/lifecycle/verify.md`
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/templates/agents-md.md

@@ -4,6 +4,16 @@
 
 Every marketing asset ships with a verifiable outcome metric and passes through a positioning-invariant quality gate wall. No asset ships without both, ever.
 
+### Target Audience
+
+**Built for developerneurs and solopreneurs** — engineers building and shipping their own products who have zero or near-zero marketing/growth experience.
+
+When assisting the user:
+- Assume strong engineering literacy. They read code fluently.
+- Assume zero marketing literacy. Explain positioning, ICP, AEO, funnels in engineering analogies.
+- Default to opinionated guidance — they came here because they don't know what's "right" in marketing.
+- When suggesting marketing terms, link to `/ttm-101` or run inline explanations on first use.
+
 ## Positioning as Invariant (positioning-as-invariant)
 
 POSITIONING.md is the source of truth for all marketing content. It is:
@@ -33,10 +43,10 @@ Each phase has a dedicated `/ttm-*` command. Phases cannot be skipped.
 
 ## File Paths
 
-- Marketing state: `.marketing/`
-- Reference files: `.marketing/POSITIONING.md`, `.marketing/BRAND.md`, etc.
-- Campaigns: `.marketing/CAMPAIGNS/<slug>/`
-- Campaign state: `.marketing/CAMPAIGNS/<slug>/STATE.md`
+- Marketing state: `.taketomarket/`
+- Reference files: `.taketomarket/POSITIONING.md`, `.taketomarket/BRAND.md`, etc.
+- Campaigns: `.taketomarket/CAMPAIGNS/<slug>/`
+- Campaign state: `.taketomarket/CAMPAIGNS/<slug>/STATE.md`
 
 ## Deterministic Operations
 

package/templates/campaign-research.md

@@ -10,30 +10,30 @@
 
 | Insight | Confidence | Source |
 |---------|-----------|--------|
-| [GENERATED BY /ttm-research] | HIGH/MEDIUM/LOW | [source or "user-provided"] |
+| [GENERATED BY /ttm-discover] | HIGH/MEDIUM/LOW | [source or "user-provided"] |
 
 ## Competitor Content Analysis
 
 | Competitor | Content Type | Key Message | Gap/Opportunity |
 |-----------|-------------|-------------|-----------------|
-| [GENERATED BY /ttm-research] | [type] | [message] | [gap] |
+| [GENERATED BY /ttm-discover] | [type] | [message] | [gap] |
 
 ## Audience Insights
 
 | Insight | Confidence | Source |
 |---------|-----------|--------|
-| [GENERATED BY /ttm-research] | HIGH/MEDIUM/LOW | [source] |
+| [GENERATED BY /ttm-discover] | HIGH/MEDIUM/LOW | [source] |
 
 ## Ambient Narrative
 
-[GENERATED BY /ttm-research -- What the market already believes about this topic]
+[GENERATED BY /ttm-discover -- What the market already believes about this topic]
 
 ## Content Gaps
 
 | Gap | Opportunity Size | Difficulty |
 |-----|-----------------|------------|
-| [GENERATED BY /ttm-research] | HIGH/MEDIUM/LOW | HIGH/MEDIUM/LOW |
+| [GENERATED BY /ttm-discover] | HIGH/MEDIUM/LOW | HIGH/MEDIUM/LOW |
 
 ## Research Summary
 
-[GENERATED BY /ttm-research -- 2-3 sentence summary for /ttm-brief to consume quickly]
+[GENERATED BY /ttm-discover -- 2-3 sentence summary for /ttm-brief to consume quickly]

package/templates/campaign-state.md

@@ -37,4 +37,4 @@ verify.overall_result: null
 # Campaign: [CAMPAIGN_NAME]
 
 Phase: created
-Next step: Run `/ttm-research [SLUG]` to gather market intelligence.
+Next step: Run `/ttm-discover [SLUG]` to gather market intelligence.

package/templates/claude-md.md

@@ -4,6 +4,16 @@
 
 Every marketing asset ships with a verifiable outcome metric and passes through a positioning-invariant quality gate wall. No asset ships without both, ever.
 
+### Target Audience
+
+**Built for developerneurs and solopreneurs** — engineers building and shipping their own products who have zero or near-zero marketing/growth experience.
+
+When assisting the user:
+- Assume strong engineering literacy. They read code fluently.
+- Assume zero marketing literacy. Explain positioning, ICP, AEO, funnels in engineering analogies.
+- Default to opinionated guidance — they came here because they don't know what's "right" in marketing.
+- When suggesting marketing terms, link to `/ttm-101` or run inline explanations on first use.
+
 ## Positioning as Invariant (positioning-as-invariant)
 
 POSITIONING.md is the source of truth for all marketing content. It is:
@@ -33,10 +43,10 @@ Each phase has a dedicated `/ttm-*` command. Phases cannot be skipped.
 
 ## File Paths
 
-- Marketing state: `.marketing/`
-- Reference files: `.marketing/POSITIONING.md`, `.marketing/BRAND.md`, etc.
-- Campaigns: `.marketing/CAMPAIGNS/<slug>/`
-- Campaign state: `.marketing/CAMPAIGNS/<slug>/STATE.md`
+- Marketing state: `.taketomarket/`
+- Reference files: `.taketomarket/POSITIONING.md`, `.taketomarket/BRAND.md`, etc.
+- Campaigns: `.taketomarket/CAMPAIGNS/<slug>/`
+- Campaign state: `.taketomarket/CAMPAIGNS/<slug>/STATE.md`
 
 ## Deterministic Operations
 

package/templates/linkedin-base-template.md

@@ -0,0 +1,48 @@
+# LinkedIn Base — {{USER_NAME}}
+
+**Generated by `/ttm-linkedin-post` first-run interview on {{DATE}}.**
+**Source authors:** {{AUTHOR_LIST}}
+
+This file is the per-user LinkedIn style guide. It captures the cadence, hooks, and structure patterns derived from the user-selected source authors. Every `/ttm-linkedin-post` run loads this file.
+
+---
+
+## Voice + style
+
+**Voice archetype:** {{VOICE_ARCHETYPE}}
+
+**Sentence rhythm:** {{SENTENCE_RHYTHM}}
+
+**Vocabulary level:** {{VOCAB_LEVEL}}
+
+**Punctuation habits:** {{PUNCTUATION_HABITS}}
+
+## Hook patterns (from source authors)
+
+{{HOOK_PATTERNS_EXTRACTED}}
+
+## Post structure preferences
+
+{{STRUCTURE_PREFERENCES}}
+
+## Length distribution
+
+{{LENGTH_NORMS}}
+
+## Topics user wants to be known for
+
+{{TOPICS}}
+
+## Anti-patterns (things to avoid)
+
+{{ANTI_PATTERNS}}
+
+## Source author profile summaries
+
+{{AUTHOR_SUMMARIES}}
+
+---
+
+## Regeneration
+
+Run `/ttm-linkedin-post --rebuild-base` to refresh this file with new author scrapes.

package/templates/next-step-footer.md

@@ -0,0 +1,13 @@
+<!-- next-step-footer -->
+
+---
+
+**Next:** Run `/ttm-next` for the recommended next command based on your current state.
+
+Or run one of:
+- `/ttm-state` to see all campaigns at a glance.
+- `/ttm-health` to validate `.taketomarket/` directory integrity.
+- `/ttm-resume` to pick up where you left off.
+
+Found a bug or want a new feature? File an issue at https://github.com/ranjanrishikesh/taketomarket/issues.
+<!-- /next-step-footer -->

package/templates/production-manifest.json

@@ -2,10 +2,10 @@
   "campaign": "[SLUG]",
   "produced_at": "[ISO_TIMESTAMP]",
   "context_loaded": {
-    "brief": ".marketing/CAMPAIGNS/[SLUG]/BRIEF.md",
-    "positioning": ".marketing/POSITIONING.md",
-    "brand": ".marketing/BRAND.md",
-    "icp": ".marketing/ICP.md"
+    "brief": ".taketomarket/CAMPAIGNS/[SLUG]/BRIEF.md",
+    "positioning": ".taketomarket/POSITIONING.md",
+    "brand": ".taketomarket/BRAND.md",
+    "icp": ".taketomarket/ICP.md"
   },
   "hero": {
     "asset_id": 1,

package/templates/pseo/alternative-cms-schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Alternative Page CMS Schema",
+  "type": "object",
+  "required": ["slug", "competitorName", "tldr", "whyPeopleLeave", "whyWeAreTheAlternative"],
+  "properties": {
+    "slug": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+    "competitorName": { "type": "string" },
+    "tldr": { "type": "string", "minLength": 50, "maxLength": 400 },
+    "whyPeopleLeave": {
+      "type": "array",
+      "minItems": 3,
+      "maxItems": 5,
+      "items": { "type": "string" }
+    },
+    "whyWeAreTheAlternative": {
+      "type": "array",
+      "minItems": 3,
+      "maxItems": 5,
+      "items": { "type": "string" }
+    },
+    "featureParity": {
+      "type": "object",
+      "additionalProperties": { "type": "string" }
+    },
+    "migrationSteps": {
+      "type": "array",
+      "minItems": 3,
+      "items": {
+        "type": "object",
+        "required": ["step", "description"],
+        "properties": {
+          "step": { "type": "integer" },
+          "description": { "type": "string" },
+          "code": { "type": "string" },
+          "link": { "type": "string" }
+        }
+      }
+    },
+    "customerQuotes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["quote", "name"],
+        "properties": {
+          "quote": { "type": "string" },
+          "name": { "type": "string" },
+          "role": { "type": "string" },
+          "company": { "type": "string" }
+        }
+      }
+    },
+    "faq": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["question", "answer"],
+        "properties": {
+          "question": { "type": "string" },
+          "answer": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/templates/pseo/blog-cms-schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Blog Post CMS Schema",
+  "type": "object",
+  "required": ["slug", "title", "tldr", "author", "publishedAt", "sections"],
+  "properties": {
+    "slug": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+    "title": { "type": "string", "minLength": 10, "maxLength": 120 },
+    "tldr": { "type": "string", "minLength": 50, "maxLength": 400 },
+    "author": {
+      "type": "object",
+      "required": ["name"],
+      "properties": {
+        "name": { "type": "string" },
+        "role": { "type": "string" },
+        "avatarUrl": { "type": "string" }
+      }
+    },
+    "publishedAt": { "type": "string", "format": "date" },
+    "updatedAt": { "type": "string", "format": "date" },
+    "tags": { "type": "array", "items": { "type": "string" } },
+    "heroImage": { "type": "string" },
+    "sections": {
+      "type": "array",
+      "minItems": 3,
+      "items": {
+        "type": "object",
+        "required": ["h2", "body"],
+        "properties": {
+          "h2": { "type": "string" },
+          "body": { "type": "string" },
+          "visual": { "type": "string" }
+        }
+      }
+    },
+    "takeaways": {
+      "type": "array",
+      "minItems": 3,
+      "maxItems": 5,
+      "items": { "type": "string" }
+    },
+    "faq": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["question", "answer"],
+        "properties": {
+          "question": { "type": "string" },
+          "answer": { "type": "string" }
+        }
+      }
+    },
+    "related": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/templates/pseo/comparison-cms-schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Comparison Page CMS Schema",
+  "type": "object",
+  "required": ["slug", "competitorName", "tldr", "comparisonTable"],
+  "properties": {
+    "slug": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+    "competitorName": { "type": "string" },
+    "tldr": { "type": "string", "minLength": 50, "maxLength": 400 },
+    "comparisonTable": {
+      "type": "array",
+      "minItems": 5,
+      "items": {
+        "type": "object",
+        "required": ["feature", "product", "competitor"],
+        "properties": {
+          "feature": { "type": "string" },
+          "product": { "type": "string" },
+          "competitor": { "type": "string" }
+        }
+      }
+    },
+    "whenProductWins": {
+      "type": "array",
+      "minItems": 3,
+      "maxItems": 5,
+      "items": { "type": "string" }
+    },
+    "whenCompetitorWins": {
+      "type": "array",
+      "minItems": 3,
+      "maxItems": 5,
+      "items": { "type": "string" }
+    },
+    "pricing": {
+      "type": "object",
+      "required": ["product", "competitor"],
+      "properties": {
+        "product": { "type": "string" },
+        "competitor": { "type": "string" },
+        "notes": { "type": "string" }
+      }
+    },
+    "faq": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["question", "answer"],
+        "properties": {
+          "question": { "type": "string" },
+          "answer": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/templates/pseo/use-case-cms-schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Use-Case Page CMS Schema",
+  "type": "object",
+  "required": ["slug", "useCase", "tldr", "problem", "featurePillars"],
+  "properties": {
+    "slug": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+    "useCase": { "type": "string" },
+    "tldr": { "type": "string", "minLength": 50, "maxLength": 400 },
+    "problem": { "type": "string", "minLength": 1 },
+    "whyTypicalSolutionsFail": { "type": "string", "minLength": 1 },
+    "featurePillars": {
+      "type": "array",
+      "minItems": 3,
+      "items": {
+        "type": "object",
+        "required": ["title", "body"],
+        "properties": {
+          "title": { "type": "string" },
+          "body": { "type": "string" },
+          "visual": { "type": "string" }
+        }
+      }
+    },
+    "walkthrough": {
+      "type": "array",
+      "minItems": 3,
+      "items": {
+        "type": "object",
+        "required": ["step", "description"],
+        "properties": {
+          "step": { "type": "integer" },
+          "description": { "type": "string" },
+          "screenshot": { "type": "string" }
+        }
+      }
+    },
+    "outcome": { "type": "string" },
+    "customerQuote": {
+      "type": "object",
+      "required": ["quote", "name"],
+      "properties": {
+        "quote": { "type": "string" },
+        "name": { "type": "string" },
+        "role": { "type": "string" },
+        "company": { "type": "string" }
+      }
+    },
+    "faq": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["question", "answer"],
+        "properties": {
+          "question": { "type": "string" },
+          "answer": { "type": "string" }
+        }
+      }
+    },
+    "relatedUseCases": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/templates/reference-files/brand.md

@@ -43,3 +43,54 @@
 
 ### Bad Examples
 [GENERATED BY /ttm-init -- Examples of off-brand content with explanation]
+
+## Colors
+
+**Primary:** `[#HEX]` (e.g., `#0EA5E9`)
+**Primary variants:**
+- Lighter (hover): `[#HEX]`
+- Darker (active): `[#HEX]`
+
+**Secondary:** `[#HEX]`
+**Accent:** `[#HEX]`
+
+**Neutral scale:**
+- 50: `[#HEX]`
+- 100: `[#HEX]`
+- 200: `[#HEX]`
+- 300: `[#HEX]`
+- 400: `[#HEX]`
+- 500: `[#HEX]`
+- 600: `[#HEX]`
+- 700: `[#HEX]`
+- 800: `[#HEX]`
+- 900: `[#HEX]`
+
+**Semantic:**
+- Success: `[#HEX]`
+- Warning: `[#HEX]`
+- Error: `[#HEX]`
+- Info: `[#HEX]`
+
+**Accessibility check:**
+- Primary on light bg WCAG: `[AA / AAA]`
+- Primary on dark bg WCAG: `[AA / AAA]`
+
+**Palette rationale:** [Why these colors, derived from positioning + manifesto.]
+
+## Logo
+
+**Files** (saved to `.taketomarket/brand/`):
+- Primary: `logo.svg`
+- Mark only: `logo-mark.svg`
+- Wordmark only: `logo-wordmark.svg`
+- Mono light: `logo-mono-light.svg`
+- Mono dark: `logo-mono-dark.svg`
+- Favicon: `logo-favicon.svg`
+- Raster: `logo@1x.png`, `logo@2x.png`
+
+**Type:** [Wordmark / Lettermark / Symbol / Combination]
+
+**Rationale:** [Why this logo type, why these proportions, why these colors.]
+
+**Vision-review history:** [Round 1, Round 2, ... with critique + iteration.]