> ## Documentation Index
> Fetch the complete documentation index at: https://kasava.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Products

> Organize your software projects with unified work tracking, insights, and documentation

Products are the central organizing concept in Kasava. A Product represents a software project or initiative, bringing together issues, pull requests, documentation, goals, and insights in one place.

## What is a Product?

A Product in Kasava is your command center for a software project. It provides:

* **Unified work tracking** - View issues and PRs from GitHub in one place
* **AI-powered insights** - Automated digests, goal tracking, and decision logging
* **Documentation hub** - PRDs, prototypes, and generated documentation
* **Code intelligence** - Semantic search across linked repositories
* **Activity timeline** - Historical view of all product activity

## Accessing Products

Click "Products" in the sidebar to view your products. Kasava automatically opens your most recent product, or shows the product list if you have multiple.

The URL structure is: `/products/[productId]/[section]`

## Creating a Product

<Steps>
  <Step title="Navigate to Products">
    Click "Products" in the sidebar navigation, or use the keyboard shortcut
  </Step>

  <Step title="Open Create Sheet">
    Click the "New Product" button, or navigate to `/products?action=new`
  </Step>

  <Step title="Enter Product Details">
    * **Name** (required) - A clear name for your product
    * **Description** (optional) - Brief description of what this product is about
  </Step>

  <Step title="Create">
    Click "Create Product" to save. You'll be taken to your new product's summary page.
  </Step>
</Steps>

## Product Navigation

Products use a sidebar navigation system with the following sections:

### Work Sections

* **Summary** - Product overview with context rail showing quick stats and actions
* **Issues** - GitHub issues linked to this product
* **PRs** - Pull requests from linked repositories

### Plan Sections

* **Prototypes** - Design prototypes and mockups
* **PRDs** - Product Requirements Documents
* **Code Search** - Semantic search across linked repositories
* **Roadmap** - Product roadmap and milestones

### Monitor Sections

* **Documentation** - Generated code documentation
* **Timeline** - Activity history across the product
* **Bug Reports** - Bug reports associated with this product
* **Support** - Customer support dashboard

### Analysis Section

The Analysis section (`/products/[id]/analysis`) contains four tabs:

* **Updates** - AI-generated weekly digests and summaries
* **Goals** - Track objectives with progress metrics
* **Decisions** - Log and track important product decisions
* **Insights** - AI-powered analysis, risks, and research

All analysis items can be embedded in Plans using slash commands (`/goal`, `/update`, `/decision`, `/insight`). See [Plan Editor](/docs/features/plans) for details.

### Configuration

* **Repositories** - Link and manage associated repositories
* **[Knowledge](/docs/features/knowledge)** - AI-powered feature discovery and codebase understanding

## Summary Page

The Summary page is your product's home, showing:

* **Product identity** - Icon, name, and tagline
* **Quick actions** - Common operations like generating a digest
* **Health status** - Goals progress, sprint status, and risk indicators
* **Attention items** - Issues needing review
* **Integration insights** - Summaries from connected tools
* **Linked repositories** - Associated code repositories with status
* **Connected platforms** - Integration status
* **Team access** - Team members and roles

## Issues Dashboard

The Issues section provides a dashboard view of GitHub issues:

* View all issues linked to this product
* Filter by status, assignee, and labels
* Click any issue to view details
* Navigate directly to GitHub when needed

## Pull Requests

The PRs section shows pull requests from linked repositories:

* Open, merged, and closed PRs
* Review status indicators
* Author and assignee information
* Direct links to GitHub

## Goals

Track high-level objectives for your Product in the Goals section. Navigate to `/products/[id]/analysis?analysisTab=goals`.

### Goals List

The Goals tab displays all your product goals in a compact list format:

* **Status indicator** - Color-coded dot showing goal health
* **Title** - Goal name (click to view details)
* **Progress bar** - Visual indicator with percentage complete
* **Metrics summary** - Shows how many metrics are on track
* **Days remaining** - Time until target date (or days overdue)
* **Status badge** - Current goal status

### Creating a Goal

<Steps>
  <Step title="Open Goals Section">
    Navigate to your product and click the "Analysis" section, then select the "Goals" tab
  </Step>

  <Step title="Click Add Goal">
    Click the "Add Goal" button in the top right
  </Step>

  <Step title="Enter Goal Details">
    * **Title** - Clear, measurable objective
    * **Description** - Additional context
    * **Target Date** - When this goal should be achieved
  </Step>

  <Step title="Save">
    Click "Create Goal" to save your new goal
  </Step>
</Steps>

### Goal Detail View

Click any goal to open the detail dialog where you can:

* View full goal description and progress
* See all linked metrics with current values
* Add or remove metric connections
* Update goal status
* Edit goal details

### Goal Filters

