AD Competitive Intelligence feature-ux-spec
feature-ux-spec artifact · for AD Competitive Intelligence · status draft
No items captured.
feature-ux-spec artifact · for AD Competitive Intelligence · status draft
No explicit evidence field yet. Require tests, screenshots, linked PRs, or reviewed outputs before marking complete.
No section body captured.
Machine-readable source fields
KnowledgeVault
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.
/Users/justinking/Vaults/Projects/KnowledgeVault
RedKey stores Studio artifacts, agent orchestration, and shared platform infrastructure; product code should graduate into this standalone KnowledgeVault repo.
phase-1
Production Evidence Pipeline, Review Workflow, and AD Intelligence Product
draft
No items captured.
| id | name | scope | scenarios | edge cases | error states |
|---|---|---|---|---|---|
| FEAT-1.0 | Executive opening frame | The first screen explains the product before analysis details: what BezelIQ monitored, why those signals matter, and the value to AD. It does not bury positioning in a later About page. | - First-time AD executive opens the tool: name: string, then: string, when: string, given: string - User chooses next action: name: string, then: string, when: string, given: string | - item: case: string, expected: string | - item: response: string, condition: string |
| FEAT-1.1 | Configured competitor sources | Admin can configure Grainger and Fastenal sources for careers, newsroom, and website monitoring; this does not include paid LinkedIn or SEC automation. | - Create a source: name: string, then: string, when: string, given: string - Disable a source: name: string, then: string, when: string, given: string | - item: case: string, expected: string | - item: response: string, condition: string |
| FEAT-1.2 | Observation collection | Collect and deduplicate public page/listing text from configured sources; this does not try to infer strategy yet. | - Collect careers page: name: string, then: string, when: string, given: string - Duplicate content: name: string, then: string, when: string, given: string | - item: case: string, expected: string | - item: response: string, condition: string |
| FEAT-1.3 | Signal classification and review | Convert observations into draft strategic signals with evidence; humans approve before publication. | - Classify AI job posting: name: string, then: string, when: string, given: string - Review signal: name: string, then: string, when: string, given: string | - item: case: string, expected: string | - item: response: string, condition: string |
| FEAT-1.4 | Executive brief and Ask AD export | Generate a concise approved-signal brief and structured context block for Ask AD. | - Generate weekly brief: name: string, then: string, when: string, given: string - Ask AD context: name: string, then: string, when: string, given: string | - item: case: string, expected: string | - item: response: string, condition: string |
| FEAT-1.5 | Production operations and freshness monitoring | Operators can see collection run status, source freshness, and failures; this is required for production readiness. | - Source becomes stale: name: string, then: string, when: string, given: string | - item: case: string, expected: string | - item: response: string, condition: string |
| FEAT-1.6 | AD-facing production workspace | AD users can read approved signals, competitor profiles, evidence, and briefs in a polished production surface. | - Read competitor profile: name: string, then: string, when: string, given: string | - item: case: string, expected: string | - item: response: string, condition: string |
- Separate observed fact from inference in every generated output.
- Never present third-party job board snippets as first-party evidence.
- Prefer fewer high-quality signals over comprehensive noisy feeds.
- AD-facing screens must lead with explanation and strategic value before operational detail.
- Charts/tables are supporting evidence, not the opening narrative.
KnowledgeVault AD Suite
| id | name | purpose |
|---|---|---|
| knowledgevault-core | KnowledgeVault Core | Capture retiring expert and product knowledge into governed, searchable assets. |
| knowledgevault-app | KnowledgeVault App | Production application surface for capture, search, dashboards, admin, and AD/member workflows. |
| executive-seo | Executive SEO | Distributor digital visibility intelligence and CEO-level opportunity prioritization. |
| competitive-intelligence | AD Competitive Intelligence | Monitor Grainger and Fastenal public signals, produce reviewed analytics/briefs, and feed Ask AD. |
| ask-ad | Ask AD | Suite-level cited advisor across KnowledgeVault, SEO, and Competitive Intelligence. |
/Users/justinking/Vaults/Projects/KnowledgeVault
AD SEO app implementation/artifacts currently live outside this repo and should be migrated or integrated as a product module before production packaging.
/Users/justinking/Vaults/Projects/redk3y/apps/knowledgevault
No items captured.
1.0