https://github.com/jrc1883/popkit-claude
AI-powered development workflow automation for Claude Code. Modular plugin suite with 23 commands, 38 skills, and 22 specialized agents for professional software development.
https://github.com/jrc1883/popkit-claude
ai-workflows automation claude-code claude-plugin developer-tools development-tools productivity python typescript workflow-automation
Last synced: 4 months ago
JSON representation
AI-powered development workflow automation for Claude Code. Modular plugin suite with 23 commands, 38 skills, and 22 specialized agents for professional software development.
- Host: GitHub
- URL: https://github.com/jrc1883/popkit-claude
- Owner: jrc1883
- License: mit
- Created: 2025-12-10T05:40:33.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-09T00:20:01.000Z (5 months ago)
- Last Synced: 2026-01-09T00:21:29.248Z (5 months ago)
- Topics: ai-workflows, automation, claude-code, claude-plugin, developer-tools, development-tools, productivity, python, typescript, workflow-automation
- Language: Python
- Homepage: https://github.com/jrc1883/popkit-claude#readme
- Size: 5.99 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# PopKit
**Development workflows that actually work**
Start each day knowing your project is healthy.
End each day with context saved for tomorrow.
Know exactly what to do next.
[Get Started](#get-started) · [Morning Routine](#morning-routine) · [What's Next](#whats-next) · [Docs](https://popkit.unjoe.me)
---
## What is PopKit?
PopKit organizes your Claude Code sessions around **workflows, not tools**.
Most AI coding assistants give you a prompt and say "figure it out." PopKit gives you:
- **Morning routines** that check your project health before you write code
- **"What's next?"** recommendations based on your actual git status, failing tests, and open issues
- **Guided development** that walks you through feature implementation phase by phase
- **Session capture** so you can pick up exactly where you left off
It's the difference between "here's an AI" and "here's how to use AI to build software."
---
## Get Started
```bash
# Add the PopKit marketplace
/plugin marketplace add jrc1883/popkit-claude
# Install the plugins you need
/plugin install popkit-core@popkit-claude # Foundation
/plugin install popkit-dev@popkit-claude # Development workflows
# Restart Claude Code, then run your first morning routine:
/popkit-dev:routine morning
```
---
## Morning Routine
Every morning, PopKit checks your project's vital signs:
```
/popkit-dev:routine morning
```
```
■ Session Restored
Last: Fixed authentication flow (2h ago)
■ Ready to Code Score: 87/100
✓ Git status clean
✓ Tests passing (142/142)
✓ CI green on main
⚠ 2 dependencies outdated
✓ No TypeScript errors
■ Context Loaded
Active issue: #47 Add password reset flow
Branch: feat/password-reset (3 commits ahead of main)
Ready to continue.
```
The "Ready to Code" score tells you if something needs attention before you start coding. 87 means you're good to go. 45 means something's broken.
---
## What's Next
When you're not sure what to work on:
```
/popkit-dev:next
```
PopKit analyzes your git status, test results, GitHub issues, and TypeScript errors to recommend prioritized actions:
```
Recommended Actions:
1. Merge main into branch (Score: 85)
Branch is 5 commits behind main
2. Fix TypeScript error in src/auth.ts:47 (Score: 78)
Type 'string | undefined' is not assignable to type 'string'
3. Continue issue #47 (Score: 72)
Password reset flow - implementation started
4. Review PR #51 (Score: 65)
Dependency update, waiting 2 days
```
No more staring at your terminal wondering what to do.
---
## Guided Development
Start a feature with `/popkit-dev:dev`:
```
/popkit-dev:dev "Add password reset via email"
```
PopKit walks you through seven phases:
1. **Discovery** — What exactly are we building?
2. **Exploration** — What patterns exist in this codebase?
3. **Questions** — What do we need to clarify before coding?
4. **Architecture** — How should we structure this?
5. **Implementation** — Write the code, phase by phase
6. **Review** — Check what we built
7. **Summary** — Document what changed
Each phase has checkpoints. You approve before moving forward.
---
## Nightly Routine
End your day with context saved:
```
/popkit-dev:routine nightly
```
```
■ Sleep Score: 92/100
✓ All changes committed
✓ Branch pushed to origin
✓ Tests passing
✓ No uncommitted stashes
■ Session Captured
Work: Implemented password reset email flow
Next: Add reset token validation endpoint
■ Dependencies
2 security updates available (non-breaking)
Sweet dreams.
```
Tomorrow's morning routine will restore this context automatically.
---
## The Philosophy
PopKit tries to be **programmatic where possible, AI where needed**.
| Approach | What it means |
| ------------------------- | --------------------------------------------------- |
| **Programmatic git** | Status checks are scripts, not AI guesses |
| **Rule-based validation** | TypeScript errors come from `tsc`, not prompts |
| **Explicit state** | Session context is JSON, not memory |
| **AI for judgment** | Architecture decisions, code review, prioritization |
This reduces token usage, makes workflows reproducible, and keeps AI focused on what it's actually good at.
---
## More Plugins
PopKit is modular. Install what you need:
| Plugin | What it adds |
| ------------------- | ---------------------------------------------------------------- |
| **popkit-core** | Project setup, Power Mode (multi-agent), session management |
| **popkit-dev** | Git workflows, morning/nightly routines, `/next` recommendations |
| **popkit-ops** | Quality assessments, security scanning, debugging workflows |
| **popkit-research** | Knowledge capture, research notes, documentation sync |
```bash
/plugin install popkit-ops@popkit-claude # Quality & security
/plugin install popkit-research@popkit-claude # Knowledge management
```
---
## Requirements
- Claude Code 2.1.33+
- Python 3.11+
- Git
- GitHub CLI (`gh`) for GitHub integration
---
## Documentation
- **[Documentation Site](https://popkit.unjoe.me)** — Guides and references
- **[CLAUDE.md](CLAUDE.md)** — AI-readable project instructions
- **[CHANGELOG.md](CHANGELOG.md)** — Version history
- **[CONTRIBUTING.md](CONTRIBUTING.md)** — How to contribute
---
## Status
**Version:** 1.0.0-beta.10
**Status:** Public beta — core features stable, actively improving
---
## License
MIT — see [LICENSE](LICENSE)
---
**[Back to Top](#popkit)**