AD Competitive Intelligence decomp
internal prototype · canonical JSON + Dreamborn Forge HTML
internal generated
decomp · supabase_json

AD Competitive Intelligence decomp

decomp artifact · for AD Competitive Intelligence · status draft

Planning Surface

Use this to decide what happens next.

Status

draft

open questions

No items captured.

Agent Handoff
Start Here

decomp artifact · for AD Competitive Intelligence · status draft

Completion Evidence

No explicit evidence field yet. Require tests, screenshots, linked PRs, or reviewed outputs before marking complete.

Open Questions

No section body captured.

Structured Payload

Machine-readable source fields

repo
name

KnowledgeVault

ownership

Standalone production AD suite repo. It should contain KnowledgeVault core, the production KV app, Executive SEO, AD Competitive Intelligence/analytics, and Ask AD integration. RedKey remains platform/orchestration, not the product implementation home.

local path

/Users/justinking/Vaults/Projects/KnowledgeVault

relationship to redkey

RedKey stores Studio artifacts, agent orchestration, and shared platform infrastructure; product code should graduate into this standalone KnowledgeVault repo.

modules
idnamestatuspurposedepends ondeliverables
M-00Production Source and Evidence FoundationdraftCreate production schema, source registry, evidence audit model, source authority labels, and operational controls.- schema migration - source registry seed - evidence normalization contract - dedupe/hash utilities - audit fields
M-01Grainger and Fastenal CollectorsdraftCollect first-party career, service, and strategic website evidence for Grainger and Fastenal on a repeatable schedule.- M-00- Grainger careers collector - Fastenal careers collector - Fastenal onsite/vending/service collector - collection run records - MSC parser note for V1b
M-02News, Press, Investor, and Filing SourcesdraftExpand from careers/service pages into production-grade source coverage across press releases, investor material, SEC/company filings where available, and reputable trade news.- M-00- news/press collectors - investor/filing collector plan and first implementation - source freshness checks - source failure logging
M-03Signal Intelligence EnginedraftClassify observations into strategic signals with evidence, confidence, source authority weighting, and explicit observed-fact versus inference separation.- M-00 - M-01 - M-02- classification service - taxonomy - confidence rules - signal dedupe - evidence score
M-04Analyst Review and Governance WorkflowdraftGive BezelIQ/AD operators a review queue to approve, reject, edit, and audit signals before publication.- M-03- review API - review states - audit log - approval rules - operator UI contract
M-05AD Executive Intelligence Workspace and Opening NarrativedraftBuild the sellable AD-facing workspace with an immediate executive opening frame that explains what was monitored, why it matters, and the value to AD before showing dashboards.- M-04- executive dashboard - competitor pages - theme views - evidence drawers - brief view - first-screen executive opening frame - What we did / Why we did it / Value to AD narrative - clear next actions to brief, signals, and Ask AD
M-06Brief Generation and DeliverydraftGenerate production weekly/monthly intelligence briefs with citations, watch items, and AD/member implications, then deliver/export them reliably.- M-04 - M-05- brief generator - PDF/HTML export - email delivery option - brief archive - approval gate
M-07Ask AD Competitive ContextdraftExpose approved competitive intelligence as retrievable, cited context for Ask AD without leaking drafts or low-confidence material.- M-04 - M-06- Ask AD context endpoint - retrieval schema - prompt contracts - citation-preserving answers
M-08Production Operations, Security, and ReleasedraftHarden the system for a sellable AD product with auth, monitoring, scheduled jobs, error handling, backup/retry strategy, and release verification.- M-00 - M-01 - M-02 - M-03 - M-04 - M-05 - M-06 - M-07- auth/RLS hardening - job scheduler - monitoring dashboard - runbooks - load/smoke tests - production deployment checklist
project
id

ad-competitive-intelligence

name

AD Competitive Intelligence

client id

ad

strategy

Build a production product in modules. Phases are implementation sequencing, not prototype scope. The first production release must include repeatable collection, evidence persistence, governed signal review, executive workspace, brief generation, Ask AD context, auth, monitoring, and release verification. Build in standalone repo /Users/justinking/Vaults/Projects/KnowledgeVault; KnowledgeVault is suite context, not the implementation directory. Implementation target is the standalone KnowledgeVault repo; AD CI remains a distinct sellable product module inside that repo.

product suite
name

KnowledgeVault AD Suite

products
idnamepurpose
knowledgevault-coreKnowledgeVault CoreCapture retiring expert and product knowledge into governed, searchable assets.
knowledgevault-appKnowledgeVault AppProduction application surface for capture, search, dashboards, admin, and AD/member workflows.
executive-seoExecutive SEODistributor digital visibility intelligence and CEO-level opportunity prioritization.
competitive-intelligenceAD Competitive IntelligenceMonitor Grainger and Fastenal public signals, produce reviewed analytics/briefs, and feed Ask AD.
ask-adAsk ADSuite-level cited advisor across KnowledgeVault, SEO, and Competitive Intelligence.
repo path

/Users/justinking/Vaults/Projects/KnowledgeVault

migration source
seo app

AD SEO app implementation/artifacts currently live outside this repo and should be migrated or integrated as a product module before production packaging.

knowledgevault app

/Users/justinking/Vaults/Projects/redk3y/apps/knowledgevault

open questions

No items captured.

schema version

1.0

execution order
  • M-00
  • M-01
  • M-02
  • M-03
  • M-04
  • M-05
  • M-06
  • M-07
  • M-08
parallel groups
  • Item
    - M-00
  • Item
    - M-01 - M-02
  • Item
    - M-03
  • Item
    - M-04
  • Item
    - M-05
  • Item
    - M-06 - M-07
  • Item
    - M-08
suite migration
objective

Turn the standalone KnowledgeVault repo into the complete AD product suite repo before deep AD CI implementation.

immediate prework
  • Audit active redk3y/apps/knowledgevault implementation and migrate/reconcile it into standalone KnowledgeVault repo.
  • Identify AD SEO implementation source and decide copy/import/link strategy.
  • Define suite navigation and shared design/auth/data boundaries.
  • Then start AD CI M-00 in the standalone repo.
required products
idnamepurpose
knowledgevault-coreKnowledgeVault CoreCapture retiring expert and product knowledge into governed, searchable assets.
knowledgevault-appKnowledgeVault AppProduction application surface for capture, search, dashboards, admin, and AD/member workflows.
executive-seoExecutive SEODistributor digital visibility intelligence and CEO-level opportunity prioritization.
competitive-intelligenceAD Competitive IntelligenceMonitor Grainger and Fastenal public signals, produce reviewed analytics/briefs, and feed Ask AD.
ask-adAsk ADSuite-level cited advisor across KnowledgeVault, SEO, and Competitive Intelligence.