SmartFlow
VS Code Extension for AI-Powered, GitHub-Native Project Management
Build smarter, ship faster. SmartFlow brings intelligent multi-agent sprint planning, 8-meeting Scrum workflow, and GitHub Projects v2 automation directly into VS Code — powered by AI agents and seamless GitHub integration.
⚠️ CLOSED BETA VERSION (v0.1.6) — This extension is currently in a closed beta testing phase. A valid license file is required in the workspace root to initialize and use the extension. Contact the author to request a beta license.
🎯 What is SmartFlow?
SmartFlow is an all-in-one project management system embedded in VS Code. It orchestrates 15+ specialized AI agents through 8 structured Scrum meetings, providing full lifecycle coverage — from business analysis and goal planning through backlog creation, sprint management, iteration review, and release publishing.
Core Pillars
Multi-Agent AI Meetings — 7 meeting types, each led by specialized AI agents (Business Analyst, Product Owner, Scrum Master, Architect, and more) that collaborate to produce structured project documents.
GitHub Projects v2 Integration — Full bidirectional sync with GitHub: issues, milestones, iterations, project boards, PRs, releases, and custom fields (Estimate, Sprint, Priority, Status, Area).
VS Code Sidebar — Real-time project dashboard with kanban board, meeting management, iteration planning, development workflow, and Google Calendar sync — all without leaving the editor.
Progress Dashboard — Full-screen analytics: burndown charts, velocity trends, release roadmaps, AI-generated insights, and export functionality.
✨ Features
🤖 AI Multi-Agent Meeting System
SmartFlow's unique approach uses 8 sequential meetings, each orchestrated by multiple AI agents with defined roles:
| # |
Meeting |
Lead Agent |
Supporting Agent |
Output |
| 1 |
Business Analysis |
Business Analyst |
Researcher |
Market & competitive analysis |
| 2 |
Goals / Milestones |
Goal Planner |
Architect |
OKR documents → GitHub Milestones |
| 3 |
Backlog & Estimation |
Backlog Refiner |
Estimator |
Stories → GitHub Issues with estimates |
| 4 |
Iteration Planning |
Scrum Master |
Team Planner |
Sprint plans with capacity analysis |
| 5 |
Iteration Review & Retro |
Scrum Master |
Retrospectivus |
Review metrics, retrospective |
| 6 |
Release Planning |
Release Manager |
QA Engineer |
Release notes, GitHub Releases |
| 7 |
Deployment |
DevOps Lead |
QA Lead |
Release checklist, pipeline, monitoring |
Each meeting produces structured markdown documents stored in smart-flow/ and synced to GitHub.
📊 GitHub Projects v2 — Full Integration
- 5 Custom Fields auto-configured:
- Status: 📋 Backlog → 🗓️ Planned → 🔨 In Progress → 👀 In Review → ✅ Done
- Estimate: Fibonacci (1, 2, 3, 5, 8)
- Sprint: Native GitHub Iteration field with
@current/@next/@previous
- Priority: P0–P3
- Area: Backend, Frontend, Infra, Bug, Docs
- Bidirectional sync: goals ↔ milestones, stories ↔ issues, iterations ↔ sprints
- Bulk operations: assign issues to iterations, sync statuses, push backlog
- PR workflow: draft creation, mark ready, request reviews, auto-merge
📈 Progress Dashboard
Full-screen webview dashboard with:
- Sprint burndown charts — track daily progress
- Goal burndown — long-term milestone tracking
- Velocity trends — historical and predicted
- Release roadmap — visual timeline of upcoming releases
- AI-generated insights — automated recommendations
- Export — save reports for stakeholders
🛠️ Development Workflow
Built-in mini kanban board for developers:
- 4-column workflow: To Do → In Progress → In Review → Done
- Auto branch creation when starting work on an issue
- Draft PR workflow: create → mark ready → request review → merge
- Assignment: assign to human or Copilot coding agent
- Status automation: status changes flow automatically
📅 Google Calendar Integration
- OAuth 2.0 authentication via VS Code Secrets
- Sync meetings to Google Calendar (single or bulk)
- Attendee management and reminders
- Event tracking and updates
- Open calendar directly from sidebar
🧭 Flow Navigator
Interactive AI-powered guide (Scrum Master agent) that:
- Analyzes your current project state
- Recommends which meeting to run next
- Schedules meetings on GitHub
- Provides context-aware workflow guidance
🌐 Multi-Language Support
Documents can be generated in 6 languages:
- 🇬🇧 English, 🇪🇸 Español, 🇫🇷 Français, 🇩🇪 Deutsch, 🇳🇴 Norsk, 🇵🇱 Polski
🚀 Quick Start
Prerequisites
- VS Code 1.90.0+
- GitHub repository with GitHub Projects v2 enabled
- GitHub authentication (OAuth device flow or PAT)
- GitHub authentication (OAuth device flow or PAT)
- License file in workspace root (closed beta — contact the author)
Installation
- Install the extension from VSIX (for example
smartflow-0.1.6.vsix) or marketplace
- Place a valid license file in your workspace root
- Open your GitHub repository in VS Code
- Click the SmartFlow icon (🚀) in the Activity Bar
- Click Initialize Project to set up your project structure and GitHub board
🎮 Commands
| Command |
Description |
SmartFlow: Initialize SmartFlow Project |
Create smart-flow folder structure |
SmartFlow: Init Project (GitHub Fields) |
Configure GitHub Project v2 custom fields |
SmartFlow: New Flow |
Create a new process flow document |
SmartFlow: Generate Issues from Flow |
Convert flow documents to GitHub Issues |
SmartFlow: Analyze Market & Customers |
AI market research and competitive analysis |
SmartFlow: Analyze Product & Features |
AI product roadmap analysis |
SmartFlow: Analyze Project (AI PO) |
Product Owner prioritization analysis |
SmartFlow: Plan Week |
AI-powered weekly iteration planning |
SmartFlow: Review Week |
Sprint review with metrics and retrospective |
SmartFlow: Estimate Story Points |
AI story point estimation |
SmartFlow: Suggest Labels for Issue |
Auto-label suggestions based on content |
SmartFlow: Show Team Metrics |
Velocity, capacity, and performance data |
SmartFlow: Analyze Issue Dependencies |
Blocker and dependency mapping |
SmartFlow: Predict Sprint Velocity |
ML-based velocity forecasting |
SmartFlow: Generate Sprint Report |
Automated sprint summary report |
SmartFlow: Sync All Issues to GitHub Project |
Bulk sync backlog to GitHub board |
SmartFlow: Sync Iteration Plan to GitHub |
Assign issues and set statuses for sprint |
SmartFlow: Open Progress Dashboard |
Full-screen dashboard with charts |
SmartFlow: Refresh Kanban Board |
Reload sidebar from GitHub |
SmartFlow: Show Setup Guide |
Interactive onboarding walkthrough |
📄 License
Proprietary — Closed Beta
This software is proprietary and distributed under a closed beta license. Usage requires a valid license file issued by the author. Redistribution, modification, and sublicensing are not permitted without explicit written permission.
👤 Author
Irek Cicherski
Happy planning! 🚀
| |