Filter goals by status using the tabs at the top:

* **All Goals** - Every goal regardless of status (with count)
* **Active** - Currently in progress
* **At Risk** - Goals that may miss their deadline (includes both at-risk and delayed)
* **Completed** - Successfully achieved goals

### Goal Status

| Status    | Color  | Description                           |
| --------- | ------ | ------------------------------------- |
| Active    | Blue   | Goal is in progress                   |
| On Track  | Green  | Progress indicates likely completion  |
| At Risk   | Yellow | Progress is behind schedule           |
| Completed | Green  | Goal was achieved                     |
| Overdue   | Red    | Target date passed without completion |

### Linking Metrics

Goals can automatically pull metrics from connected data sources to track progress:

<Steps>
  <Step title="Open Goal Detail">
    Click on a goal to open the detail dialog
  </Step>

  <Step title="Add Metric">
    Click "Add Metric" in the metrics section
  </Step>

  <Step title="Select Data Source">
    Choose from your connected integrations
  </Step>

  <Step title="Configure Query">
    Set up the metric query based on the data source type
  </Step>
</Steps>

### Supported Metric Sources

| Source                                   | Metrics Available                                                          |
| ---------------------------------------- | -------------------------------------------------------------------------- |
| **[Amplitude](/docs/integrations/amplitude)** | Event segmentation, user counts, session metrics, retention, revenue & LTV |
| **[Mixpanel](/docs/integrations/mixpanel)**   | Event segmentation, funnels, retention, revenue metrics                    |
| **Postgres**                             | Custom SQL queries, visual query builder                                   |
| **Stripe**                               | MRR, ARR, customer counts, subscriptions, churn                            |

<Note>
  Connect data sources in Settings > Integrations before linking them to goals.
</Note>

<Tip>
  **Embed goals in Plans** - Use the `/goal` slash command in the Plan editor to embed a goal widget. This displays goal progress and status directly in your PRDs and planning documents.
</Tip>

## Updates (Digests)

The Updates section shows AI-generated weekly summaries of product activity. Navigate to `/products/[id]/analysis?analysisTab=updates`.

### Layout

The Updates tab uses a sidebar/detail layout:

* **Left sidebar** - List of weekly periods with accomplishment and risk counts
* **Right panel** - Detailed view of the selected update

### Viewing Updates

1. The list shows all generated digests, sorted by date with the latest first
2. Each row displays:
   * Period label (e.g., "Week of Jan 20")
   * "Latest" badge for the most recent digest
   * "Partial" badge if some source data is unavailable
   * Accomplishment count (green checkmark)
   * Risk count (yellow/red warning icon)
3. Click any row to view the full digest in the detail panel

### Generating a Digest

<Steps>
  <Step title="Open Updates">
    Navigate to your product and click the "Analysis" section, then select the "Updates" tab
  </Step>

  <Step title="Click Generate">
    Click the "Generate" button in the sidebar header
  </Step>

  <Step title="Configure Options">
    In the dialog, select:

    * **Time period** - Choose from 7, 14, 30, 60, or 90 days
    * The dialog shows estimated credit usage for each period
  </Step>

  <Step title="Generate">
    Click "Generate Update" and wait for the AI to analyze your commits, PRs, issues, and decisions
  </Step>
</Steps>

### Digest Contents

Each digest includes:

* **Executive Summary** - High-level overview of the period in markdown format
* **Metrics** - Clickable counts of commits, PRs, issues closed, and bugs fixed
  * Click any metric to view a detailed list of the underlying items
* **Accomplishments** - Expandable list of completed work with source references
* **Risks & Blockers** - Issues requiring attention, color-coded by severity (critical/high in red, medium/low in yellow)
* **Upcoming Milestones** - Scheduled deadlines with dates

### Sharing and Exporting

From the digest detail view, click the menu button (three dots) to access:

* **Export as PDF** - Download a formatted PDF document
* **Export as Word** - Download as a .docx file
* **Share Link** - Generate a shareable public URL
* **Send via Email** - Open an email dialog to send the digest to team members

<Tip>
  **Embed updates in Plans** - Use the `/update` slash command in the Plan editor to embed a status update widget. This displays the period summary, accomplishments, and risk indicators directly in your planning documents.
</Tip>

## Decisions

Document and track important product decisions in the Decisions section. Navigate to `/products/[id]/analysis?analysisTab=decisions`.

### Decisions List

The Decisions tab displays all logged decisions with:

* **Status indicator** - Color-coded dot showing outcome status
* **Summary** - Brief decision description (click to view details)
* **Decision maker** - Who made the final decision
* **Alternatives count** - Number of alternatives considered
* **Type badge** - Category of decision
* **AI indicator** - Robot icon if extracted automatically by AI
* **Status badge** - Current outcome status
* **Time** - When the decision was made

