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
Enter Product Details
- Name (required) - A clear name for your product
- Description (optional) - Brief description of what this product is about
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
/goal, /update, /decision, /insight). See Plan Editor for details.
Configuration
- Repositories - Link and manage associated repositories
- 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
Open Goals Section
Navigate to your product and click the “Analysis” section, then select the “Goals” tab
Enter Goal Details
- Title - Clear, measurable objective
- Description - Additional context
- Target Date - When this goal should be achieved
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:Supported Metric Sources
Connect data sources in Settings > Integrations before linking them to goals.
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
- The list shows all generated digests, sorted by date with the latest first
- 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)
- Click any row to view the full digest in the detail panel
Generating a Digest
Open Updates
Navigate to your product and click the “Analysis” section, then select the “Updates” tab
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
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
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
Open Decisions
Navigate to your product and click the “Analysis” section, then select the “Decisions” tab
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
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
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.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) |
| Incidents | Siren | Incident impact analysis (requires PagerDuty 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
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)
Credit usage depends on repository size and commit volume. Longer periods provide more context but use more credits.
Ask a Question
In addition to automated insights, you can ask specific questions about your product:Enter Your Question
Examples:
- “What features were shipped last week?”
- “Who worked on the authentication system?”
- “What blockers have been mentioned?”
Repositories
Link repositories to your product in the Repositories section. Navigate to/products/[id]/repositories.
Linking Repositories
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