GitScrum / Docs

How GitScrum Works

GitScrum is an agile project management platform designed specifically for software agencies. It combines Kanban boards, sprint planning, time tracking, and client management into a unified workflow.

Data Architecture

GitScrum follows a clear hierarchy that scales from solo developers to enterprise agencies:

1

Workspace

Level 1

Top-level container for your organization. Holds all projects, team members, billing settings, and workspace-level time tracking. You can create multiple workspaces for different companies or clients.
2

Project

Level 2

Each project contains its own Kanban boards (multiple boards per project), sprints, user stories, wiki documentation, and discussion threads. Projects have isolated team permissions and settings.
3

Sprint

Level 3

Time-boxed iterations with configurable duration. Each sprint includes burndown charts, sprint health indicators, KPI dashboards, and a focused task view filtered from the main board.
4

User Story

Level 4

Group related tasks under epics. User stories support acceptance criteria, priority levels, and can be assigned to sprints. Voting boards allow team estimation with story points.
5

Task

Level 5

The atomic work unit. Tasks live on Kanban columns, support assignees, labels, due dates, time entries, attachments, checklists, comments, and can be linked to sprints or user stories.

Core Features

Key capabilities built into every project:

Kanban Board

Drag-and-drop columns with WIP limits, column automation (auto-assign users/labels), archived tasks view, and real-time WebSocket updates when teammates move cards.

Time Tracking

Start/stop timer or manual entry. Track billable vs non-billable hours. View entries by user, project, or date range. Export timesheets to Excel.

Sprint Analytics

Burndown and burnup charts track progress. Sprint health dashboard shows blockers and velocity. KPI reports display completion rates and team performance.

User Stories & Epics

Organize work hierarchically. Epics group related user stories. Stories contain acceptance criteria and can be estimated using voting boards with story points.

Wiki & Documents

Built-in documentation per project. Wiki pages with markdown support. Document attachments stored at project level for team reference.

Discussions

Threaded conversations per project. Team communication without leaving the platform. Discussions are searchable and organized by topic.

Board Views

Switch between different perspectives on your Kanban board:

Kanban

Default column-based view with drag-and-drop cards

List

Compact table view with sorting and filtering

Flow (Pro)

Cumulative flow diagram showing work distribution

Heatmap (Pro)

Activity patterns and bottleneck visualization

Permission System

GitScrum uses role-based access control at both workspace and project levels:

Agency Owner

Full Access
  • • Manage workspace settings and billing
  • • Access ClientFlow dashboard
  • • Create/delete projects
  • • Invite members to workspace
  • • View all time tracking across projects

Manager

Project Admin
  • • Manage project settings
  • • Create and manage sprints
  • • Delete tasks and user stories
  • • Manage project team members
  • • No access to ClientFlow

Developer

Team Member
  • • Create and edit tasks
  • • Log time entries
  • • View sprints and user stories
  • • Upload files
  • • Cannot delete sprints or manage settings

Client

Limited View
  • • View project progress via ClientFlow
  • • Add comments for feedback
  • • View shared tasks only
  • • Cannot create or move tasks
  • • No access to time tracking data

ClientFlow for Agencies

Agency Owner Only

Agency owners have exclusive access to ClientFlow — a dedicated dashboard for managing client relationships, revenue, and project health:

Revenue Pipeline

Track invoices by status (draft, sent, paid, overdue) and proposals (pending, accepted, rejected)

Clients at Risk

Automatic alerts for overdue invoices, stalled projects, and expiring proposals

Project Health

See all projects by health status: healthy, warning, critical. Identify over-budget projects.

Actionable Insights

AI-powered recommendations for upselling, follow-ups, and client retention

Client Leaderboard

Rank clients by revenue, project count, or reliability score

Next Steps

Quickstart Guide Get started in 5 minutes Overview Platform capabilities Kanban Board Drag-and-drop task management Sprint Planning Burndown charts and velocity Time Tracking Billable hour capture Common Workflows Daily patterns and best practices