### Search and Filter

Use the toolbar to find specific decisions:

* **Search** - Type to search decision summaries
* **Type filter** - Filter by decision category
* **Stats** - View average implementation time

### Logging a Decision

<Steps>
  <Step title="Open Decisions">
    Navigate to your product and click the "Analysis" section, then select the "Decisions" tab
  </Step>

  <Step title="Click Log Decision">
    Click the "Log Decision" button in the top right
  </Step>

  <Step title="Select Type">
    Choose the decision category:

    * **Architecture** - System design and structure decisions
    * **Technology** - Tool, framework, or library choices
    * **Feature** - Product feature decisions
    * **Process** - Workflow and methodology decisions
    * **Scope** - Project scope changes
  </Step>

  <Step title="Enter Details">
    * **Summary** - Brief description of the decision
    * **Rationale** - Why this decision was made
    * **Decision Maker** - Who made the final call
    * **Alternatives Considered** - Other options that were evaluated
  </Step>

  <Step title="Save">
    Click "Log Decision" to save with timestamp
  </Step>
</Steps>

### Decision Detail View

Click any decision to open the detail sheet where you can:

* View the full decision summary and rationale
* See all alternatives that were considered
* Review the decision context and related discussions
* Update the outcome status

### Decision Status

| Status       | Color  | Description                                 |
| ------------ | ------ | ------------------------------------------- |
| Implemented  | Green  | Decision has been put into action           |
| Pending      | Yellow | Decision made but not yet implemented       |
| Needs Review | Yellow | AI-extracted decision awaiting verification |
| Abandoned    | Red    | Decision was made but later dropped         |
| Superseded   | Gray   | Replaced by a newer decision                |

### AI-Extracted Decisions

Kasava can automatically extract decisions from conversations and discussions. These are marked with a robot icon and initially show "Needs Review" status until verified.

<Tip>
  Review AI-extracted decisions regularly to ensure accuracy and update their status once implemented.
</Tip>

<Tip>
  **Embed decisions in Plans** - Use the `/decision` slash command in the Plan editor to embed a decision widget. This displays the decision outcome, rationale, and decision maker directly in your PRDs and architecture documents.
</Tip>

## Insights (AI Analysis)

The Insights section displays AI-generated analysis of your product's health, risks, and opportunities. Navigate to `/products/[id]/analysis?analysisTab=insights`.

### Insights List

The Insights tab shows AI-generated observations about your product:

* **Priority indicator** - Color-coded dot (critical, high, medium, low)
* **Expand chevron** - Click to expand and see full details
* **Type icon** - Visual indicator of insight category
* **Title** - Brief insight summary
* **Metrics** - Key numbers related to the insight
* **Type badge** - Category label
* **Date** - When the insight was generated
* **Actions** - Acknowledge or delete buttons

### Filtering Insights

Use the filter bar to focus on specific insights:

* **Type filter** - Filter by insight category
* **Priority filter** - Filter by severity level
* **Show acknowledged** - Toggle to show/hide reviewed insights

### Insight Types

| Type      | Icon        | Description                                       |
| --------- | ----------- | ------------------------------------------------- |
| Velocity  | Trending up | Development speed and throughput metrics          |
| Quality   | Shield      | Code quality and test coverage indicators         |
| Risk      | Warning     | Potential issues and risky changes                |
| Team      | Users       | Team dynamics and workload distribution           |
| Tech Debt | Wrench      | Technical debt and maintenance concerns           |
| Sales     | Phone       | Sales health insights (requires Gong integration) |

### Insight Priorities

| Priority | Color  | Description                       |
| -------- | ------ | --------------------------------- |
| Critical | Red    | Requires immediate attention      |
| High     | Orange | Should be addressed soon          |
| Medium   | Purple | Worth reviewing when time permits |
| Low      | Gray   | Informational, no action required |

### Viewing Insight Details

Click any insight row to expand it and see:

* **Full description** - Detailed explanation of the insight
* **All metrics** - Complete list of relevant measurements
* **Related entities** - Links to PRs, commits, or issues involved
* **Suggested actions** - Recommendations for addressing the insight (for risk insights)
* **Affected files** - Files involved with expandable code diffs (for risk insights)

### Managing Insights

* **Acknowledge** - Click the eye icon to mark an insight as reviewed (dimmed in the list)
* **Delete** - Click the trash icon to remove an insight permanently
* **View Details** - For risk insights, click "View Details" for an expanded sheet view

### Generating New Insights

