claudekit-cli 1.0.0 → 1.1.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 (116) hide show
  1. package/.github/workflows/ci.yml +2 -0
  2. package/CHANGELOG.md +19 -0
  3. package/CLAUDE.md +7 -0
  4. package/README.md +61 -3
  5. package/biome.json +3 -0
  6. package/dist/index.js +102 -0
  7. package/package.json +1 -1
  8. package/src/commands/version.ts +135 -0
  9. package/src/index.ts +11 -0
  10. package/src/types.ts +7 -0
  11. package/tests/commands/version.test.ts +297 -0
  12. package/.claude/agents/brainstormer.md +0 -96
  13. package/.claude/agents/code-reviewer.md +0 -141
  14. package/.claude/agents/copywriter.md +0 -108
  15. package/.claude/agents/database-admin.md +0 -86
  16. package/.claude/agents/debugger.md +0 -124
  17. package/.claude/agents/docs-manager.md +0 -115
  18. package/.claude/agents/git-manager.md +0 -60
  19. package/.claude/agents/journal-writer.md +0 -111
  20. package/.claude/agents/planner.md +0 -87
  21. package/.claude/agents/project-manager.md +0 -113
  22. package/.claude/agents/researcher.md +0 -173
  23. package/.claude/agents/scout.md +0 -123
  24. package/.claude/agents/tester.md +0 -95
  25. package/.claude/agents/ui-ux-designer.md +0 -206
  26. package/.claude/commands/bootstrap.md +0 -104
  27. package/.claude/commands/brainstorm.md +0 -67
  28. package/.claude/commands/content/enhance.md +0 -13
  29. package/.claude/commands/content/fast.md +0 -11
  30. package/.claude/commands/content/good.md +0 -13
  31. package/.claude/commands/cook.md +0 -19
  32. package/.claude/commands/debug.md +0 -10
  33. package/.claude/commands/design/3d.md +0 -65
  34. package/.claude/commands/design/describe.md +0 -13
  35. package/.claude/commands/design/fast.md +0 -19
  36. package/.claude/commands/design/good.md +0 -23
  37. package/.claude/commands/design/screenshot.md +0 -23
  38. package/.claude/commands/design/video.md +0 -23
  39. package/.claude/commands/docs/init.md +0 -13
  40. package/.claude/commands/docs/summarize.md +0 -10
  41. package/.claude/commands/docs/update.md +0 -21
  42. package/.claude/commands/fix/ci.md +0 -11
  43. package/.claude/commands/fix/fast.md +0 -12
  44. package/.claude/commands/fix/hard.md +0 -18
  45. package/.claude/commands/fix/logs.md +0 -16
  46. package/.claude/commands/fix/test.md +0 -18
  47. package/.claude/commands/fix/types.md +0 -10
  48. package/.claude/commands/git/cm.md +0 -5
  49. package/.claude/commands/git/cp.md +0 -4
  50. package/.claude/commands/integrate/polar.md +0 -42
  51. package/.claude/commands/plan/ci.md +0 -12
  52. package/.claude/commands/plan/two.md +0 -13
  53. package/.claude/commands/plan.md +0 -10
  54. package/.claude/commands/scout.md +0 -29
  55. package/.claude/commands/test.md +0 -7
  56. package/.claude/commands/watzup.md +0 -8
  57. package/.claude/hooks/telegram_notify.sh +0 -136
  58. package/.claude/send-discord.sh +0 -64
  59. package/.claude/settings.json +0 -7
  60. package/.claude/statusline.sh +0 -143
  61. package/.claude/workflows/development-rules.md +0 -80
  62. package/.claude/workflows/documentation-management.md +0 -28
  63. package/.claude/workflows/orchestration-protocol.md +0 -16
  64. package/.claude/workflows/primary-workflow.md +0 -41
  65. package/.opencode/agent/code-reviewer.md +0 -141
  66. package/.opencode/agent/debugger.md +0 -74
  67. package/.opencode/agent/docs-manager.md +0 -119
  68. package/.opencode/agent/git-manager.md +0 -60
  69. package/.opencode/agent/planner-researcher.md +0 -100
  70. package/.opencode/agent/planner.md +0 -87
  71. package/.opencode/agent/project-manager.md +0 -113
  72. package/.opencode/agent/researcher.md +0 -173
  73. package/.opencode/agent/solution-brainstormer.md +0 -89
  74. package/.opencode/agent/system-architecture.md +0 -192
  75. package/.opencode/agent/tester.md +0 -96
  76. package/.opencode/agent/ui-ux-designer.md +0 -203
  77. package/.opencode/agent/ui-ux-developer.md +0 -97
  78. package/.opencode/command/cook.md +0 -7
  79. package/.opencode/command/debug.md +0 -10
  80. package/.opencode/command/design/3d.md +0 -65
  81. package/.opencode/command/design/fast.md +0 -18
  82. package/.opencode/command/design/good.md +0 -21
  83. package/.opencode/command/design/screenshot.md +0 -22
  84. package/.opencode/command/design/video.md +0 -22
  85. package/.opencode/command/docs/init.md +0 -11
  86. package/.opencode/command/docs/summarize.md +0 -10
  87. package/.opencode/command/docs/update.md +0 -18
  88. package/.opencode/command/fix/ci.md +0 -8
  89. package/.opencode/command/fix/fast.md +0 -11
  90. package/.opencode/command/fix/hard.md +0 -15
  91. package/.opencode/command/fix/logs.md +0 -16
  92. package/.opencode/command/fix/test.md +0 -18
  93. package/.opencode/command/fix/types.md +0 -10
  94. package/.opencode/command/git/cm.md +0 -5
  95. package/.opencode/command/git/cp.md +0 -4
  96. package/.opencode/command/plan/ci.md +0 -12
  97. package/.opencode/command/plan/two.md +0 -13
  98. package/.opencode/command/plan.md +0 -10
  99. package/.opencode/command/test.md +0 -7
  100. package/.opencode/command/watzup.md +0 -8
  101. package/docs/code-standards.md +0 -1128
  102. package/docs/codebase-summary.md +0 -821
  103. package/docs/github-setup.md +0 -176
  104. package/docs/project-pdr.md +0 -739
  105. package/docs/system-architecture.md +0 -950
  106. package/docs/tech-stack.md +0 -290
  107. package/plans/251008-claudekit-cli-implementation-plan.md +0 -1469
  108. package/plans/reports/251008-from-code-reviewer-to-developer-review-report.md +0 -864
  109. package/plans/reports/251008-from-tester-to-developer-test-summary-report.md +0 -409
  110. package/plans/reports/251008-researcher-download-extraction-report.md +0 -1377
  111. package/plans/reports/251008-researcher-github-api-report.md +0 -1339
  112. package/plans/research/251008-cli-frameworks-bun-research.md +0 -1051
  113. package/plans/templates/bug-fix-template.md +0 -69
  114. package/plans/templates/feature-implementation-template.md +0 -84
  115. package/plans/templates/refactor-template.md +0 -82
  116. package/plans/templates/template-usage-guide.md +0 -58
@@ -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,11 +0,0 @@
1
- ---
2
- description: Analyze the codebase and create initial documentation
3
- ---
4
-
5
- Use `docs/` directory as the source of truth for documentation.
6
- Use `docs-manager` agent to analyze the codebase and create initial documentation:
7
- - `docs/project-overview-pdr.md`: Project overview and PDR (Product Development Requirements)
8
- - `docs/codebase-summary.md`: Codebase summary
9
- - `docs/codebase-structure-architecture-code-standards.md`: Codebase structure, architecture, and code standards
10
-
11
- **IMPORTANT**: **Do not** start implementing.
@@ -1,10 +0,0 @@
1
- ---
2
- description: Analyze the codebase and update documentation
3
- ---
4
-
5
- Use `docs-manager` agent to analyze the codebase and update `docs/codebase-summary.md`
6
-
7
- ## Notes:
8
- - Use `docs/` directory as the source of truth for documentation.
9
-
10
- **IMPORTANT**: **Do not** start implementing.
@@ -1,18 +0,0 @@
1
- ---
2
- description: Analyze the codebase and update documentation
3
- ---
4
-
5
- Use `docs/` directory as the source of truth for documentation.
6
- Use `docs-manager` agent to analyze the codebase and update documentation:
7
- - `README.md`: Update README
8
- - `docs/project-overview-pdr.md`: Update project overview and PDR (Product Development Requirements)
9
- - `docs/codebase-summary.md`: Update codebase summary
10
- - `docs/codebase-structure-architecture-code-standards.md`: Update codebase structure, architecture, and code standards
11
- - Only update `CLAUDE.md` or `AGENTS.md` when requested.
12
-
13
- ## Additional requests
14
- <additional_requests>
15
- $ARGUMENTS
16
- </additional_requests>
17
-
18
- **IMPORTANT**: **Do not** start implementing.
@@ -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.