Product Management

Master router for CircleTel's product management skills system. Provides access to supplier catalogues, market analysis, documentation generation, and lifecycle tracking.

When This Skill Activates

This skill automatically activates when you:

•Ask about product management workflows
•Want to browse supplier catalogues (Scoop, MiRO, Nology)
•Want to view wholesale provider services (MTN, Echo SP, DFA, Arlan)
•Need to analyze product-market fit
•Want to generate product documentation
•Need to track product lifecycle stages
•Say /product to see the menu

Keywords: product, product management, supplier, catalogue, wholesale, MTN, Echo SP, DFA, Arlan, market fit, product docs, product lifecycle

Supplier Types

Type	Suppliers	Focus
Hardware	Scoop, MiRO, Nology, Rectron	CPE, routers, APs, networking, enterprise hardware
Wholesale	MTN, Echo SP, DFA, Arlan	Connectivity, infrastructure, services

Available Sub-Skills

Skill	Command	Purpose
Search Suppliers	`/product-search`	Live search supplier websites using Firecrawl — specs, pricing, datasheets
Browse Suppliers	`/product-browse`	Filter synced DB catalogues, identify product candidates
Wholesale Providers	`/product-wholesale`	View wholesale provider services and contracts
Market-Fit Analysis	`/product-analyze`	Competitor comparison, margin calc, go/no-go recommendation
Doc Generation	`/product-docs`	Generate commercial spec, business rules, functional spec
Product Lifecycle	`/product-lifecycle`	Track IDEA → DEVELOPMENT → ACTIVE → SUNSET stages

Search vs Browse: /product-search queries live websites in real time (Firecrawl). /product-browse queries the Supabase DB (synced catalogue). Use search for discovery and Rectron; use browse for known products.

Wholesale Providers

Provider	Services	Reference
MTN Wholesale	FWB (Tarana), FTTH	`references/mtn-wholesale.md`
Echo SP	Managed BNG, IP Transit	`references/echo-sp.md`
DFA	Dark Fibre, Metro Ethernet	`references/dfa.md`
Arlan	MTN LTE, 5G, IoT (reseller)	`references/arlan.md`

Quick Start Menu

code

/product              → This menu (product management overview)
/product-search       → Live search supplier websites (Firecrawl-powered)
/product-browse       → Browse synced DB catalogues with filters
/product-wholesale    → Browse wholesale provider services and contracts
/product-analyze      → Analyze product-market fit
/product-docs         → Generate product documentation
/product-lifecycle    → View/update product lifecycle status

Workflow Overview

code

┌─────────────────────────────────────────────────────────────────┐
│                   Product Management Workflow                    │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  1. DISCOVER           2. ANALYZE           3. DOCUMENT          │
│  ┌──────────────┐     ┌──────────────┐     ┌──────────────┐     │
│  │ Browse       │ ──▶ │ Market-Fit   │ ──▶ │ Generate     │     │
│  │ Suppliers    │     │ Analysis     │     │ Docs         │     │
│  └──────────────┘     └──────────────┘     └──────────────┘     │
│        ▲                    │                    │               │
│        │                    ▼                    ▼               │
│        │              ┌──────────────┐     ┌──────────────┐     │
│        │              │ GO/NO-GO     │     │ Commercial   │     │
│        │              │ Decision     │     │ Spec + BRD   │     │
│        │              └──────────────┘     │ + FSD        │     │
│        │                                   └──────────────┘     │
│        │                                          │              │
│        │                    4. TRACK              ▼              │
│        │              ┌──────────────┐     ┌──────────────┐     │
│        └───────────── │ Lifecycle    │ ◀── │ Launch       │     │
│                       │ Management   │     │ Product      │     │
│                       └──────────────┘     └──────────────┘     │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

Data Sources

Supplier Catalogues

•Scoop Distribution: Networking, security, infrastructure
•MiRO Distribution: Hardware, CPE, wireless equipment
•Nology: Enterprise hardware, servers, storage

Infrastructure

•lib/suppliers/ - Supplier sync services and parsers
•lib/suppliers/ai-enrichment.ts - Gemini AI for product specs
•/api/admin/suppliers/products/ - Product query API

References

•references/competitor-benchmarks.md - SA ISP pricing benchmarks
•references/doc-templates.md - Documentation structure patterns
•references/wholesale-providers.md - Wholesale provider overview
•references/mtn-wholesale.md - MTN FWB and FTTH services
•references/echo-sp.md - Echo SP managed services
•references/dfa.md - DFA fibre infrastructure
•references/arlan.md - Arlan MTN reseller services

Product Documentation

•products/ - Existing product specs (30+ documents)
•products/research/ - Competitive analysis

Typical Use Cases

0. Live Product Search (NEW)

code

User: "Find an outdoor 5GHz AP across all suppliers"
→ Use /product-search "outdoor access point 5GHz"
→ Firecrawl searches Scoop, MiRO, Nology, Rectron live
→ Returns comparison table with pricing, stock, datasheet links

User: "What does Rectron have for UPS under R5,000?"
→ Use /product-search --supplier rectron "UPS" --max-price 5000

1. New Product Discovery

code

User: "What routers does MiRO have for under R5,000?"
→ Use /product-browse with filters: supplier=miro, category=router, max_price=5000
  (DB query — fast, from synced catalogue)
  OR
→ Use /product-search --supplier miro router
  (live website search — more current but slower)

2. Product Viability Check

code

User: "Is there margin in reselling the Reyee RG-EG105GW?"
→ Use /product-analyze with product SKU
→ Returns competitor comparison, margin calc, go/no-go

3. Launch New Product

code

User: "Create documentation for our new CloudWiFi tier"
→ Use /product-docs to generate:
  - Commercial Product Spec (CPS)
  - Business Rules Document (BRD)
  - Functional Specification (FSD)

4. Track Product Status

code

User: "What products are in development?"
→ Use /product-lifecycle to view dashboard
→ Shows IDEA → DEVELOPMENT → ACTIVE → SUNSET pipeline

Integration Points

Database Tables

•supplier_products - Synced supplier catalogue
•product_enrichment - AI-generated specs and features
•products (future) - CircleTel product registry

AI Services

•Google Gemini for product enrichment
•Structured output for specs extraction

External APIs

•Supplier catalogue APIs (Scoop, MiRO, Nology)
•Coverage APIs for technology availability

Best Practices

•Always check supplier stock before product analysis
•Run margin calculations with current wholesale costs
•Include competitor benchmarks in market-fit analysis
•Use templates for consistent documentation
•Track lifecycle stage for all active products

Related Resources

Resource	Location
Competitor Analysis	`products/research/SA_ISP_Competitive_Landscape_Analysis_2025.md`
Product Portfolio	Memory: `product-portfolio.md`
Supplier Types	`lib/suppliers/types.ts`
AI Enrichment	`lib/suppliers/ai-enrichment.ts`
SkyFibre Specs	`products/connectivity/fixed-wireless/`

Version: 1.1.0 Last Updated: 2026-04-03 Maintained By: CircleTel Product Strategy