<Steps>
  <Step title="Click Rerun Analysis">
    Click the "Rerun Analysis" button in the filter bar
  </Step>

  <Step title="Select Analysis Period">
    Choose how far back to analyze:

    * **7 days** - Quick analysis (\~50-100 credits)
    * **14 days** - Standard analysis (\~100-200 credits)
    * **30 days** - Comprehensive analysis (\~200-400 credits)
    * **60 days** - Extended analysis (\~400-800 credits)
    * **90 days** - Deep analysis (\~800-1,200 credits)
  </Step>

  <Step title="Run Analysis">
    Click "Run Analysis" to generate new insights
  </Step>
</Steps>

<Note>
  Credit usage depends on repository size and commit volume. Longer periods provide more context but use more credits.
</Note>

### Ask a Question

In addition to automated insights, you can ask specific questions about your product:

<Steps>
  <Step title="Click Ask a Question">
    Click the "Ask a question" button in the filter bar
  </Step>

  <Step title="Select Data Sources">
    Choose what to analyze:

    * Commits
    * Pull Requests
    * Issues
    * Status Updates
  </Step>

  <Step title="Enter Your Question">
    Examples:

    * "What features were shipped last week?"
    * "Who worked on the authentication system?"
    * "What blockers have been mentioned?"
  </Step>

  <Step title="Get Answer">
    The AI provides a contextual answer with references
  </Step>
</Steps>

<Tip>
  Select only relevant data sources for more focused answers and faster responses.
</Tip>

<Tip>
  **Embed insights in Plans** - Use the `/insight` slash command in the Plan editor to embed an insight widget. This displays the insight severity, category, and suggested actions directly in your planning documents for context.
</Tip>

## Repositories

Link repositories to your product in the Repositories section. Navigate to `/products/[id]/repositories`.

### Linking Repositories

<Steps>
  <Step title="Open Repositories">
    Click "Repositories" in the product sidebar
  </Step>

  <Step title="Click Link Repository">
    Click the "Link Repository" button
  </Step>

  <Step title="Select Repositories">
    Choose from your indexed repositories
  </Step>

  <Step title="Assign Roles (Optional)">
    Specify repository roles (primary, supporting, etc.)
  </Step>
</Steps>

Linked repositories enable:

* **Code Search** - Semantic search across the codebase
* **Activity Tracking** - Commits and PRs appear in the timeline
* **AI Context** - AI features understand the code structure
* **Documentation** - Generate and view code documentation

## Code Search

Search across linked repositories using semantic search. Navigate to `/products/[id]/code-search`.

* Enter natural language queries
* Results ranked by relevance
* View code snippets in context
* Navigate directly to files in repositories

## Documentation

View and manage generated documentation in the Documentation section. Navigate to `/products/[id]/documentation`.

* Auto-generated API documentation
* Architecture overviews
* Component documentation
* Function and method references

## Timeline

View all product activity in chronological order. Navigate to `/products/[id]/timeline`.

* Commits from linked repositories
* Issues created and closed
* Pull requests opened and merged
* Digests generated
* Decisions logged

## Bug Reports

View bug reports associated with this product. Navigate to `/products/[id]/bug-reports`.

* Filter by severity (high, medium, low)
* View bug details including screenshots and environment info
* Link to GitHub issues if created
* Navigate to full bug reports page

## Prototypes

Manage design prototypes and mockups. Navigate to `/products/[id]/prototypes`.

* Link to Figma designs
* Reference v0 prototypes
* Attach design specifications
* Track design iterations

## PRDs (Plans)

Access Product Requirements Documents for this product. Navigate to `/products/[id]/prds`.

* View all PRDs associated with this product
* Create new PRDs directly from the product
* Track PRD status and approvals

## Best Practices

<Tip>
  **One Product per major initiative** - Create separate Products for distinct projects or features to keep work organized.
</Tip>

<Tip>
  **Link all relevant repositories** - The more repositories you link, the better the AI understands your codebase.
</Tip>

<Tip>
  **Run AI Discovery** - Use the Knowledge section to let AI discover your product's feature areas. This improves commit classification and digest quality.
</Tip>

<Tip>
  **Generate digests regularly** - Weekly digests help track progress and identify issues early.
</Tip>

<Tip>
  **Document decisions** - Important decisions are easy to forget; logging them preserves context for future reference.
</Tip>

<Tip>
  **Set measurable goals** - Connect goals to data sources for automatic progress tracking.
</Tip>

## Related

<CardGroup cols={2}>
  <Card title="Dashboard" icon="gauge" href="/docs/features/dashboard">
    Your home for work items and updates
  </Card>

  <Card title="Product Knowledge" icon="brain" href="/docs/features/knowledge">
    AI-powered feature discovery and codebase understanding
  </Card>

  <Card title="PRD Management" icon="file-lines" href="/docs/features/prds">
    Create and manage Product Requirements Documents
  </Card>

  <Card title="Integrations" icon="plug" href="/docs/integrations/overview">
    Connect GitHub and other platforms
  </Card>
</CardGroup>