GitHub Project LLM Management¶

AI-Powered GitHub
Project Management

Slash commands, a PM agent, Gemini workflows, and a full Kanban board -- all wired into your repo. You write code. The template handles everything else.

Get Started View on GitHub

8 Slash Commands

9 Workflows

1 Command Setup

0 Config Needed

Install in one command¶

$ curl -fsSL https://raw.githubusercontent.com/dyvan/github-project-llm-management/main/install.sh | bash

The setup wizard asks for your GitHub token and optional Gemini API key.
Labels, project board, and workflows are configured automatically.

What you get¶

Slash commands, an AI agent, automated workflows, and plugin packaging -- all in one template.

Slash Commands¶

Eight built-in commands for Claude Code: start tasks, finish PRs, plan sprints, pick the next task, save session context, and more.

PM Agent¶

A dedicated project management agent that understands your board, priorities, milestones, and can orchestrate multi-step workflows autonomously.

AI Code Review¶

Every PR is analyzed by Gemini AI with improvement suggestions, bug detection, and security checks -- posted as a PR comment automatically.

Auto Project Board¶

Issues and PRs flow through your Kanban board automatically. Status moves from Backlog to Done without any manual dragging.

Spec Questionnaire¶

Gemini generates a tailored questionnaire to clarify requirements before any code is written. Answers feed into a detailed specification.

Automatic Branches¶

Add the auto-branch label to any issue. A branch named feat/123-title is created and linked in seconds.

Project Memory¶

Persistent context stored in .ai/memory/ survives between sessions. Decisions, architecture choices, and blockers are never forgotten.

Hooks¶

Lifecycle hooks let you inject custom logic at key moments -- before commits, after branch creation, on PR events. Fully extensible.

Plugin Packaging¶

Distribute as a Claude Code plugin via .claude-plugin/. Drop it into any repo to get the full PM toolkit instantly.

Auto-close Features¶

Parent issues close automatically when all sub-issues are done. No manual tracking required.

CI/CD Out of the Box¶

Lint, tests, and build run on every PR. Results are posted as comments. Zero CI setup needed.

One-command Setup¶

A single curl command installs everything: labels, project board, workflows, scripts, and documentation. Idempotent and re-runnable.

Slash commands for Claude Code¶

Type / in Claude Code to access project management directly from your terminal.

/start-task Pick an issue, create a branch, update the board to In Progress

/finish-task Open a PR, move the issue to In Review

/next-task Auto-pick the highest priority Ready task from the board

/plan-task Break down a feature into estimated sub-tasks

/task-status Show current task status, branch, and board state

/sprint-report Generate a sprint progress report with velocity metrics

/save-session Save session context to an issue comment for later

/load-session Restore context from a previous session

Manual work vs. this template¶

See what changes when automation takes over.

Task	Without	With template
Start a task	Create branch, update board, assign	`/start-task`
Track issue status	Drag cards on the board	Automatic: Backlog → Done
Code review	Wait for humans	Gemini reviews in seconds
Pick next task	Scan board, check priorities	`/next-task`
Clarify requirements	Meetings, back-and-forth	Gemini generates a spec questionnaire
Close parent issues	Remember to check manually	Auto-closes when sub-issues are done
Sprint report	Spreadsheet or manual notes	`/sprint-report`
Session context	Lost between sessions	`/save-session` + `/load-session`

How it works¶

You

/start-task Pick an issue, branch is created

Develop & Push Write code on your branch

/finish-task PR created, board updated

Automated

AI Code Review Gemini analyzes your PR

CI Tests Lint, test, build

Done Issue closed, board updated

Get started in 3 steps¶

1

Install¶

curl -fsSL https://raw.github\
usercontent.com/dyvan/github-\
project-llm-management/main/\
install.sh | bash

2

Start a task¶

# In Claude Code, type:
/start-task
# Pick issue, branch is created,
# board moves to In Progress

3

Ship it¶

# When done, type:
/finish-task
# PR created, AI review runs,
# issue auto-closes on merge

Frequently asked questions¶

Do I need a Gemini API key?

It's optional. Without it you still get automatic branches, project board sync, CI tests, slash commands, the PM agent, and auto-close. The Gemini key enables AI code review and specification questionnaires.

What AI coding tools does this work with?

The slash commands and PM agent are built for Claude Code, but the GitHub workflows and automation work with any tool -- Cursor, GitHub Copilot, Windsurf, or plain vim.

Can I use this with an existing repo?

Yes. The install script creates a new project, but you can also copy the workflows, commands, and scripts into an existing repo manually.

Is this only for Python projects?

No. The template works with any language. The Python scripts power the automation layer. Your project code can be anything.

What GitHub token scopes do I need?

The token needs repo, project, and workflow scopes. The setup wizard tells you exactly what to configure.

What is the PM Agent?

A dedicated Claude Code agent (defined in .claude/agents/pm-agent.md) that understands your project board, priorities, and milestones. It can orchestrate multi-step project management workflows autonomously.

How does project memory work?

Session context and project decisions are stored in .ai/memory/ and issue comments. Use /save-session before ending work and /load-session to pick up where you left off.