---

🎯 What is Stride?

Stride transforms chaotic AI coding sessions into structured, trackable, and reproducible workflows. It enables 20+ AI coding agents (Claude, Cursor, Windsurf, etc.) to autonomously plan, implement, and document software features while you monitor progress from the terminal.

The Problem

• 🔴 Context Loss: AI forgets everything after 3-5 chat turns
• 🔴 No Structure: No methodology for AI-driven development
• 🔴 Can't Track: What did the AI actually implement?
• 🔴 Agent Chaos: Multiple agents produce inconsistent outputs
• 🔴 No Learning: Retrospectives and learnings never captured

Stride's Solution

• ✅ Sprint-Based Structure → Persistent context in markdown files
• ✅ Slash Commands → Clear workflows for 20+ AI agents
• ✅ CLI Monitoring → Real-time visibility from your terminal
• ✅ Unified Methodology → All agents follow the same process
• ✅ Auto-Retrospectives → Learnings captured automatically

---

🚀 Quick Start

Installation

# Install from PyPI
pip install stridekit

# Verify installation
stride --version

Initialize Your Project

# 1. Initialize Stride in your project
stride init

# 2. Select your AI agents interactively
#    ✓ Cursor
#    ✓ Claude Code
#    ✓ Windsurf
#    ... and 17 more!

# 3. Stride installs slash commands for each agent

Start Your First Sprint

In your AI agent (e.g., Cursor, Claude):

/stride:init

The agent will:

1. Create project.md with your project context
2. Start your first sprint with proposal.md
3. Guide you through planning and implementation

Monitor Progress

stride list      # View all sprints
stride status    # Check current state
stride show SPRINT-XXXXX  # Detailed sprint view
stride metrics   # Analytics and insights

---

✨ Features

🤖 Multi-Agent Support (20 AI Agents)

Category	Agents
AI Editors	Cursor, Windsurf
Agents	Cline, RooCode, Factory, OpenCode, KiloCode, Antigravity
Assistants	GitHub Copilot, Amazon Q, Auggie, iFlow, CodeBuddy, Costrict
CLI Tools	Gemini CLI, Claude Code, Qoder, Qwen, Codex
Specialized	Crush

9 Template Formats: Automatically converts commands to each agent's format

📊 Sprint Management

• Lifecycle Tracking: Proposed → Active → Completed
• Progress Bars: Real-time visual feedback
• Task Breakdown: Organize into strides (milestones) with subtasks
• File-Based State: Sprint status determined by which files exist

📝 Documentation System

Every sprint contains:

• proposal.md → What and why
• plan.md → How (strides, tasks, approach)
• design.md → Architecture and APIs
• implementation.md → Real-time development log
• retrospective.md → What worked, what didn't

Benefits:

• Version control tracks everything
• Human and AI readable
• No databases required
• Easy to audit and backup

📈 Analytics & Insights

stride metrics

• Sprint duration and completion rates
• Task distribution analysis
• Process compliance scoring
• Quality indicators
• Export to JSON/CSV

🎨 Beautiful Terminal UI

• Color-coded status indicators
• ASCII progress bars
• Rich table displays
• Interactive prompts
• Spinners and animations

---

📖 How It Works

1. The Sprint Philosophy

Every feature, bug fix, or change is a sprint:

.stride/
  sprints/
    SPRINT-A3F2E/
      proposal.md          # ← What and why
      plan.md              # ← How (with strides)
      design.md            # ← Architecture
      implementation.md    # ← Development log
      retrospective.md     # ← Learnings

2. Agent Commands

When you run stride init, slash commands are installed:

Command	Purpose
/stride:init	Create project spec and first sprint
/stride:plan	Define goals and break down tasks
/stride:implement	Build with implementation tracking
/stride:status	Check progress
/stride:review	Validate work
/stride:complete	Archive and retrospective
/stride:present	Generate presentations
/stride:derive	Create sprint from existing
/stride:lite	Quick command reference
/stride:feedback	Collect feedback

