Skip to content

[marketing-reorg] consolidate brand+marketing into knowcap-landing (rename incoming) - #25

Merged
Smetools merged 3 commits into
mainfrom
hassan-marketing-reorg
Jun 1, 2026
Merged

[marketing-reorg] consolidate brand+marketing into knowcap-landing (rename incoming)#25
Smetools merged 3 commits into
mainfrom
hassan-marketing-reorg

Conversation

@Smetools

@Smetools Smetools commented Jun 1, 2026

Copy link
Copy Markdown
Collaborator

What

Reorganize knowcap-landing into the structure it'll need as knowcap-marketing (rename happens in GitHub admin step after this lands).

The repo's role expands from "the landing page" to "all brand + marketing + content + research alongside the website code."

Layout

knowcap-marketing/  (formerly knowcap-landing)
├── app/                  ← Next.js website (Vercel reads from here — UNCHANGED)
├── brand/                ← VISION, POSITIONING, MOAT, STRATEGY (canonical) + PRODUCT + personas + decisions + design-explorations + legacy
├── research/             ← audits/, data/ (CSVs), competitors/
├── campaigns/            ← stratdev/, linkedin-outbound, meta-paid-sprint, landing-pages/
├── content-pipeline/     ← drafts/, ideas/, video/, strategy/ (the marketing-content-plan)
├── strategy/             ← gtm-strategy, june-2026-gtm-game
└── DESIGN.md / DESIGN-E.md / README / CLAUDE.md

What moves IN

FROM knowcap-main/docs/ (will be deleted from there in companion PR):

  • VISION.md, POSITIONING.md, MOAT.md, STRATEGY.md → brand/
  • 2026-05-25-strategic-council.md → brand/decisions/
  • 2026-05-29-mena-council-readjudication.md → brand/decisions/
  • marketing-content-plan.md → content-pipeline/strategy/
  • june-2026-gtm-game.md → strategy/
  • 4× v3-variant-{library,operator,operator-light,quarterly}.md → brand/design-explorations/

FROM the empty knowcap-marketing stub repo (deleted after this lands):

  • stratdev/ (3 files) → campaigns/stratdev/
  • competitors/ (4 files incl. read.ai/) → research/competitors/
  • content-ideas/aid-mockumentary/ → content-pipeline/ideas/
  • strategy/ (brand-positioning, target-segments) → brand/legacy/ (historical)
  • strategy/gtm-strategy → strategy/
  • video-content/ → content-pipeline/video/
  • campaigns/ → campaigns/

