Commands Reference

Complete guide to all Xavier Framework commands

📋 Story Management

/create-story

SCRUM

Create a new user story in the product backlog using standard Agile format.

/create-story "description" story_points [epic_id]

Parameters:

description required User story in "As a... I want... so that..." format
story_points required Fibonacci scale: 1, 2, 3, 5, 8, 13, 21
epic_id optional Link to an existing epic

Examples:

/create-story "As a user, I want to reset my password so that I can regain access" 5
Creates a 5-point story for password reset functionality
/create-story "As an admin, I want to view analytics" 8 EPIC-001
Creates an 8-point story linked to EPIC-001

/create-task

SCRUM

Break down stories into executable technical tasks with time estimates.

/create-task "description" story_id estimated_hours [priority]

Parameters:

description required Technical task description
story_id required Parent story ID (e.g., STORY-001)
estimated_hours required Time estimate in hours
priority optional LOW, MEDIUM, HIGH, or CRITICAL

Examples:

/create-task "Implement JWT token generation" STORY-001 3
Creates a 3-hour task for JWT implementation
/create-task "Add rate limiting to API" STORY-002 5 HIGH
Creates a high-priority 5-hour task

/create-bug

ISSUE

Report and track bugs with automatic prioritization in the backlog.

/create-bug "description" severity [story_id]

Parameters:

description required Bug description with steps to reproduce
severity required LOW, MEDIUM, HIGH, or CRITICAL
story_id optional Related story if applicable

Examples:

/create-bug "Login fails with email containing +" CRITICAL
Reports a critical bug in login functionality
/create-bug "Pagination shows wrong count" MEDIUM STORY-003
Reports a medium-severity bug related to STORY-003

/create-project

NEW

Intelligently analyze project requirements and generate comprehensive stories, tasks, and technical architecture.

/create-project "project_name" "detailed_description" [tech_stack]

Parameters:

project_name required Name of the project (e.g., "E-commerce Platform")
description required Detailed description of features and requirements
tech_stack optional Preferred technology stack (auto-detected if not specified)

Examples:

/create-project "Task Manager" "A web app for managing tasks with user auth, projects, and team collaboration"
Creates full project plan with AI-generated stories and tasks
/create-project "Blog API" "RESTful API for blog with CRUD, auth, comments" "Python/FastAPI"
Creates project with specified tech stack

🏃 Sprint Management

/estimate-story

PM AGENT

Automatically estimate story points using the Project Manager agent's complexity analysis algorithm.

/estimate-story [story_id] [--all]

Parameters:

story_id optional Specific story to estimate (estimates all unestimated if omitted)
--all optional Force re-estimation of all stories

PM Agent Analysis:

  • Technical complexity (API, database, authentication)
  • CRUD operations count
  • Acceptance criteria complexity
  • UI/UX requirements
  • Testing requirements
  • Maps to Fibonacci points (1,2,3,5,8,13,21)

Examples:

/estimate-story
Estimates all unestimated backlog stories
/estimate-story STORY-001
Estimates specific story STORY-001

/create-sprint

SPRINT

Plan a new sprint with automatic story selection based on velocity.

/create-sprint "name" duration_days [goal]

Parameters:

name required Sprint name or title
duration_days required Sprint duration (typically 14 days)
goal optional Sprint goal or objective

Examples:

/create-sprint "Sprint 1: Authentication" 14
Creates a 2-week sprint focused on authentication
/create-sprint "MVP Release" 7 "Complete core features for demo"
Creates a 1-week sprint with specific goal

/start-sprint

EXECUTION

Begin sprint execution with strict sequential task processing and TDD enforcement.

/start-sprint [sprint_id] [strict_mode]

Parameters:

sprint_id optional Sprint ID (uses latest if not specified)
strict_mode optional Enable strict sequential execution (default: true)

Examples:

/start-sprint
Starts the most recent planned sprint
/start-sprint SPRINT-001
Starts specific sprint with ID SPRINT-001

/show-backlog

VIEW

Display the prioritized product backlog with story points and status.

/show-backlog [filter]

Parameters:

filter optional Filter by status: pending, in_progress, completed

Examples:

/show-backlog
Shows complete backlog with all items
/show-backlog pending
Shows only pending items in the backlog

🛠️ System Commands

/xavier-help

HELP

Display all available Xavier commands with descriptions and usage examples.

/xavier-help [command]

Parameters:

command optional Get detailed help for specific command

Examples:

/xavier-help
Shows all available commands
/xavier-help create-story
Shows detailed help for create-story command

/xavier-config

CONFIG

Configure Xavier settings including test coverage, Clean Code limits, and workflow options.

/xavier-config [setting] [value]

Parameters:

setting optional Configuration key to modify
value optional New value for the setting

Examples:

/xavier-config
Shows current configuration
/xavier-config max_function_lines 25
Sets maximum function lines to 25

/xavier-stats

METRICS

View project statistics including velocity, test coverage, and code quality metrics.

/xavier-stats [sprint_id]

Parameters:

sprint_id optional Show stats for specific sprint

Examples:

/xavier-stats
Shows overall project statistics
/xavier-stats SPRINT-001
Shows statistics for SPRINT-001

/xavier-update

SYSTEM

Check for Xavier Framework updates and install the latest version with automatic backup.

/xavier-update [--check-only]

Parameters:

--check-only optional Only check for updates without installing

Examples:

/xavier-update
Checks for updates and installs if available
/xavier-update --check-only
Shows current version and available updates

🔧 Advanced Commands

/xavier-validate

QUALITY

Validate code against Clean Code standards and test coverage requirements.

/xavier-validate [file_path]

Parameters:

file_path optional Specific file to validate (validates all if not specified)

Examples:

/xavier-validate
Validates entire codebase
/xavier-validate src/auth/login.py
Validates specific file

/xavier-agent

AI

Invoke specialized agents (Python, Go, Frontend, etc.) for language-specific tasks.

/xavier-agent agent_type "task_description"

Parameters:

agent_type required python, golang, frontend, backend, devops
task_description required Task for the agent to perform

Examples:

/xavier-agent python "Refactor authentication module for SOLID principles"
Python agent refactors code following SOLID
/xavier-agent frontend "Create responsive dashboard component"
Frontend agent creates React component

💡 Pro Tips

  • Commands are executed sequentially - Xavier won't allow parallel task execution
  • All commands respect the 100% test coverage requirement
  • Story points must follow Fibonacci sequence for accurate velocity tracking
  • Bug severity automatically determines sprint priority
  • Use /show-backlog frequently to track progress
  • Configure settings with /xavier-config to match your team's standards
  • Use /create-project for AI-powered project initialization with automatic story generation
  • Run /xavier-update regularly to get the latest features and improvements

Need More Help?

📖 Full Documentation

Deep dive into Xavier architecture

🚀 Quick Start

Get started in 5 minutes

💬 Community

Join the discussion