business-context

Files (1)

• SKILL.md

SKILL.md (first lines)

# Skill: Business Context Browser

## Model conventions

This skill is version-aware. Before starting, apply `skills/MODEL_CONVENTIONS.md` for the model you are: query data rather than inferring numbers (§B, §E), follow instruction scope literally (§A), let response length follow task complexity (§C), and run intelligence-sensitive analysis at high/xhigh effort (§D).

> Interactive browser for your organization's knowledge system. Explore terms,
> products, metrics, objectives, and team structure. Also optionally crawl Notion
> workspaces to extract and populate business context.

## Trigger
Invoked as `/business` or `/business {subcommand}` or `/notion-ingest`

## Prerequisites
- organization context must exist at `<workspace>/knowledge/organizations/{org}/`
- Read `<workspace>/knowledge/setup-state.yaml` to find active organization
- If no org configured: "No organization context found. Run `/setup` Phase 3 to configure business context, or create one manually at `<workspace>/knowledge/organizations/{name}/`."

## Subcommands

### `/business` (no args) — Overview
Display a summary of available business context:

```
Business Context: {org_name}

  Glossary:    {n} terms defined
  Products:    {n} products cataloged
  Metrics:     {n} metrics specified
  Objectives:  {n} OKRs/goals tracked
  Teams:       {n} teams mapped

Type /business {category} for details.
```

**Implementation:**
1. Read `<workspace>/knowledge/organizations/{org}/manifest.yaml` for org name
2. Use `helpers/business_context.py` → `load_business_context(org_path)`
3. Count entries in each category
4. Display summary table

### `/business glossary` — Browse Terms
Display all business term definitions:

```
Glossary ({n} terms)

  Term              | Definition                          | Category
  ──────────────────|─────────────────────────────────────|──────────
  Active User       | User with ≥1 session in last 30d    | Engagement
  Churn             | No activity for 60+ days            | Retention
  ...
```

**Implementation:**
1. Load from `business/glossary/terms.yaml`
2. Sort alphabetically
3. Show first 20 terms; offer "Show all" if more
4. If empty: "No glossary terms defined. Add terms to `<workspace>/knowledge/organizations/{org}/business/glossary/terms.yaml`."

### `/business products` — View Product Catalog
Display product hierarchy:

```
Products ({n} total)

  Product           | Category    | Status    | Key Metrics
  ──────────────────|─────────────|───────────|────────────
  Core Platform     | SaaS        | Active    | MAU, Revenue
  Mobile App        | Mobile      | Active    | DAU, Retention
  ...
```

**Implementation:**
1. Load from `business/products/index.yaml`
2. Display in table format
3. If empty: "No products defined. Add products to `<workspace>/knowledge/organizations/{org}/business/products/index.yaml`."

### `/business metrics` — Inspect Metric Definitions
Display metric dictionary:

```
Metrics ({n} defined)

  Metric            | Type        | Formula/Definition        | Owner
  ──────────────────|─────────────|───────────────────────────|──────
  Conversion Rate   | Ratio       | signups / visitors        | Growth
  MRR               | Currency    | SUM(active_subscriptions) | Finance
  ...
```

**Implementation:**
1. Load from `business/metrics/index.yaml`
2. Cross-reference with `<workspace>/knowledge/datasets/{active}/metrics/` if available
3. Show definition, type, owner
4. If empty: "No metrics defined. Use `/metrics add` to define metrics, or add to `<workspace>/knowledge/organizations/{org}/business/metrics/index.yaml`."

### `/business objectives` — Review OKRs/Goals
Display current objectives:

```
Objectives ({n} active)

  Objective                      | Key Results              | Status
  ───────────────────────────────|──────────────────────────|────────
  Increase activation rate       | +15% by Q2               | On Track
  Reduce churn                   | <5% monthly by Q3        | At Risk
  ...
```

**Implementation:**
1. Load from `business/objectives/index.yaml`
2. Show status indicators (On Track / At Risk / Behind)
3. If empty: "No objectives defined. Add OKRs to `<workspace>/knowledge/organizations/{org}/business/objectives/index.yaml`."

### `/business teams` — Show Team Structure
Display team organization:

```

From Amar1404/AI_ANALYST, MIT.

More from Amar1404/AI_ANALYST