FROM today's session (was uncommitted at repo root):

  • PRODUCT-PERSONAS.md + UPDATE → brand/personas/
  • GEO-AUDIT + SEO-AUDIT (2026-06-01) → research/audits/
  • 8× research CSVs (trends-mena-, MENA-, youtube-mena-*) → research/data/
  • 10 ICP blog posts (already in app/content/blog/, untouched)
  • robots.ts, sitemap.ts → already in app/app/ (Cloudflare AI-bot block override)
  • 5 compare pages + 1 odoo-partners landing page → app/app/compare/*, app/app/for/odoo-partners/

What gets deleted

6 stale ops files + 5 paired PDFs (all April 2026, predating the May trust-layer reframe):

  • EMAIL_SETUP.md, GMAIL_SETUP_GUIDE.md (.pdf), KNOWAPP_DIAGNOSIS.md (.pdf), TESTING_GUIDE.md (.pdf), PITCH_V4.1_CHANGES.md (.pdf), PITCH_V5_GPT_UPDATES.md (.pdf)

Cross-repo URL updates (post-rename targeted)

  • research/competitors/read.ai/positioning.md: 4× links to Knowcap-V2/knowcap/blob/main/docs/{VISION,POSITIONING,MOAT}.mdKnowcap-V2/knowcap-marketing/blob/main/brand/{...}.md
  • research/competitors/README.md: 1× link, same update
  • campaigns/meta-paid-sprint.md: 2 relative paths updated to new folder layout (../brand/legacy/, ../content-pipeline/video/)
  • research/competitors/read.ai/index.md: broken scrape/ link replaced with explanation pointing to llm-wiki dataset (research artifact, not in repo)

How to test

This PR is docs/folder reorg + adding today's site content. Vercel build should pass cleanly because:

  • All app/ content is unchanged or additive (new routes, new blog posts)
  • No code touched in app/components/*.tsx except the 4 version-* files (already had changes from today)
  • robots.ts + sitemap.ts are new Next.js routes — both standard MetadataRoute exports

After merge:

  1. Vercel deploys automatically
  2. https://knowcap.ai/robots.txt should serve our origin override (Allow GPTBot, ClaudeBot, etc.) instead of Cloudflare's blocking version
  3. https://knowcap.ai/sitemap.xml should list all routes
  4. https://knowcap.ai/for/odoo-partners and the 5 /compare/* pages should render
  5. 10 blogs at /blog/ should render

Companion PR

PR B (knowcap repo): slims docs/ down to engineer-only by deleting VISION/POSITIONING/MOAT/STRATEGY/decisions and reorganizing remaining engineer docs into architecture/, governance/, ops/, proposals/, etc.

🤖 Generated with Claude Code

Summary by CodeRabbit

Release Notes

  • New Features

    • Added competitor comparison landing pages
    • Launched new Odoo partner conversion page
    • Introduced claims display component with verification status indicators
  • Content

    • Published 11 new blog articles covering MENA market insights, compliance topics, and business verticals
  • Documentation

    • Updated brand vision, positioning, and strategy documentation
    • Added design system specifications and variant explorations
  • SEO/Technical

    • Improved search engine and AI crawler discoverability
    • Added dynamic sitemap and robots configuration

Smetools added 3 commits May 27, 2026 13:42
Folder structure refactor in preparation for renaming knowcap-landing → knowcap-marketing on GitHub. The repo's role expands from "the landing page" to "all brand + marketing + content + research alongside the website code."

Layout:
- brand/         — VISION, POSITIONING, MOAT, STRATEGY (canonical, moved FROM knowcap-main/docs/), PRODUCT, personas/, decisions/, design-explorations/, legacy/
- research/      — SEO + GEO audits, competitor breakdowns, raw data CSVs from today's MENA research
- campaigns/     — StratDev agency briefs, paid-ad copy, landing-page experiments (absorbed from old knowcap-marketing stub repo)
- content-pipeline/ — Blog drafts pre-publish, ideas, video briefs
- strategy/      — GTM plans
- app/           — Live Next.js website, UNCHANGED (Vercel reads from here)
- app/content/blog/ — 10 ICP blog posts shipped today, untouched

Also lands:
- Today's SEO fixes: app/app/robots.ts overrides Cloudflare's AI-bot block, sitemap.ts lists all routes
- 4 A/B test page variants (a/b/c/d) + odoo-partners landing page
- 5 competitor compare pages (Otter, Read.ai, Fireflies, Fellow, Granola)
- 10 MENA ICP blog posts (1300-1600 words each, GEO-optimized)

Deletes 6 stale ops files + 5 paired PDFs from April 2026 (EMAIL_SETUP, GMAIL_SETUP_GUIDE, KNOWAPP_DIAGNOSIS, TESTING_GUIDE, PITCH_V4.1_CHANGES, PITCH_V5_GPT_UPDATES).

Cross-repo URLs updated: competitor positioning docs now link to knowcap-marketing repo URLs (post-rename target).

Companion PR: knowcap-main slims to engineer-only docs after this lands.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
@vercel

vercel Bot commented Jun 1, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
app Building Building Preview, Comment Jun 1, 2026 8:09pm

@coderabbitai

coderabbitai Bot commented Jun 1, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 46a8a7bd-c7e9-4195-bae8-60611f79c8c1

📥 Commits

Reviewing files that changed from the base of the PR and between 634752d and 840fe08.

⛔ Files ignored due to path filters (16)
  • GMAIL_SETUP_GUIDE.pdf is excluded by !**/*.pdf
  • KNOWAPP_DIAGNOSIS.pdf is excluded by !**/*.pdf
  • PITCH_V4.1_CHANGES.pdf is excluded by !**/*.pdf
  • PITCH_V5_GPT_UPDATES.pdf is excluded by !**/*.pdf
  • TESTING_GUIDE.pdf is excluded by !**/*.pdf
  • agentdb.rvf.lock is excluded by !**/*.lock
  • app/agentdb.rvf.lock is excluded by !**/*.lock
  • app/package-lock.json is excluded by !**/package-lock.json
  • research/data/MENA-LINKEDIN-COUNTS.csv is excluded by !**/*.csv
  • research/data/MENA-SME-COUNTS.csv is excluded by !**/*.csv
  • research/data/trends-mena-arabic.csv is excluded by !**/*.csv
  • research/data/trends-mena-interest.csv is excluded by !**/*.csv
  • research/data/trends-mena-related.csv is excluded by !**/*.csv
  • research/data/trends-mena-rising.csv is excluded by !**/*.csv
  • research/data/youtube-mena-pain-comments.csv is excluded by !**/*.csv
  • research/data/youtube-mena-videos.csv is excluded by !**/*.csv