3. CLI Monitoring

Monitor everything from your terminal:

$ stride list

┌─────────────┬──────────────────────────┬──────────┬─────────────┐
│ Sprint ID   │ Title                    │ Status   │ Created     │
├─────────────┼──────────────────────────┼──────────┼─────────────┤
│ SPRINT-A3F2E│ Add User Authentication  │ ACTIVE   │ 2 hours ago │
│ SPRINT-B7C9D│ Payment Integration      │ PROPOSED │ 1 day ago   │
└─────────────┴──────────────────────────┴──────────┴─────────────┘

---

🎯 Use Cases

For Indie Hackers

Ship features without losing context across chat sessions. Every sprint is documented and tracked.

For Startup CTOs

Align multiple AI tools (Cursor + Claude + Windsurf) with unified methodology and shared specs.

For Enterprise Developers

Trust AI in legacy repos with validation pipelines, process compliance, and full audit trails.

For AI-First Developers

Track exactly what agents implemented across sprints with full retrospective analysis.

---

📚 Documentation

• Website - Official documentation
• FEATURES.md - Complete feature list
• CHANGELOG.md - Version history
• CONTRIBUTING.md - Contribution guidelines
• CODE_OF_CONDUCT.md - Community guidelines

---

🛠️ Development

Setup

# Clone repository
git clone https://github.com/saranmahadev/Stride.git
cd Stride

# Install in development mode
pip install -e ".[dev]"

Code Quality

# Format code (Black, line length: 100)
black stride/

# Sort imports
isort stride/

# Type checking
mypy stride/

# Run tests
pytest

# With coverage
pytest --cov=stride --cov-report=html

Project Structure

stride/
├── cli.py              # Typer CLI app
├── models.py           # Pydantic models
├── constants.py        # Constants and enums
├── utils.py            # Utility functions
├── commands/           # CLI commands (6)
│   ├── init.py
│   ├── list.py
│   ├── status.py
│   ├── show.py
│   ├── validate.py
│   └── metrics.py
├── core/               # Business logic
│   ├── sprint_manager.py
│   ├── markdown_parser.py
│   ├── agent_registry.py
│   ├── template_converter.py
│   └── analytics.py
└── templates/          # Templates
    ├── sprint_files/
    ├── agent_commands/
    └── agents_docs/

---

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Quick Contribution Steps

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Run tests and linting
5. Commit (git commit -m 'Add amazing feature')
6. Push (git push origin feature/amazing-feature)
7. Open a Pull Request

---

📋 Requirements

• Python: 3.11+
• OS: Windows, macOS, Linux

Dependencies

• typer[all] - CLI framework
• rich - Terminal formatting
• pydantic - Data validation
• pyyaml - YAML parsing
• questionary - Interactive prompts
• pyfiglet - ASCII art

---

🎓 Philosophy

Stride is built on three core principles:

1. Agent-First Design - AI agents do the work, humans provide direction
2. Sprint-Based Methodology - Structured workflow with clear phases
3. Spec-Driven Development - Everything documented in markdown

This creates persistent context, cross-agent consistency, and a complete audit trail.

---

📊 Stats

• 20 AI Agents supported
• 9 Template Formats for agent compatibility
• 6 CLI Commands for monitoring
• 10 Agent Commands for workflow
• 6 Sprint Documents for each sprint

---

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🔗 Links

• Website: stride.saranmahadev.in
• GitHub: github.com/saranmahadev/Stride
• PyPI: pypi.org/project/stridekit
• Issues: github.com/saranmahadev/Stride/issues

---

💖 Acknowledgments

Built with:

• Typer - CLI framework
• Rich - Terminal UI
• Pydantic - Data validation
• PyYAML - YAML parsing
• Questionary - Interactive prompts
• Pyfiglet - ASCII art

---