{"id":37095993,"url":"https://github.com/jrc1883/popkit-claude","last_synced_at":"2026-02-16T03:18:08.377Z","repository":{"id":328019484,"uuid":"1113536860","full_name":"jrc1883/popkit-claude","owner":"jrc1883","description":"AI-powered development workflow automation for Claude Code. Modular plugin suite with 23 commands, 38 skills, and 22 specialized agents for professional software development.","archived":false,"fork":false,"pushed_at":"2026-01-09T00:20:01.000Z","size":6279,"stargazers_count":0,"open_issues_count":16,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-09T00:21:29.248Z","etag":null,"topics":["ai-workflows","automation","claude-code","claude-plugin","developer-tools","development-tools","productivity","python","typescript","workflow-automation"],"latest_commit_sha":null,"homepage":"https://github.com/jrc1883/popkit-claude#readme","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jrc1883.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":null},"created_at":"2025-12-10T05:40:33.000Z","updated_at":"2026-01-09T00:18:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jrc1883/popkit-claude","commit_stats":null,"previous_names":["jrc1883/popkit-claude"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/jrc1883/popkit-claude","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrc1883%2Fpopkit-claude","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrc1883%2Fpopkit-claude/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrc1883%2Fpopkit-claude/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrc1883%2Fpopkit-claude/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jrc1883","download_url":"https://codeload.github.com/jrc1883/popkit-claude/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrc1883%2Fpopkit-claude/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28419261,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T10:47:48.104Z","status":"ssl_error","status_checked_at":"2026-01-14T10:46:19.031Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-workflows","automation","claude-code","claude-plugin","developer-tools","development-tools","productivity","python","typescript","workflow-automation"],"created_at":"2026-01-14T11:49:25.227Z","updated_at":"2026-02-16T03:18:08.369Z","avatar_url":"https://github.com/jrc1883.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PopKit\n\n\u003cdiv align=\"center\"\u003e\n\n**Development workflows that actually work**\n\nStart each day knowing your project is healthy.\nEnd each day with context saved for tomorrow.\nKnow exactly what to do next.\n\n[Get Started](#get-started) · [Morning Routine](#morning-routine) · [What's Next](#whats-next) · [Docs](https://popkit.unjoe.me)\n\n\u003c/div\u003e\n\n---\n\n## What is PopKit?\n\nPopKit organizes your Claude Code sessions around **workflows, not tools**.\n\nMost AI coding assistants give you a prompt and say \"figure it out.\" PopKit gives you:\n\n- **Morning routines** that check your project health before you write code\n- **\"What's next?\"** recommendations based on your actual git status, failing tests, and open issues\n- **Guided development** that walks you through feature implementation phase by phase\n- **Session capture** so you can pick up exactly where you left off\n\nIt's the difference between \"here's an AI\" and \"here's how to use AI to build software.\"\n\n---\n\n## Get Started\n\n```bash\n# Add the PopKit marketplace\n/plugin marketplace add jrc1883/popkit-claude\n\n# Install the plugins you need\n/plugin install popkit-core@popkit-claude   # Foundation\n/plugin install popkit-dev@popkit-claude    # Development workflows\n\n# Restart Claude Code, then run your first morning routine:\n/popkit-dev:routine morning\n```\n\n---\n\n## Morning Routine\n\nEvery morning, PopKit checks your project's vital signs:\n\n```\n/popkit-dev:routine morning\n```\n\n```\n■ Session Restored\n  Last: Fixed authentication flow (2h ago)\n\n■ Ready to Code Score: 87/100\n\n  ✓ Git status clean\n  ✓ Tests passing (142/142)\n  ✓ CI green on main\n  ⚠ 2 dependencies outdated\n  ✓ No TypeScript errors\n\n■ Context Loaded\n  Active issue: #47 Add password reset flow\n  Branch: feat/password-reset (3 commits ahead of main)\n\nReady to continue.\n```\n\nThe \"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.\n\n---\n\n## What's Next\n\nWhen you're not sure what to work on:\n\n```\n/popkit-dev:next\n```\n\nPopKit analyzes your git status, test results, GitHub issues, and TypeScript errors to recommend prioritized actions:\n\n```\nRecommended Actions:\n\n1. Merge main into branch (Score: 85)\n   Branch is 5 commits behind main\n\n2. Fix TypeScript error in src/auth.ts:47 (Score: 78)\n   Type 'string | undefined' is not assignable to type 'string'\n\n3. Continue issue #47 (Score: 72)\n   Password reset flow - implementation started\n\n4. Review PR #51 (Score: 65)\n   Dependency update, waiting 2 days\n```\n\nNo more staring at your terminal wondering what to do.\n\n---\n\n## Guided Development\n\nStart a feature with `/popkit-dev:dev`:\n\n```\n/popkit-dev:dev \"Add password reset via email\"\n```\n\nPopKit walks you through seven phases:\n\n1. **Discovery** — What exactly are we building?\n2. **Exploration** — What patterns exist in this codebase?\n3. **Questions** — What do we need to clarify before coding?\n4. **Architecture** — How should we structure this?\n5. **Implementation** — Write the code, phase by phase\n6. **Review** — Check what we built\n7. **Summary** — Document what changed\n\nEach phase has checkpoints. You approve before moving forward.\n\n---\n\n## Nightly Routine\n\nEnd your day with context saved:\n\n```\n/popkit-dev:routine nightly\n```\n\n```\n■ Sleep Score: 92/100\n\n  ✓ All changes committed\n  ✓ Branch pushed to origin\n  ✓ Tests passing\n  ✓ No uncommitted stashes\n\n■ Session Captured\n  Work: Implemented password reset email flow\n  Next: Add reset token validation endpoint\n\n■ Dependencies\n  2 security updates available (non-breaking)\n\nSweet dreams.\n```\n\nTomorrow's morning routine will restore this context automatically.\n\n---\n\n## The Philosophy\n\nPopKit tries to be **programmatic where possible, AI where needed**.\n\n| Approach                  | What it means                                       |\n| ------------------------- | --------------------------------------------------- |\n| **Programmatic git**      | Status checks are scripts, not AI guesses           |\n| **Rule-based validation** | TypeScript errors come from `tsc`, not prompts      |\n| **Explicit state**        | Session context is JSON, not memory                 |\n| **AI for judgment**       | Architecture decisions, code review, prioritization |\n\nThis reduces token usage, makes workflows reproducible, and keeps AI focused on what it's actually good at.\n\n---\n\n## More Plugins\n\nPopKit is modular. Install what you need:\n\n| Plugin              | What it adds                                                     |\n| ------------------- | ---------------------------------------------------------------- |\n| **popkit-core**     | Project setup, Power Mode (multi-agent), session management      |\n| **popkit-dev**      | Git workflows, morning/nightly routines, `/next` recommendations |\n| **popkit-ops**      | Quality assessments, security scanning, debugging workflows      |\n| **popkit-research** | Knowledge capture, research notes, documentation sync            |\n\n```bash\n/plugin install popkit-ops@popkit-claude      # Quality \u0026 security\n/plugin install popkit-research@popkit-claude # Knowledge management\n```\n\n---\n\n## Requirements\n\n- Claude Code 2.1.33+\n- Python 3.11+\n- Git\n- GitHub CLI (`gh`) for GitHub integration\n\n---\n\n## Documentation\n\n- **[Documentation Site](https://popkit.unjoe.me)** — Guides and references\n- **[CLAUDE.md](CLAUDE.md)** — AI-readable project instructions\n- **[CHANGELOG.md](CHANGELOG.md)** — Version history\n- **[CONTRIBUTING.md](CONTRIBUTING.md)** — How to contribute\n\n---\n\n## Status\n\n**Version:** 1.0.0-beta.10\n**Status:** Public beta — core features stable, actively improving\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**[Back to Top](#popkit)**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjrc1883%2Fpopkit-claude","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjrc1883%2Fpopkit-claude","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjrc1883%2Fpopkit-claude/lists"}