📒 Files selected for processing (75)
  • .gitignore
  • CLAUDE.md
  • EMAIL_SETUP.md
  • GMAIL_SETUP_GUIDE.md
  • KNOWAPP_DIAGNOSIS.md
  • PITCH_V4.1_CHANGES.md
  • PITCH_V5_GPT_UPDATES.md
  • README.md
  • TESTING_GUIDE.md
  • agentdb.rvf
  • app/agentdb.rvf
  • app/app/compare/knowcap-vs-fellow/page.tsx
  • app/app/compare/knowcap-vs-fireflies/page.tsx
  • app/app/compare/knowcap-vs-granola/page.tsx
  • app/app/compare/knowcap-vs-otter/page.tsx
  • app/app/compare/knowcap-vs-read-ai/page.tsx
  • app/app/for/odoo-partners/page.tsx
  • app/app/robots.ts
  • app/app/sitemap.ts
  • app/components/impeccable/kit.tsx
  • app/components/impeccable/themed-shell.tsx
  • app/components/version-a.tsx
  • app/components/version-b.tsx
  • app/components/version-c.tsx
  • app/components/version-d.tsx
  • app/components/version-odoo-partners.tsx
  • app/content/blog/5-mena-business-youtube-channels-every-odoo-partner-should-know.md
  • app/content/blog/dubai-marketing-agencies-lose-6-hours-per-week.md
  • app/content/blog/from-just-write-a-ticket-to-record-a-30-second-video.md
  • app/content/blog/knowcap-vs-read-ai-otter-fireflies-mena-comparison.md
  • app/content/blog/saudi-pdpl-article-36-audit-firms-ai-meeting-records.md
  • app/content/blog/uae-multilingual-meeting-problem-no-ai-tool-solves.md
  • app/content/blog/what-470-mena-odoo-partners-have-in-common.md
  • app/content/blog/why-eu-ai-act-doesnt-matter-mena-but-ksa-pdpl-does.md
  • app/content/blog/why-saudi-arabia-search-ai-meeting-notes-3-million-percent.md
  • app/content/blog/why-saudis-search-mahdar-egtmaa-89x-more-than-gcc.md
  • brand/MOAT.md
  • brand/POSITIONING.md
  • brand/PRODUCT.md
  • brand/README.md
  • brand/STRATEGY.md
  • brand/VISION.md
  • brand/decisions/2026-05-25-strategic-council.md
  • brand/decisions/2026-05-29-mena-council-readjudication.md
  • brand/design-explorations/v3-variant-library.md
  • brand/design-explorations/v3-variant-operator-light.md
  • brand/design-explorations/v3-variant-operator.md
  • brand/design-explorations/v3-variant-quarterly.md
  • brand/legacy/brand-positioning-feb2026.md
  • brand/legacy/icp-segments-oct2025-stratdev.md
  • brand/personas/PRODUCT-PERSONAS-UPDATE-2026-06-01.md
  • brand/personas/PRODUCT-PERSONAS.md
  • campaigns/landing-pages/education-first-decision.md
  • campaigns/linkedin-outbound.md
  • campaigns/meta-paid-sprint.md
  • campaigns/stratdev/README.md
  • campaigns/stratdev/emails/2026-05-21-relaunch-meeting-request.md
  • campaigns/stratdev/plan.md
  • content-pipeline/README.md
  • content-pipeline/ideas/README.md
  • content-pipeline/ideas/aid-mockumentary/characters.md
  • content-pipeline/ideas/aid-mockumentary/concept.md
  • content-pipeline/ideas/aid-mockumentary/pilot-treatment.md
  • content-pipeline/strategy/marketing-content-plan.md
  • content-pipeline/video/demo-video-strategy.md
  • content-pipeline/video/event-animated-video.md
  • research/README.md
  • research/audits/GEO-AUDIT-2026-06-01.md
  • research/audits/SEO-AUDIT-2026-06-01.md
  • research/competitors/README.md
  • research/competitors/read.ai/architecture.md
  • research/competitors/read.ai/index.md
  • research/competitors/read.ai/positioning.md
  • strategy/gtm-strategy.md
  • strategy/june-2026-gtm-game.md

