Skip to content

vbario/agileforai

Repository files navigation

Agile for AI

An AI-powered agile project management platform that orchestrates a team of AI agents operating under scrum methodology. A human "company lead" oversees the team through a dashboard, participating in sprint ceremonies or letting agents operate autonomously.

Architecture

  • Frontend: React + TypeScript (Vite), hosted on Firebase Hosting
  • Backend: Firebase Cloud Functions (Node.js/TypeScript)
  • Database: Firestore (all persistent state)
  • Auth: Firebase Auth (Google + Email/Password)
  • AI: Anthropic Messages API (Claude Sonnet)
  • Realtime: Firestore onSnapshot listeners

Agent Team

Agent Role
Product Owner Translates goals into stories, writes acceptance criteria, prioritizes backlog
Scrum Master Orchestrates ceremonies, tracks progress, resolves blockers
Developer Implements stories, pushes code to GitHub, creates PRs
Code Reviewer Reviews code against acceptance criteria and best practices
QA Engineer Verifies stories, writes test cases, reports bugs
Tech Lead Makes architectural decisions, sets coding standards
DevOps Handles deployment configs, CI/CD, infrastructure

Features

  • Kanban Sprint Board with drag-and-drop, real-time updates
  • Automated story enrichment — create a story with just a title, the PO agent generates acceptance criteria, estimates, and priority
  • Full sprint lifecycle — planning, standups, review, retrospective ceremonies
  • GitHub integration — agents create branches, commit code, open PRs
  • Dynamic integrations — connect any REST API (GoDaddy, Vercel, Mailchimp, etc.) and agents get tools to call them
  • Blocker escalation — agents recognize when they can't do something and escalate to the human with categorized blockers
  • Story feedback/rejection — reject done stories with feedback, automatically re-triggers the developer
  • Live console — real-time activity log, token usage tracking, cost monitoring, next-action guidance
  • Project Wiki — knowledge base injected into all agent contexts

Setup

# Install dependencies
cd functions && npm install
cd ../frontend && npm install

# Set Firebase config
cp frontend/.env.example frontend/.env
# Edit with your Firebase config values

# Set Anthropic API key
firebase functions:secrets:set ANTHROPIC_API_KEY

# Deploy
firebase deploy

# Local development
cd frontend && npm run dev

Project Structure

functions/src/
  agents/          — AI agent implementations (one per role)
  ceremonies/      — Sprint ceremony orchestration
  triggers/        — Firestore triggers (story status, messages, enrichment)
  tools/           — Tool definitions, executor, GitHub client, dynamic integrations
  utils/           — Context builder, shared utilities

frontend/src/
  pages/           — Dashboard, Ceremonies, Agents, Messages, Wiki, Settings
  components/      — StoryCard, KanbanColumn, SprintConsole, IntegrationsManager
  hooks/           — Firestore real-time hooks

About

AI-powered agile project management platform

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages