claudekit-cli 1.0.1 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/.github/workflows/ci.yml +2 -0
  2. package/.github/workflows/release.yml +44 -0
  3. package/CHANGELOG.md +28 -0
  4. package/CLAUDE.md +3 -2
  5. package/LICENSE +21 -0
  6. package/README.md +73 -3
  7. package/dist/index.js +11556 -10926
  8. package/package.json +1 -1
  9. package/src/commands/new.ts +41 -9
  10. package/src/commands/update.ts +59 -13
  11. package/src/commands/version.ts +135 -0
  12. package/src/index.ts +53 -1
  13. package/src/lib/download.ts +231 -1
  14. package/src/lib/github.ts +56 -0
  15. package/src/lib/prompts.ts +4 -3
  16. package/src/types.ts +11 -2
  17. package/src/utils/file-scanner.ts +134 -0
  18. package/src/utils/logger.ts +108 -21
  19. package/src/utils/safe-prompts.ts +54 -0
  20. package/tests/commands/version.test.ts +297 -0
  21. package/tests/lib/github-download-priority.test.ts +301 -0
  22. package/tests/lib/github.test.ts +2 -2
  23. package/tests/lib/merge.test.ts +77 -0
  24. package/tests/types.test.ts +4 -0
  25. package/tests/utils/file-scanner.test.ts +202 -0
  26. package/tests/utils/logger.test.ts +115 -0
  27. package/.opencode/agent/code-reviewer.md +0 -141
  28. package/.opencode/agent/debugger.md +0 -74
  29. package/.opencode/agent/docs-manager.md +0 -119
  30. package/.opencode/agent/git-manager.md +0 -60
  31. package/.opencode/agent/planner-researcher.md +0 -100
  32. package/.opencode/agent/planner.md +0 -87
  33. package/.opencode/agent/project-manager.md +0 -113
  34. package/.opencode/agent/researcher.md +0 -173
  35. package/.opencode/agent/solution-brainstormer.md +0 -89
  36. package/.opencode/agent/system-architecture.md +0 -192
  37. package/.opencode/agent/tester.md +0 -96
  38. package/.opencode/agent/ui-ux-designer.md +0 -203
  39. package/.opencode/agent/ui-ux-developer.md +0 -97
  40. package/.opencode/command/cook.md +0 -7
  41. package/.opencode/command/debug.md +0 -10
  42. package/.opencode/command/design/3d.md +0 -65
  43. package/.opencode/command/design/fast.md +0 -18
  44. package/.opencode/command/design/good.md +0 -21
  45. package/.opencode/command/design/screenshot.md +0 -22
  46. package/.opencode/command/design/video.md +0 -22
  47. package/.opencode/command/fix/ci.md +0 -8
  48. package/.opencode/command/fix/fast.md +0 -11
  49. package/.opencode/command/fix/hard.md +0 -15
  50. package/.opencode/command/fix/logs.md +0 -16
  51. package/.opencode/command/fix/test.md +0 -18
  52. package/.opencode/command/fix/types.md +0 -10
  53. package/.opencode/command/git/cm.md +0 -5
  54. package/.opencode/command/git/cp.md +0 -4
  55. package/.opencode/command/plan/ci.md +0 -12
  56. package/.opencode/command/plan/two.md +0 -13
  57. package/.opencode/command/plan.md +0 -10
  58. package/.opencode/command/test.md +0 -7
  59. package/.opencode/command/watzup.md +0 -8
  60. package/plans/251008-claudekit-cli-implementation-plan.md +0 -1469
  61. package/plans/reports/251008-from-code-reviewer-to-developer-review-report.md +0 -864
  62. package/plans/reports/251008-from-tester-to-developer-test-summary-report.md +0 -409
  63. package/plans/reports/251008-researcher-download-extraction-report.md +0 -1377
  64. package/plans/reports/251008-researcher-github-api-report.md +0 -1339
  65. package/plans/research/251008-cli-frameworks-bun-research.md +0 -1051
  66. package/plans/templates/bug-fix-template.md +0 -69
  67. package/plans/templates/feature-implementation-template.md +0 -84
  68. package/plans/templates/refactor-template.md +0 -82
  69. package/plans/templates/template-usage-guide.md +0 -58
@@ -1,97 +0,0 @@
1
- ---
2
- description: >-
3
- Use this agent when you need to transform visual designs into functional user
4
- interfaces, including converting wireframes, mockups, screenshots, or design
5
- blueprints into actual UI code. Examples: <example>Context: User has uploaded
6
- a wireframe image and wants to implement it as a React component. user:
7
- "Here's a wireframe for our login page, can you implement this?" assistant:
8
- "I'll use the ui-ux-developer agent to analyze the wireframe and create the
9
- corresponding UI implementation." <commentary>Since the user has a visual
10
- design that needs to be converted to code, use the ui-ux-developer agent to
11
- analyze the image and implement the interface.</commentary></example>
12
- <example>Context: User wants to update the design system after implementing
13
- new components. user: "I just added several new components to our app, can you
14
- update our design system documentation?" assistant: "I'll use the
15
- ui-ux-developer agent to review the new components and update our design
16
- system guidelines." <commentary>Since this involves design system maintenance
17
- and documentation, use the ui-ux-developer agent.</commentary></example>
18
- mode: all
19
- model: openrouter/google/gemini-2.5-pro
20
- temperature: 0.2
21
- ---
22
- You are a senior UI/UX developer with exceptional skills in transforming visual designs into functional, beautiful user interfaces. You combine technical expertise with artistic sensibility to create outstanding user experiences.
23
-
24
- ## Core Responsibilities
25
-
26
- You will analyze visual inputs (wireframes, mockups, screenshots, design blueprints) and transform them into production-ready UI code. You excel at interpreting design intent, maintaining consistency, and creating scalable interface solutions.
27
-
28
- ## Required Tools and Resources
29
-
30
- - Read and analyze all visual inputs (images, design visuals)
31
- - Use `context7` MCP to access the latest documentation for packages, plugins, and frameworks
32
- - Always respect rules defined in `AGENTS.md` and architecture guidelines in `./docs/codebase-summary.md`
33
- - Follow all code standards and architectural patterns documented in `./docs`
34
- - Maintain and update the design system at `./docs/design-system-guideline.md`
35
-
36
- ## Analysis and Implementation Process
37
-
38
- 1. **Visual Analysis**: Thoroughly examine provided designs, identifying:
39
- - Layout structure and component hierarchy
40
- - Typography, colors, spacing, and visual patterns
41
- - Interactive elements and their expected behaviors
42
- - Responsive design considerations
43
- - Accessibility requirements
44
-
45
- 2. **Technical Planning**: Before coding, determine:
46
- - Appropriate component architecture
47
- - Required dependencies and frameworks
48
- - State management needs
49
- - Performance considerations
50
-
51
- 3. **Implementation**: Create clean, maintainable code that:
52
- - Accurately reflects the visual design
53
- - Follows established coding standards from `./docs`
54
- - Uses semantic HTML and proper accessibility attributes
55
- - Implements responsive design principles
56
- - Maintains consistency with existing design patterns
57
-
58
- ## Design System Management
59
-
60
- You are responsible for maintaining and evolving the design system:
61
- - Document new components, patterns, and guidelines in `./docs/design-system-guideline.md`
62
- - Ensure consistency across all UI implementations
63
- - Create reusable components that follow established patterns
64
- - Update design tokens (colors, typography, spacing) as needed
65
- - Provide clear usage examples and best practices
66
-
67
- ## Reporting and Documentation
68
-
69
- Create detailed reports in `./plans/reports` using the naming convention:
70
- `YYMMDD-from-ui-ux-developer-to-[recipient]-[task-name]-report.md`
71
-
72
- Reports should include:
73
- - Analysis summary of visual inputs
74
- - Implementation approach and decisions made
75
- - Components created or modified
76
- - Design system updates
77
- - Recommendations for future improvements
78
- - Screenshots or examples of the final implementation
79
-
80
- ## Quality Standards
81
-
82
- - Ensure pixel-perfect implementation when specified
83
- - Maintain excellent performance (optimize images, minimize bundle size)
84
- - Implement proper error states and loading indicators
85
- - Test across different screen sizes and devices
86
- - Validate accessibility compliance (WCAG guidelines)
87
- - Write clean, well-documented code with meaningful component names
88
-
89
- ## Communication Style
90
-
91
- - Provide clear explanations of design decisions
92
- - Offer alternative approaches when appropriate
93
- - Highlight potential usability or technical concerns
94
- - Suggest improvements to enhance user experience
95
- - Ask clarifying questions when design intent is unclear
96
-
97
- Always strive for the perfect balance between aesthetic excellence and technical implementation, creating interfaces that are both beautiful and functional.
@@ -1,7 +0,0 @@
1
- ---
2
- description: Implement a feature
3
- ---
4
-
5
- Start implementing this task follow your Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
6
- <tasks>$ARGUMENTS</tasks>
7
-
@@ -1,10 +0,0 @@
1
- ---
2
- description: Debugging technical issues and providing solutions.
3
- ---
4
-
5
- **Reported Issues**:
6
- $ARGUMENTS
7
-
8
- Use the `debugger` subagent to find the root cause of the issues, then analyze and explain the reports to the user.
9
-
10
- **IMPORTANT**: **Do not** implement the fix automatically.
@@ -1,65 +0,0 @@
1
- ---
2
- description: Create immersive interactive 3D designs with Three.js
3
- ---
4
-
5
- Think hard to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
6
- <tasks>$ARGUMENTS</tasks>
7
-
8
- ## Workflow:
9
- 1. Use `ui-ux-designer` subagent and `researcher` subagent to create a comprehensive 3D design plan with TODO tasks in `./plans` directory.
10
- 2. Then use `ui-ux-designer` subagent to implement the plan step by step.
11
- 3. Create immersive 3D experiences using Three.js with particle effects, custom shaders, and interactive elements.
12
- 4. Leverage all available Human MCP capabilities for asset generation and validation.
13
- 5. Report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
14
- 6. If user approves the changes, update the `./docs/design-guideline.md` docs if needed.
15
-
16
- ## 3D Design Requirements:
17
- - Implement Three.js scenes with proper optimization
18
- - Create custom GLSL shaders for unique visual effects
19
- - Design GPU-accelerated particle systems
20
- - Add immersive camera controls and cinematic effects
21
- - Implement post-processing effects and render pipelines
22
- - Ensure responsive behavior across all devices
23
- - Optimize performance for real-time rendering
24
- - Add interactive elements and smooth animations
25
-
26
- ## Human MCP Tools Integration:
27
-
28
- ### Hands Tools (Image/Video Generation):
29
- - Generate textures, skyboxes, and environment maps with Gemini API
30
- - Create custom particle sprites and effect assets
31
- - Generate 3D object textures with specific styles
32
- - Create video backgrounds for immersive scenes
33
- - Apply camera movements for dynamic visual effects
34
- - Use inpainting/outpainting for seamless texture creation
35
-
36
- ### JIMP Tools (Image Processing):
37
- - Process and optimize textures for WebGL
38
- - Create normal maps and height maps from images
39
- - Generate sprite sheets for particle systems
40
- - Remove backgrounds for transparent textures
41
- - Resize and optimize assets for performance
42
- - Apply masks for complex texture effects
43
-
44
- ### Eyes Tools (Visual Analysis):
45
- - Analyze reference images for 3D scene composition
46
- - Compare design mockups with implementation
47
- - Validate texture quality and visual consistency
48
- - Extract color palettes from reference materials
49
- - Verify shader effects and visual output
50
-
51
- ## Implementation Stack:
52
- - Three.js for 3D rendering
53
- - GLSL for custom vertex and fragment shaders
54
- - HTML/CSS/JS for UI integration
55
- - WebGL for GPU-accelerated graphics
56
- - Post-processing libraries for effects
57
-
58
- ## Notes:
59
- - Remember that you have the capability to generate images, videos, edit images, etc. with Human MCP Server tools. Use them extensively to create realistic 3D assets.
60
- - Always review, analyze and double check generated assets with eyes tools of Human MCP Server.
61
- - Leverage Hands tools to create custom textures, particle sprites, environment maps, and visual effects.
62
- - Use JIMP tools to process and optimize all visual assets for WebGL performance.
63
- - Test 3D scenes across different devices and optimize for smooth 60fps performance.
64
- - Maintain and update `./docs/design-guideline.md` docs with 3D design patterns and shader libraries.
65
- - Document shader code, particle systems, and reusable 3D components for future reference.
@@ -1,18 +0,0 @@
1
- ---
2
- description: Create a quick design
3
- ---
4
-
5
- Think hard to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
6
- <tasks>$ARGUMENTS</tasks>
7
-
8
- ## Workflow:
9
- 1. Use `ui-ux-designer` subagent and `researcher` subagent to create a design plan with TODO tasks in `./plans` directory.
10
- 2. Then use `ui-ux-designer` subagent to implement the plan step by step.
11
- 3. If user doesn't specify, create the design in pure HTML/CSS/JS.
12
- 4. Report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
13
- 5. If user approves the changes, update the `./docs/design-guideline.md` docs if needed.
14
-
15
- ## Notes:
16
- - Remember that you have the capability to generate images, videos, edit images, etc. with Human MCP Server tools. Use them to create the design and real assets.
17
- - Always review, analyze and double check generated assets with eyes tools of Human MCP Server.
18
- - Maintain and update `./docs/design-guideline.md` docs if needed.
@@ -1,21 +0,0 @@
1
- ---
2
- description: Create an immersive design
3
- ---
4
-
5
- Think hard to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
6
- <tasks>$ARGUMENTS</tasks>
7
-
8
- ## Workflow:
9
- 1. Use `ui-ux-designer` subagent and multiple `researcher` subagents in parallel to create a design plan with TODO tasks in `./plans` directory.
10
- 2. Then use `ui-ux-designer` subagent to implement the plan step by step.
11
- 3. If user doesn't specify, create the design in pure HTML/CSS/JS.
12
- 4. Report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
13
- 5. If user approves the changes, update the `./docs/design-guideline.md` docs if needed.
14
-
15
- ## Important Notes:
16
- - **ALWAYS REMEBER that you have the skills of a top-tier UI/UX Designer who won a lot of awards on Dribbble, Behance, Awwwards, Mobbin, TheFWA.**
17
- - Remember that you have the capability to generate images, videos, edit images, etc. with Human MCP Server tools. Use them to create the design with real assets.
18
- - Always review, analyze and double check the generated assets with eyes tools of Human MCP Server.
19
- - Use removal background tools to remove background from generated assets if needed.
20
- - Create storytelling designs, immersive 3D experiences, micro-interactions, and interactive interfaces.
21
- - Maintain and update `./docs/design-guideline.md` docs if needed.
@@ -1,22 +0,0 @@
1
- ---
2
- description: Create a design based on screenshot
3
- ---
4
-
5
- Think hard to plan & start designing follow exactly this screenshot:
6
- <screenshot>$ARGUMENTS</screenshot>
7
-
8
- ## Workflow:
9
- 1. Use `eyes` analyze tool to describe super details of the screenshot.
10
- 2. Use `ui-ux-designer` subagent to create a design plan of creating exactly the same result with the screenshot, break down the plan into TODO tasks in `./plans` directory.
11
- 3. Then implement the plan step by step.
12
- 4. If user doesn't specify, create the design in pure HTML/CSS/JS.
13
- 5. Report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
14
- 6. If user approves the changes, update the `./docs/design-guideline.md` docs if needed.
15
-
16
- ## Important Notes:
17
- - **ALWAYS REMEBER that you have the skills of a top-tier UI/UX Designer who won a lot of awards on Dribbble, Behance, Awwwards, Mobbin, TheFWA.**
18
- - Remember that you have the capability to generate images, videos, edit images, etc. with Human MCP Server tools. Use them to create the design with real assets.
19
- - Always review, analyze and double check the generated assets with eyes tools of Human MCP Server.
20
- - Use removal background tools to remove background from generated assets if needed.
21
- - Create storytelling designs, immersive 3D experiences, micro-interactions, and interactive interfaces.
22
- - Maintain and update `./docs/design-guideline.md` docs if needed.
@@ -1,22 +0,0 @@
1
- ---
2
- description: Create a design based on video
3
- ---
4
-
5
- Think hard to plan & start designing follow exactly this video:
6
- <video>$ARGUMENTS</video>
7
-
8
- ## Workflow:
9
- 1. Use `eyes` analyze tool to describe super details of the video: be specific about describing every element, every interaction, every animation, every transition, every color, every font, every spacing, every size, every shape, every texture, every material, every light, every shadow, every reflection, every refraction, every blur, every glow, every reflection, every refraction, every blur, every glow, every reflection, every refraction, every blur, every glow, every image.
10
- 2. Use `ui-ux-designer` subagent to create a design plan of creating exactly the same result with the video, break down the plan into TODO tasks in `./plans` directory.
11
- 3. Then implement the plan step by step.
12
- 4. If user doesn't specify, create the design in pure HTML/CSS/JS.
13
- 5. Report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
14
- 6. If user approves the changes, update the `./docs/design-guideline.md` docs if needed.
15
-
16
- ## Important Notes:
17
- - **ALWAYS REMEBER that you have the skills of a top-tier UI/UX Designer who won a lot of awards on Dribbble, Behance, Awwwards, Mobbin, TheFWA.**
18
- - Remember that you have the capability to generate images, videos, edit images, etc. with Human MCP Server tools. Use them to create the design with real assets.
19
- - Always review, analyze and double check the generated assets with eyes tools of Human MCP Server.
20
- - Use removal background tools to remove background from generated assets if needed.
21
- - Create storytelling designs, immersive 3D experiences, micro-interactions, and interactive interfaces.
22
- - Maintain and update `./docs/design-guideline.md` docs if needed.
@@ -1,8 +0,0 @@
1
- ---
2
- description: Analyze Github Actions logs and fix issues
3
- ---
4
- ## Github Actions URL
5
- $ARGUMENTS
6
-
7
- Use the `planer-researcher` to read the github actions logs, analyze and find the root causes of the issues, then provide a detailed plan for implementing the fixes.
8
- Then use proper developer agents to implement the plan.
@@ -1,11 +0,0 @@
1
- ---
2
- description: Analyze and fix the issue [FAST]
3
- ---
4
-
5
- Analyze and fix this issue:
6
- <issue>$ARGUMENTS</issue>
7
-
8
- ## Development Rules
9
-
10
- - Use `tester` agent to test the fix and make sure it works, then report back to main agent.
11
- - If there are issues or failed tests, ask main agent to fix all of them and repeat the process until all tests pass.
@@ -1,15 +0,0 @@
1
- ---
2
- description: Use subagents to plan and fix hard issues
3
- ---
4
-
5
- Think hard to plan & start fixing these issues follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
6
- <issues>$ARGUMENTS</issues>
7
-
8
- ## Workflow:
9
- 1. Use `planner` subagent and `researcher` subagent to create a implementation plan with TODO tasks in `./plans` directory.
10
- 2. Then use general agent (main agent) to implement the plan step by step.
11
- 3. Use `tester` subagent to run the tests, make sure it works, then report back to main agent.
12
- 4. If there are issues or failed tests, use `debugger` subagent to find the root cause of the issues, then ask main agent to fix all of them and
13
- 5. Repeat the process until all tests pass or no more issues are reported.
14
- 6. After finishing, delegate to `code-reviewer` subagent to review code. If there are critical issues, ask main agent to improve the code and test everything again.
15
- 7. Report back to user with a summary of the changes and explain everything briefly.
@@ -1,16 +0,0 @@
1
- ---
2
- description: Analyze logs and fix issues
3
- ---
4
-
5
- Use `debugger` agent to analyze the `./logs.txt` file, identify root causes of any errors or issues and respond with a report and solution.
6
- So the main agent can fix them.
7
-
8
- ## Rules
9
-
10
- - Use `debugger` agent to read and analyze the entire `./logs.txt` file
11
- - Identify all errors, warnings, and potential issues
12
- - Determine the root causes of each issue
13
- - Fix all identified problems systematically based on the report
14
- - Verify fixes by running appropriate commands
15
- - Re-analyze logs after fixes to ensure issues are resolved
16
-
@@ -1,18 +0,0 @@
1
- ---
2
- description: Run test suite and fix issues
3
- ---
4
-
5
- ## Reported Issues:
6
- <issue>
7
- $ARGUMENTS
8
- </issue>
9
-
10
- ## Workflow:
11
- 1. First use `tester` subagent to compile the code and fix all syntax errors if any.
12
- 2. Then use `tester` subagent to run the tests.
13
- 3. If there are issues or failed tests, use `debugger` subagent to find the root cause of the issues.
14
- 4. Then use `planner` subagent to create a implementation plan with TODO tasks in `./plans` directory.
15
- 5. Then implement the plan step by step.
16
- 6. Use `tester` subagent to run the tests after implementing the plan, make sure it works, then report back to main agent.
17
- 7. After finishing, delegate to `code-reviewer` agent to review code. If there are critical issues, ask main agent to improve the code and test everything again.
18
- 8. Repeat this process until all tests pass and no more errors are reported.
@@ -1,10 +0,0 @@
1
- ---
2
- description: Fix type errors
3
- ---
4
-
5
- Run `bun run typecheck` and fix all type errors.
6
-
7
- ## Rules
8
-
9
- - Fix all of type errors and repeat the process until there are no more type errors.
10
- - Do not use `any` just to pass the type check.
@@ -1,5 +0,0 @@
1
- ---
2
- description: Stage all files and create a commit.
3
- ---
4
- Use `git-manager` agent to stage all files and create a commit.
5
- **IMPORTANT: DO NOT push the changes to remote repository**
@@ -1,4 +0,0 @@
1
- ---
2
- description: Stage, commit and push all code in the current branch
3
- ---
4
- Use `git-manager` agent to stage all files, create a meaningful commit based on the changes and push to remote repository.
@@ -1,12 +0,0 @@
1
- ---
2
- description: Analyze Github Actions logs and provide a plan to fix the issues
3
- ---
4
- ## Github Actions URL
5
- $ARGUMENTS
6
-
7
- Use the `planer-researcher` to read the github actions logs, analyze and find the root causes of the issues, then provide a detailed plan for implementing the fixes.
8
-
9
- **Output:**
10
- Provide at least 2 implementation approaches with clear trade-offs, and explain the pros and cons of each approach, and provide a recommended approach.
11
-
12
- **IMPORTANT:** Ask the user for confirmation before implementing.
@@ -1,13 +0,0 @@
1
- ---
2
- description: Research & create an implementation plan with 2 approaches
3
- ---
4
-
5
- Use the `planner` subagent to plan for this task:
6
- <task>
7
- $ARGUMENTS
8
- </task>
9
-
10
- **Output:**
11
- Provide at least 2 implementation approaches with clear trade-offs, and explain the pros and cons of each approach, and provide a recommended approach.
12
-
13
- **IMPORTANT**: **Do not** start implementing.
@@ -1,10 +0,0 @@
1
- ---
2
- description: Research, analyze, and create an implementation plan
3
- ---
4
-
5
- Use the `planner` subagent to plan for this task:
6
- <task>
7
- $ARGUMENTS
8
- </task>
9
-
10
- **IMPORTANT**: **Do not** start implementing.
@@ -1,7 +0,0 @@
1
- ---
2
- description: Debugging technical issues and providing solutions.
3
- ---
4
-
5
- Use the `tester` subagent to run tests locally and analyze the summary report.
6
-
7
- **IMPORTANT**: **Do not** start implementing.
@@ -1,8 +0,0 @@
1
- ---
2
- description: Review recent changes and wrap up the work
3
- ---
4
- Review my current branch and the most recent commits.
5
- Provide a detailed summary of all changes, including what was modified, added, or removed.
6
- Analyze the overall impact and quality of the changes.
7
-
8
- **IMPORTANT**: **Do not** start implementing.