Sign In Get Started Free

Documentation

Everything you need to know about AJAIA - from getting started to advanced features.

Quick Start Guide

Welcome to AJAIA! This guide will help you get up and running in just a few minutes.

What You'll Need

  • An AJAIA account (sign up at ajaia.app)
  • Access to Azure DevOps and/or Jira (with admin or project permissions)
  • A Personal Access Token (PAT) from your project management platform

Quick Start Steps

  1. Create your account
    Sign up for a free 7-day trial. You'll get full access to all features during the trial period.
  2. Connect your platform
    In Settings, add your Azure DevOps or Jira credentials. You'll need your organization URL and a Personal Access Token.
  3. Create your first breakdown
    Navigate to the Dashboard, paste an epic description, and click "Generate Breakdown". AJAIA will create user stories, tasks, and test cases automatically.
  4. Review and push
    Review the generated work items, make any adjustments, then push them directly to your project management tool.

Pro Tip: The more detailed your epic description, the better the AI breakdown. Include acceptance criteria, technical requirements, and context for best results.

Account Setup

Creating Your Account

Visit the registration page and enter your email address and a strong password. You'll receive a verification email - click the link to activate your account.

Profile Settings

After logging in, customize your profile in Settings:

  • Display Name: How your name appears in the app
  • Email Notifications: Control what updates you receive
  • Default Project: Set your primary project for quick access
  • Theme: Choose between light and dark modes

Security Settings

  • Two-Factor Authentication: Add an extra layer of security to your account
  • Session Management: View and revoke active sessions
  • Password: Update your password regularly

Your First Breakdown

Let's walk through creating your first AI-powered epic breakdown.

Step 1: Prepare Your Epic

A good epic description includes:

  • Clear business objective or user need
  • Scope and boundaries
  • Acceptance criteria
  • Technical considerations (if known)
  • Dependencies or constraints

Step 2: Generate the Breakdown

  1. Go to Dashboard and click "New Breakdown"
  2. Paste your epic description in the text area
  3. Select your target platform (Azure DevOps or Jira)
  4. Choose the work item types to generate (User Stories, Tasks, Test Cases)
  5. Click "Generate Breakdown"

Step 3: Review and Edit

AJAIA will generate a complete breakdown including:

User Stories

Clear, actionable stories with acceptance criteria

Tasks

Technical tasks with effort estimates

Test Cases

Gherkin scenarios with Given/When/Then steps

Relationships

Proper parent-child linking between items

Step 4: Push to Your Platform

Once you're satisfied with the breakdown:

  1. Click "Push to Azure DevOps" or "Push to Jira"
  2. Select the target project and area path
  3. Confirm the creation
  4. View the created items directly in your platform

Note: Make sure your Personal Access Token has write permissions for work items before pushing.

AI Epic Breakdown

AJAIA's core feature uses Claude AI to intelligently break down complex epics into actionable work items.

How It Works

When you submit an epic, AJAIA:

  1. Analyzes the epic description and identifies key requirements
  2. Determines appropriate work item types based on content
  3. Generates user stories with proper formatting and acceptance criteria
  4. Creates technical tasks with implementation details
  5. Produces test cases with Gherkin scenarios
  6. Establishes parent-child relationships between items

Supported Work Item Types

  • Epics: High-level features or initiatives
  • Features: Groupings of related user stories
  • User Stories: User-focused requirements with acceptance criteria
  • Tasks: Technical implementation work
  • Bugs: Defect tracking
  • Test Cases: Quality assurance scenarios

Best Practices

Do:

  • Provide detailed epic descriptions
  • Include business context and user personas
  • Specify technical constraints upfront
  • Review and customize generated items

Work Item Sync

Keep your Azure DevOps and Jira projects in sync with bi-directional synchronization.

Sync Capabilities

  • Field Mapping: Automatically map fields between ADO and Jira
  • Status Sync: Keep work item states synchronized
  • Comment Sync: Mirror discussions across platforms
  • Attachment Sync: Share files between systems

Setting Up Sync

  1. Connect both Azure DevOps and Jira in Settings
  2. Navigate to Sync Settings
  3. Select source and target projects
  4. Configure field mappings
  5. Enable automatic sync or trigger manually

Important: Test sync with a small set of items first. Review field mappings carefully to ensure data integrity.

Test Case Generation

AJAIA automatically generates comprehensive test cases with Gherkin scenarios.

Gherkin Format

Test cases are generated in the industry-standard Gherkin format:

Feature: User Authentication

Scenario: Successful login with valid credentials
  Given the user is on the login page
  When the user enters valid email and password
  And clicks the login button
  Then the user should be redirected to the dashboard
  And see a welcome message

Test Case Components

  • Title: Clear, descriptive test name
  • Preconditions: Required setup before test execution
  • Steps: Given/When/Then format
  • Expected Results: Clear success criteria
  • Priority: Test importance level

Web Application

Access AJAIA from any browser at app.ajaia.dev.

Features

  • Full access to all AJAIA features
  • Real-time collaboration
  • Dashboard with analytics
  • Work item management
  • Settings and preferences

Supported Browsers

  • Google Chrome (recommended)
  • Microsoft Edge
  • Mozilla Firefox
  • Safari

Desktop App

The AJAIA desktop app provides a native experience with additional features.

Installation

  1. Download the installer from ajaia.app/download
  2. Run the installer and follow the prompts
  3. Launch AJAIA and sign in with your account

Desktop-Exclusive Features

  • System Tray: Quick access without opening the full app
  • Clipboard Detection: Automatically detect epic text from clipboard
  • Offline Mode: View cached work items without internet
  • Native Notifications: Desktop alerts for important updates

System Requirements

  • Windows: Windows 10 or later
  • macOS: macOS 10.15 (Catalina) or later
  • RAM: 4GB minimum, 8GB recommended
  • Storage: 200MB free space

ADO Extension

The Azure DevOps Extension brings AI-powered breakdown directly into your ADO interface.

Installation

  1. Visit the Azure DevOps Marketplace
  2. Search for "AJAIA" or find it in AI Tools category
  3. Click "Get it free" and select your organization
  4. The extension will appear in your work item context menu

Using the Extension

  1. Open any Epic or Feature in Azure DevOps
  2. Click the AJAIA button in the toolbar or context menu
  3. Review the generated breakdown in the side panel
  4. Click "Create Items" to add them to your project

Pricing

  • Free Tier: 2 breakdowns per month
  • Premium: $15/user/month for unlimited breakdowns

The ADO Extension works independently of your AJAIA web subscription. You can use the free tier even without a web account.

MCP Integration

Connect AJAIA to AI coding assistants using the Model Context Protocol (MCP).

What is MCP?

MCP (Model Context Protocol) is a standard that allows AI assistants to access external tools and data. With AJAIA's MCP server, your AI assistant can:

  • Read and search your work items
  • Create new tasks and user stories
  • Update work item status
  • Generate breakdowns without leaving your IDE

Supported Clients

  • Claude Desktop: Full MCP support
  • VS Code + Copilot: Via MCP extension
  • Cursor: Native MCP support

Setup

See our MCP Integration Guide for detailed setup instructions.

Customization

Work Item Templates

Customize how AJAIA generates work items:

  • Default field values
  • Custom field mappings
  • Area path defaults
  • Iteration path settings

AI Preferences

  • Detail Level: Adjust how detailed generated items are
  • Estimation Style: Story points vs. hours
  • Test Coverage: Control test case generation depth

Notification Settings

Configure alerts for:

  • Sync completion
  • Error notifications
  • Usage limits approaching
  • New features and updates