Documentation

Create your account, generate your first spec, and learn the basics in under 5 minutes.

• Creating your Shivo account

  Sign up with email and start generating specs for free.

• Generating your first PRD

  Walk through the generate page — enter a title, description, and features to produce a full PRD.

• Understanding spec types

  Learn the difference between PRD, TDD, SDD, API, Security, and Compliance documents.

• Navigating the dashboard

  Overview of stats, quick actions, and recent specs on your home screen.

Deep dives into each spec type, input best practices, and how the AI structures output.

• Writing effective descriptions

  Tips on how to provide enough context for the AI to generate comprehensive specs.

• PRD generation guide

  What goes into a Product Requirements Document and how Shivo structures each section.

• Technical Design Documents

  Architecture, data models, API contracts, and deployment plans generated automatically.

• API Specification output

  RESTful endpoint documentation with schemas, auth flows, and example payloads.

How Shivo detects ambiguity, validates testability, and ensures spec completeness.

• Ambiguity detection explained

  How the AI identifies vague language, contradictions, and implicit assumptions.

• Testability validation

  Ensuring every requirement has measurable, verifiable acceptance criteria.

• Completeness scoring

  How spec quality scores are calculated and what each metric means.

• Fixing flagged requirements

  Step-by-step process to resolve ambiguous or untestable requirements.

Share specs with your team, run review cycles, and get stakeholder sign-off.

• Submitting specs for review

  How to move a spec from draft to review and assign stakeholders.

• Approval workflows

  Configure approval gates, add feedback, and track review status.

• Version history

  View, compare, and restore previous versions of any specification.

• Team permissions

  Role-based access control for managing who can edit, review, and approve.

Export specs to Markdown, JSON, or push to your project management tools.

• Exporting to Markdown

  Download any spec as a well-formatted Markdown file for docs or repos.

• Jira integration

  Push user stories and requirements directly to your Jira board.

• Linear integration

  Sync specs and tasks with your Linear workspace.

• Notion export

  Export formatted specs directly into your Notion workspace.

Track spec quality, manage your profile, and configure your workspace.

• Requirements analytics

  Track ambiguity trends, quality scores, and review cycle times.

• Profile and account settings

  Update your name, email, company, and notification preferences.

• Theme and appearance

  Switch between light, dark, and system themes.

• Exporting all your data

  Download a complete JSON backup of all your specs and settings.