Overview
GAIA’s goal tracking system helps you define long-term objectives, break them down into actionable steps, and track progress over time. The system uses AI to generate roadmaps and visualize your path to success.Understanding goals
What are goals?
Goals in GAIA are high-level objectives you want to achieve:- Personal goals: Learn a new skill, improve health, develop habits
- Professional goals: Career advancement, project completion, skill development
- Business goals: Revenue targets, customer acquisition, product launches
- Learning goals: Complete courses, master technologies, gain certifications
Goals vs. Todos
Goals
Long-term objectives that take weeks, months, or years to achieve. They have roadmaps with multiple milestones.
Todos
Short-term tasks completed in days or hours. They’re actionable items with clear completion criteria.
Creating goals
Manual goal creation
Define your goal
Fill in the goal details:
- Title: A clear, specific goal statement (e.g., “Launch MVP of mobile app”)
- Description: Detailed explanation of what you want to achieve and why
- Target date: When you want to achieve this goal (optional)
- Category: Personal, professional, health, learning, etc.
AI-assisted goal creation
Let GAIA help you define your goal:Describe your objective
Tell GAIA what you want to achieve: “I want to get fit and run a 5K race” or “I want to learn Python for data science.”
Provide context
Share additional information:
- Your current situation
- Timeline or deadline
- Resources available
- Constraints or challenges
Review the goal
GAIA will help you formulate a clear, achievable goal with:
- Specific outcome
- Measurable criteria
- Realistic timeline
- Action-oriented language
Goal roadmaps
What is a roadmap?
A roadmap is a visual representation of the steps needed to achieve your goal:- Nodes: Milestones or action items
- Connections: Dependencies between steps
- Progress: Visual tracking of completed vs. pending items
- Timeline: Estimated duration for each phase
AI-generated roadmaps
GAIA creates roadmaps automatically:Wait for AI processing
GAIA analyzes your goal and creates a structured plan with:
- Key milestones
- Sub-goals or phases
- Action items
- Suggested timeline
- Dependencies between steps
Roadmap generation uses AI to break down complex goals into manageable steps. The algorithm considers best practices and common patterns for achieving similar goals.
Roadmap visualization
The roadmap is displayed as an interactive graph:- Nodes: Circular elements representing each step
- Lines: Connections showing workflow and dependencies
- Colors: Visual indicators of status:
- Gray: Not started
- Blue: In progress
- Green: Completed
- Layout: Automatic positioning for easy understanding
apps/web/src/features/goals/components/CustomNode.tsx.
Editing roadmaps
Customize your roadmap:- Add nodes: Click Add Step to create new milestones
- Remove nodes: Delete steps that aren’t needed
- Edit details: Click any node to update its title and description
- Reorder steps: Drag and drop nodes to reorganize
- Update connections: Modify dependencies between steps
Tracking progress
Marking steps complete
Update progress as you work:
Node status updates are saved via
apps/web/src/features/goals/api/goalsApi.ts:36.
Progress visualization
See your progress at a glance:- Completion percentage: Overall progress bar
- Completed nodes: Count of finished steps
- Visual roadmap: Green nodes show completed work
- Timeline tracking: Compare actual vs. estimated timeline
Goal status
Goals have different states:- Active: Currently working on this goal
- On hold: Temporarily paused
- Completed: Goal achieved
- Abandoned: No longer pursuing
Managing goals
Goal list view
The goals page shows all your goals:- Filter by status: Active, completed, or all
- Filter by category: Personal, professional, etc.
- Sort options: By date created, target date, or progress
- Search: Find goals by title or description
Goal details
Click any goal to see:- Full description
- Target date and timeline
- Current progress and completion rate
- Interactive roadmap
- Related todos and workflows
- Notes and updates
Editing goals
Goal updates are handled via
apps/web/src/features/goals/api/goalsApi.ts:28.
Deleting goals
Remove goals you no longer want to track:- Open the goal
- Click Delete
- Confirm the deletion
Goal strategies
Breaking down large goals
For ambitious goals, use a hierarchical approach:- Main goal: The ultimate objective
- Sub-goals: Major phases or milestones
- Action items: Specific tasks within each phase
- Todos: Day-to-day work items
Setting realistic timelines
Estimate timelines effectively:- Start date: When you’ll begin working on this goal
- Target date: Realistic completion date
- Milestones: Intermediate deadlines for key phases
- Buffer time: Add extra time for unexpected delays
Review and adjust
Regularly review your goals:- Weekly reviews: Check progress on active goals
- Monthly assessments: Evaluate if goals are still relevant
- Adjust roadmaps: Update steps based on learnings
- Celebrate wins: Acknowledge completed milestones
Advanced features
Goal dependencies
Some goals depend on others:- Prerequisites: Goals that must complete first
- Related goals: Goals that support each other
- Milestone linking: Connect roadmap nodes across goals
Goal analytics
Track your goal-setting effectiveness:- Completion rate: Percentage of goals achieved
- Average time to completion: How long goals typically take
- Success patterns: What types of goals you complete most
- Roadmap accuracy: How well AI predictions match reality
Collaborative goals
Work on goals with others:- Shared goals: Multiple people working toward the same objective
- Assigned nodes: Distribute roadmap steps among team members
- Progress updates: See what others have completed
- Comments: Discuss progress and challenges
Goal templates
Reuse successful goal structures:- Common goal patterns (learning, fitness, project launch)
- Pre-built roadmaps for typical objectives
- Customizable templates you create
- Community-shared goal templates
Integration with other features
Todo integration
Connect goals with daily work:- Create todos from roadmap nodes: Turn milestones into actionable tasks
- Link todos to goals: Associate daily work with long-term objectives
- Progress sync: Completing todos updates goal progress
Calendar integration
Schedule goal work:- Time blocking: Reserve calendar time for goal work
- Milestone dates: Add roadmap deadlines to calendar
- Reminders: Get notified before key milestone dates
Workflow integration
Automate goal tracking:- Progress workflows: Automatic updates when milestones complete
- Reminder workflows: Periodic check-ins on goal progress
- Reporting workflows: Weekly or monthly goal status summaries
Chat integration
Manage goals conversationally:- “What goals am I working on?”
- “Show me progress on my Python learning goal”
- “Mark the first milestone of my app project as complete”
- “Create a goal to improve my public speaking skills”
Best practices
Be specific
Clear goals are achievable goals. “Learn Python” becomes “Complete Python for Data Science course by June.”
Set realistic timelines
Ambitious is good, but impossible timelines lead to discouragement. Add buffer time.
Break it down
Large goals are overwhelming. Use roadmaps to create manageable steps.
Review regularly
Weekly check-ins keep goals top of mind. Monthly reviews ensure goals remain relevant.
Celebrate progress
Acknowledge completed milestones. Small wins motivate continued effort.
Stay flexible
Goals can evolve. Update roadmaps as you learn and circumstances change.
Focus on few goals
Work on 3-5 active goals maximum. More leads to diluted effort.
Connect to purpose
Know why each goal matters. Purpose drives persistence through challenges.
Example goals
Learning goal: Master React
Objective: Become proficient in React development Roadmap:- Complete React fundamentals course
- Build 3 practice projects
- Learn React hooks and context
- Study React performance optimization
- Contribute to open source React project
- Build and deploy production app
Career goal: Get promoted
Objective: Advance to senior engineer position Roadmap:- Identify promotion requirements
- Develop technical leadership skills
- Lead a major project
- Mentor junior team members
- Present at team meetings and conferences
- Document achievements for review
Fitness goal: Run a marathon
Objective: Complete a full marathon Roadmap:- Get medical clearance
- Build base fitness (run 3 times/week)
- Complete a 10K race
- Follow half-marathon training plan
- Run a half-marathon
- Complete full marathon training plan
- Run the marathon
Troubleshooting
Can't create roadmap
Can't create roadmap
- Ensure your goal description is detailed enough
- Try regenerating with more specific information
- Create a manual roadmap and add nodes yourself
- Contact support if AI generation fails repeatedly
Progress not updating
Progress not updating
- Refresh the page
- Check that you’re marking nodes complete (not just viewing)
- Verify goal status is set to Active
- Check browser console for errors
Lost motivation
Lost motivation
- Review why this goal matters to you
- Break down next steps into smaller actions
- Celebrate progress you’ve made so far
- Consider adjusting timeline or approach
- Share your goal with someone for accountability
Goal seems impossible
Goal seems impossible
- Re-evaluate if the goal is realistic
- Break it into smaller sub-goals
- Extend the timeline
- Focus on the first milestone only
- Seek mentorship or guidance
Next steps
Todo Management
Break down goal milestones into actionable todos.
Workflow Creation
Automate goal tracking and progress updates.
Chat Interface
Manage goals through natural language conversations.