Documentation
Learn how to use TaskTitan effectively
Getting Started
TaskTitan is a component-based project planning tool that helps teams break down projects into manageable work items. Here's how to get started.
Step 1: Create a Team
Teams are the foundation of TaskTitan. Each team has members with different roles and can manage multiple projects.
Team Roles:
- Owner — Full control, can delete the team
- Admin — Can manage members and settings
- Member — Can create and edit projects/components
- Viewer — Read-only access to projects and components
Step 2: Choose a Workflow
When creating a team, select a workflow template that matches your methodology:
Scrum
2-week sprints with planning and retrospectives
Kanban
Continuous flow with WIP limits
Shape Up
6-week cycles with 2-week cooldown
Custom
Configure your own settings
Step 3: Create a Project
Projects belong to teams and contain all your work items (components). Give your project a clear name and description — the AI uses this to generate relevant components.
Step 4: Plan Sprints
If using time-boxed iterations, create sprints with start/end dates and capacity hours.
Sprint Statuses:
Component Planning
Components are the work items in TaskTitan. They follow the INVEST criteria for well-defined work items and can be organized hierarchically, supporting various methodologies including Scrum, Kanban, and Shape Up.
Component Types
Large initiative (40-200 hours)
Example: "User Authentication System"
Distinct capability (16-40 hours)
Example: "Social Login"
User-facing change (2-16 hours)
Example: "Enable User Login"
Technical work item (1-8 hours)
Example: "Configure Database Connection"
Defect to fix (1-16 hours)
Example: "Fix Login Button Not Responding"
Component Statuses
Components flow through these statuses:
INVEST Criteria
TaskTitan encourages components that follow the INVEST criteria for well-defined work items:
Can be developed without waiting for others
Details can be refined through discussion
Delivers clear value to users or business
Effort can be reasonably estimated
Completable within appropriate timeframe
Has clear acceptance criteria
Dependencies & Hierarchy
Components can have parent-child relationships and dependencies:
- •Parent/Child: Epics contain Features, Features contain Stories
- •Dependencies: "Component A depends on Component B" means B must complete first
- •Blocking: Components can block others, tracked in the UI
AI Generation
TaskTitan uses Amazon Bedrock with Claude to provide AI-powered features. No external API keys needed — everything runs within AWS.
Component Generation
When you create a project, the AI can analyze your description and generate a complete sprint plan:
- Generates Stories and Tasks based on your project description
- Creates 2-4 sprints with clear goals (for Scrum teams)
- Estimates hours and sets priorities
- Identifies dependencies between components
- Respects your team's workflow (Scrum, Kanban, Shape Up)
Tip: Write detailed project descriptions for better AI suggestions. Include features, target users, and technical requirements.
Natural Language Creation
Describe a component in plain English, and the AI will structure it properly:
Example input:
"We need a login page that supports Google and GitHub OAuth, with remember me checkbox"
AI generates:
- • Name: "Implement OAuth Login with Social Providers"
- • Type: STORY
- • Estimated hours: 12
- • Acceptance criteria with testable conditions
Component Breakdown
Have a large component? The AI can suggest how to break it into smaller, manageable subtasks. Just click "Refine" on any component.
Chat-Based Refinement
Have a conversation with the AI to refine components. Ask questions like "What about error handling?" or "Should we add caching?"
AI Sprint Planning
Let the AI help you plan sprints by suggesting which backlog items to include, considering priority and dependencies.
Component Templates
Start from 10 pre-built templates: Authentication, CRUD Operations, REST API, Forms, Dashboard, Search, File Upload, Notifications, Payments, and Admin Panel.
Importing Data
Migrate your existing work items from other tools using the Import Wizard. TaskTitan supports multiple formats and uses AI to map your data automatically.
Supported Formats
CSV Files
Any spreadsheet exported as CSV
JSON Files
Structured data exports
Works with exports from Jira, Trello, Asana, and other tools — the AI intelligently maps columns to TaskTitan fields.
AI-Powered Import
- Auto-detection: Intelligently recognizes common column names from various tools
- Smart Mapping: Suggests column-to-field mappings with confidence scores
- Data Cleanup: Normalizes status values, types, and priorities automatically
- Validation: Highlights errors with inline editing to fix before import
Import Process
Drop your CSV or JSON file
AI suggests mappings, adjust as needed
Optionally let AI fix inconsistencies
Components are created with hierarchy and dependencies
Advanced Features
TaskTitan includes powerful features for teams that need more control over their workflow.
GitHub Integration
Connect your GitHub repositories for automatic component status updates based on pull request events.
- Link pull requests to components directly from the component card
- Automatic status transitions when PRs are opened, merged, or closed
- Configure which status to set when a PR is merged (e.g., Review or Completed)
- Copy branch names in a consistent format for easy checkout
Team Metrics & Analytics
Track team performance with detailed analytics on your team's metrics page.
Cycle Time
Average, median, p85, and p95 times from start to completion
Throughput
Components completed per time period
Status Distribution
Visual breakdown of work across statuses
Status History
Track how long items spend in each status
Team Capacity Planning
Set team member availability for realistic sprint planning.
- Hours per day: Account for meetings and non-coding time (default: 6 hours)
- Availability: Set percentage for part-time or shared resources
- Sprint capacity: Automatically calculated based on team availability
Decision Journal
Document the context and rationale behind technical decisions for each component.
- Record decisions, rationale, and alternatives considered
- Add links to relevant documentation or discussions
- AI-generated summaries for future readers to quickly understand context
Additional AI Features
Wireframe Generation
AI generates UI wireframe previews for components
Sprint Retrospectives
AI analyzes sprint performance and suggests improvements
Bulk Refinement
Refine multiple components at once with AI suggestions
Context Summaries
AI summarizes decision context for future readers
Workflow Configuration
Fine-tune your team's workflow with advanced settings.
- WIP Limits: Set work-in-progress limits per status column
- Custom terminology: Rename "Sprint" to "Cycle" or "Iteration"
- Enforce estimates: Require hour estimates before starting work
- Auto-archive: Automatically archive completed items
Need More Help?
Try the demo mode to explore features risk-free, or reach out to our team.
Try Demo Mode