📝 Walkthrough

Walkthrough

This PR executes a comprehensive marketing site refresh for Knowcap, renaming the repository from knowcap-landing to knowcap-marketing and shipping foundational brand documentation, SEO infrastructure, five competitor comparison landing pages, a new Odoo partners beachhead variant, a shared claims exhibit UI component, eleven MENA-targeted blog posts, competitive research infrastructure, and marketing operation strategy across nearly 130 files.

Changes

Marketing Site and Brand Refresh

Layer / File(s) Summary
Repository identity and documentation refresh
.gitignore, CLAUDE.md, README.md
Rename repository identity from knowcap-landing to knowcap-marketing, document the new structure, list key directories and workflows, and note the split from the main codebase.
SEO and crawler configuration
app/app/robots.ts, app/app/sitemap.ts
Add Next.js route handlers for robots.txt (explicit AI crawler allow rules) and dynamic sitemap with metadata for all marketing surfaces, including /for/* and /compare/* paths.
Core brand vision, strategy, and positioning
brand/VISION.md, brand/STRATEGY.md, brand/POSITIONING.md, brand/MOAT.md, brand/README.md
Establish canonical brand documentation defining the verified-fact institutional memory system, three-loop flywheel strategy (within-org capture, cross-org confirmation network, vertical packs marketplace), buyer profiles and positioning, human verification moat thesis with evidence, and canonical reference structure.
Strategic decisions and persona research
brand/decisions/2026-05-25-strategic-council.md, brand/decisions/2026-05-29-mena-council-readjudication.md, brand/personas/PRODUCT-PERSONAS.md, brand/personas/PRODUCT-PERSONAS-UPDATE-2026-06-01.md
Document two strategic council decisions that set product direction and GTM approach, plus comprehensive MENA SME persona research validating Odoo partners as Phase 1 beachhead with market search data, SME counts, and segment targeting recommendations.
Design variant specifications
brand/design-explorations/v3-variant-library.md, v3-variant-operator.md, v3-variant-operator-light.md, v3-variant-quarterly.md, brand/legacy/*
Define complete v3 design system variant specifications (Library, Operator dark/light, Quarterly) with typography, color palette, layout, motion, and component patterns for each aesthetic overlay.
Competitive research infrastructure and Read.ai analysis
research/competitors/README.md, research/competitors/read.ai/index.md, research/competitors/read.ai/architecture.md, research/competitors/read.ai/positioning.md
Establish competitor research directory structure and detailed Read.ai dossier covering onboarding flow, product surface mapping, pricing, compliance posture, technical architecture comparison, and sales positioning strategies.
SEO and GEO audit reports
research/audits/SEO-AUDIT-2026-06-01.md, research/audits/GEO-AUDIT-2026-06-01.md
Provide comprehensive SEO (38/100 score) and GEO audits with crawlability analysis, schema recommendations, citability guidance, and prioritized remediation roadmaps covering AI crawler blocking, metadata gaps, and structured data.
Shared claims exhibit UI component
app/components/impeccable/kit.tsx (CSS + ClaimsExhibit export), app/components/impeccable/themed-shell.tsx (new faq prop)
Add ClaimsExhibit React component with typed ClaimCard data shape, stacked layout, verification state visualization, and optional bar text, then extend ThemedShell to accept optional faq prop for FAQ override.
Version-specific exhibit integration
app/components/version-a.tsx, version-b.tsx, version-c.tsx, version-d.tsx
Update all four version variants to render ClaimsExhibit instead of static screenshot-based exhibits, preserving animation wrappers and reveal behavior.
Competitor comparison page templates (5 pages)
app/app/compare/knowcap-vs-fellow/page.tsx, knowcap-vs-fireflies/page.tsx, knowcap-vs-granola/page.tsx, knowcap-vs-otter/page.tsx, knowcap-vs-read-ai/page.tsx
Implement five competitor comparison landing pages each with: hero animation, side-by-side comparison table with yes/no indicators and highlighting, FAQ accordion, and inline CSS, all composed into ThemedShell with competitor-specific copy and CTAs.
Odoo partners beachhead variant
app/components/version-odoo-partners.tsx, app/app/for/odoo-partners/page.tsx
Create new VersionOdooPartners component with hero banner, 80-second loop signature section (4-step timeline), Odoo-specific FAQ, and route page with metadata, targeting implementation partners as Phase 1 entry point.
MENA-targeted blog content (11 articles)
app/content/blog/5-mena-business-youtube-channels-*.md, dubai-marketing-agencies-*.md, from-just-write-a-ticket-*.md, knowcap-vs-read-ai-*.md, saudi-pdpl-article-36-*.md, uae-multilingual-*.md, what-470-mena-odoo-*.md, why-eu-ai-act-*.md, why-saudi-arabia-*.md, why-saudis-search-*.md
Add eleven blog posts addressing MENA SME pain points (multilingual meetings, Odoo workflows, regulatory compliance), competitive comparisons, market demand signals, with frontmatter metadata and CTAs.
Marketing operations and campaigns
content-pipeline/README.md, content-pipeline/strategy/marketing-content-plan.md, campaigns/stratdev/*.md, campaigns/linkedin-outbound.md, campaigns/meta-paid-sprint.md, campaigns/landing-pages/education-first-decision.md, strategy/gtm-strategy.md, strategy/june-2026-gtm-game.md, content-pipeline/video/*.md, content-pipeline/ideas/aid-mockumentary/*.md
Document content pipeline workflow, content strategy (3-track painkiller-based matrix, meeting tagging habit), marketing campaigns (Meta 90-day sprint, LinkedIn outbound, StratDev relaunch), June 2026 GTM operating system (weekly binary, milestone levels, anti-cheat rules, measurement ritual), and demo video/event animation production strategies.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

  • Knowcap-V2/knowcap-landing#24: Both PRs extend app/components/impeccable/kit.tsx with new exported UI components and update ThemedShell props, so the changes interact directly at the shared component layer.
  • Knowcap-V2/knowcap-landing#19: Both PRs modify the impeccable kit CSS and exported components, potentially conflicting if similar styling or component additions overlap.

Poem

🐰 A marketing warren takes shape,
Five competitors mapped for escape,
Claims stacked high in verified sight,
Odoo partners join the flight—
Brand and blog lead the way to the gate! 🌟

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch hassan-marketing-reorg

@Smetools
Smetools merged commit d3f8776 into main Jun 1, 2026
1 of 3 checks passed
@Smetools
Smetools deleted the hassan-marketing-reorg branch June 1, 2026 20:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant