lite-kits 0.1.1__tar.gz → 0.3.1__tar.gz

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 (68) hide show
  1. lite_kits-0.3.1/.gitignore +48 -0
  2. {lite_kits-0.1.1 → lite_kits-0.3.1}/LICENSE +21 -21
  3. lite_kits-0.3.1/PKG-INFO +259 -0
  4. lite_kits-0.3.1/README.md +230 -0
  5. {lite_kits-0.1.1 → lite_kits-0.3.1}/pyproject.toml +2 -2
  6. lite_kits-0.3.1/src/lite_kits/__init__.py +61 -0
  7. lite_kits-0.3.1/src/lite_kits/cli.py +1007 -0
  8. {lite_kits-0.1.1 → lite_kits-0.3.1}/src/lite_kits/core/__init__.py +6 -0
  9. {lite_kits-0.1.1 → lite_kits-0.3.1}/src/lite_kits/core/banner.py +1 -1
  10. lite_kits-0.3.1/src/lite_kits/core/conflict_checker.py +115 -0
  11. lite_kits-0.3.1/src/lite_kits/core/detector.py +140 -0
  12. lite_kits-0.3.1/src/lite_kits/core/installer.py +322 -0
  13. {lite_kits-0.1.1 → lite_kits-0.3.1}/src/lite_kits/core/manifest.py +146 -146
  14. lite_kits-0.3.1/src/lite_kits/core/validator.py +146 -0
  15. {lite_kits-0.1.1 → lite_kits-0.3.1}/src/lite_kits/kits/README.md +6 -6
  16. {lite_kits-0.1.1 → lite_kits-0.3.1}/src/lite_kits/kits/dev/README.md +241 -241
  17. {lite_kits-0.1.1/src/lite_kits/kits/dev/claude/commands → lite_kits-0.3.1/src/lite_kits/kits/dev/commands/.claude}/audit.md +143 -143
  18. {lite_kits-0.1.1/src/lite_kits/kits/dev/claude/commands → lite_kits-0.3.1/src/lite_kits/kits/dev/commands/.claude}/cleanup.md +2 -2
  19. {lite_kits-0.1.1/src/lite_kits/kits/git/claude/commands → lite_kits-0.3.1/src/lite_kits/kits/dev/commands/.claude}/commit.md +2 -2
  20. {lite_kits-0.1.1/src/lite_kits/kits/project/claude/commands → lite_kits-0.3.1/src/lite_kits/kits/dev/commands/.claude}/orient.md +3 -4
  21. {lite_kits-0.1.1/src/lite_kits/kits/git/claude/commands → lite_kits-0.3.1/src/lite_kits/kits/dev/commands/.claude}/pr.md +1 -1
  22. {lite_kits-0.1.1/src/lite_kits/kits/git/claude/commands → lite_kits-0.3.1/src/lite_kits/kits/dev/commands/.claude}/review.md +202 -202
  23. {lite_kits-0.1.1/src/lite_kits/kits/project/claude/commands → lite_kits-0.3.1/src/lite_kits/kits/dev/commands/.claude}/stats.md +162 -162
  24. {lite_kits-0.1.1/src/lite_kits/kits/project/github/prompts → lite_kits-0.3.1/src/lite_kits/kits/dev/commands/.github}/audit.prompt.md +143 -143
  25. {lite_kits-0.1.1/src/lite_kits/kits/git/github/prompts → lite_kits-0.3.1/src/lite_kits/kits/dev/commands/.github}/cleanup.prompt.md +2 -2
  26. {lite_kits-0.1.1/src/lite_kits/kits/git/github/prompts → lite_kits-0.3.1/src/lite_kits/kits/dev/commands/.github}/commit.prompt.md +2 -2
  27. {lite_kits-0.1.1/src/lite_kits/kits/dev/github/prompts → lite_kits-0.3.1/src/lite_kits/kits/dev/commands/.github}/orient.prompt.md +3 -4
  28. {lite_kits-0.1.1/src/lite_kits/kits/dev/github/prompts → lite_kits-0.3.1/src/lite_kits/kits/dev/commands/.github}/pr.prompt.md +1 -1
  29. {lite_kits-0.1.1/src/lite_kits/kits/git/github/prompts → lite_kits-0.3.1/src/lite_kits/kits/dev/commands/.github}/review.prompt.md +202 -202
  30. {lite_kits-0.1.1/src/lite_kits/kits/dev/github/prompts → lite_kits-0.3.1/src/lite_kits/kits/dev/commands/.github}/stats.prompt.md +163 -163
  31. lite_kits-0.3.1/src/lite_kits/kits/kits.yaml +497 -0
  32. {lite_kits-0.1.1 → lite_kits-0.3.1}/src/lite_kits/kits/multiagent/README.md +6 -6
  33. {lite_kits-0.1.1/src/lite_kits/kits/multiagent/claude/commands → lite_kits-0.3.1/src/lite_kits/kits/multiagent/commands/.claude}/sync.md +331 -331
  34. {lite_kits-0.1.1/src/lite_kits/kits/multiagent/github/prompts → lite_kits-0.3.1/src/lite_kits/kits/multiagent/commands/.github}/sync.prompt.md +73 -69
  35. {lite_kits-0.1.1 → lite_kits-0.3.1}/src/lite_kits/kits/multiagent/memory/git-worktrees-protocol.md +370 -370
  36. {lite_kits-0.1.1 → lite_kits-0.3.1}/src/lite_kits/kits/multiagent/memory/parallel-work-protocol.md +536 -536
  37. {lite_kits-0.1.1 → lite_kits-0.3.1}/src/lite_kits/kits/multiagent/memory/pr-workflow-guide.md +275 -275
  38. {lite_kits-0.1.1 → lite_kits-0.3.1}/src/lite_kits/kits/multiagent/templates/collaboration-structure/README.md +166 -166
  39. {lite_kits-0.1.1 → lite_kits-0.3.1}/src/lite_kits/kits/multiagent/templates/decision.md +79 -79
  40. {lite_kits-0.1.1 → lite_kits-0.3.1}/src/lite_kits/kits/multiagent/templates/handoff.md +95 -95
  41. {lite_kits-0.1.1 → lite_kits-0.3.1}/src/lite_kits/kits/multiagent/templates/session-log.md +68 -68
  42. lite_kits-0.1.1/.gitignore +0 -40
  43. lite_kits-0.1.1/PKG-INFO +0 -447
  44. lite_kits-0.1.1/README.md +0 -418
  45. lite_kits-0.1.1/src/lite_kits/__init__.py +0 -9
  46. lite_kits-0.1.1/src/lite_kits/cli.py +0 -496
  47. lite_kits-0.1.1/src/lite_kits/core/installer.py +0 -437
  48. lite_kits-0.1.1/src/lite_kits/kits/dev/claude/commands/commit.md +0 -612
  49. lite_kits-0.1.1/src/lite_kits/kits/dev/claude/commands/orient.md +0 -146
  50. lite_kits-0.1.1/src/lite_kits/kits/dev/claude/commands/pr.md +0 -593
  51. lite_kits-0.1.1/src/lite_kits/kits/dev/claude/commands/review.md +0 -202
  52. lite_kits-0.1.1/src/lite_kits/kits/dev/claude/commands/stats.md +0 -162
  53. lite_kits-0.1.1/src/lite_kits/kits/dev/github/prompts/audit.prompt.md +0 -143
  54. lite_kits-0.1.1/src/lite_kits/kits/dev/github/prompts/cleanup.prompt.md +0 -382
  55. lite_kits-0.1.1/src/lite_kits/kits/dev/github/prompts/commit.prompt.md +0 -591
  56. lite_kits-0.1.1/src/lite_kits/kits/dev/github/prompts/review.prompt.md +0 -202
  57. lite_kits-0.1.1/src/lite_kits/kits/git/README.md +0 -365
  58. lite_kits-0.1.1/src/lite_kits/kits/git/claude/commands/cleanup.md +0 -361
  59. lite_kits-0.1.1/src/lite_kits/kits/git/github/prompts/pr.prompt.md +0 -603
  60. lite_kits-0.1.1/src/lite_kits/kits/git/scripts/bash/get-git-context.sh +0 -208
  61. lite_kits-0.1.1/src/lite_kits/kits/git/scripts/powershell/Get-GitContext.ps1 +0 -242
  62. lite_kits-0.1.1/src/lite_kits/kits/kits.yaml +0 -180
  63. lite_kits-0.1.1/src/lite_kits/kits/project/README.md +0 -228
  64. lite_kits-0.1.1/src/lite_kits/kits/project/claude/commands/audit.md +0 -143
  65. lite_kits-0.1.1/src/lite_kits/kits/project/claude/commands/review.md +0 -112
  66. lite_kits-0.1.1/src/lite_kits/kits/project/github/prompts/orient.prompt.md +0 -150
  67. lite_kits-0.1.1/src/lite_kits/kits/project/github/prompts/review.prompt.md +0 -112
  68. lite_kits-0.1.1/src/lite_kits/kits/project/github/prompts/stats.prompt.md +0 -163
@@ -0,0 +1,48 @@
1
+ # Local agent settings (root only - don't ignore src/lite_kits/kits/*/.claude etc.)
2
+ /.github/*
3
+ !/.github/workflows/
4
+ /.claude
5
+ /.specify
6
+ /specs
7
+
8
+ # Python
9
+ __pycache__/
10
+ *.py[cod]
11
+ *$py.class
12
+ *.so
13
+ .Python
14
+ build/
15
+ develop-eggs/
16
+ dist/
17
+ downloads/
18
+ eggs/
19
+ .eggs/
20
+ lib/
21
+ lib64/
22
+ parts/
23
+ sdist/
24
+ var/
25
+ wheels/
26
+ *.egg-info/
27
+ .installed.cfg
28
+ *.egg
29
+
30
+ # Virtual environments
31
+ venv/
32
+ ENV/
33
+ env/
34
+
35
+ # IDE
36
+ .vscode/
37
+ .idea/
38
+ *.swp
39
+ *.swo
40
+ *~
41
+
42
+ # OS
43
+ .DS_Store
44
+ Thumbs.db
45
+
46
+ # Temp example files
47
+ examples/minimal-todo-app/*
48
+ !examples/minimal-todo-app/README.md
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 spec-kit-multiagent contributors
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Trenton Morgan
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,259 @@
1
+ Metadata-Version: 2.4
2
+ Name: lite-kits
3
+ Version: 0.3.1
4
+ Summary: Lightweight enhancement kits for vanilla dev tools (spec-kit, etc.)
5
+ Project-URL: Homepage, https://github.com/tmorgan181/lite-kits
6
+ Project-URL: Documentation, https://github.com/tmorgan181/lite-kits#readme
7
+ Project-URL: Repository, https://github.com/tmorgan181/lite-kits
8
+ Project-URL: Issues, https://github.com/tmorgan181/lite-kits/issues
9
+ Author: lite-kits contributors
10
+ License: MIT
11
+ License-File: LICENSE
12
+ Keywords: ai,development-workflow,enhancement,git,kits,spec-kit
13
+ Classifier: Development Status :: 4 - Beta
14
+ Classifier: Intended Audience :: Developers
15
+ Classifier: License :: OSI Approved :: MIT License
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Programming Language :: Python :: 3.12
19
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
20
+ Requires-Python: >=3.11
21
+ Requires-Dist: pyyaml>=6.0.0
22
+ Requires-Dist: rich>=13.0.0
23
+ Requires-Dist: typer>=0.9.0
24
+ Provides-Extra: dev
25
+ Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
26
+ Requires-Dist: pytest>=7.0.0; extra == 'dev'
27
+ Requires-Dist: ruff>=0.1.0; extra == 'dev'
28
+ Description-Content-Type: text/markdown
29
+
30
+ # 🌈 LITE-KITS 🎒
31
+
32
+ [![Version](https://img.shields.io/badge/version-0.3.0-blue.svg)](https://github.com/tmorgan181/lite-kits/releases/tag/v0.3.0)
33
+ [![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
34
+ [![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
35
+ [![Spec-Kit](https://img.shields.io/badge/spec--kit-compatible-purple.svg)](https://github.com/github/spec-kit)
36
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
37
+
38
+ **Lightweight enhancement kits for spec-driven development.**
39
+
40
+ <img width="750" height="450" alt="lite-kits banner in terminal" src="assets/banner.gif" />
41
+
42
+ ## What is this?
43
+
44
+ **lite-kits** adds productivity-enhancing slash commands to [spec-kit](https://github.com/github/spec-kit) projects. Get smart git workflows (`/commit`, `/pr`, `/cleanup`), project orientation (`/orient`), code quality tools (`/review`, `/audit`, `/stats`), and optional multi-agent coordination.
45
+
46
+ It's an **add-on**, not a fork—your vanilla spec-kit stays vanilla, and you benefit from upstream updates automatically.
47
+
48
+ ## Quick Start
49
+
50
+ ### 1. Install lite-kits
51
+
52
+ ```bash
53
+ # Recommended: Install with uv
54
+ uv tool install lite-kits
55
+
56
+ # Or with pip
57
+ pip install lite-kits
58
+ ```
59
+
60
+ ### 2. Add kits to your spec-kit project
61
+
62
+ ```bash
63
+ cd your-spec-kit-project
64
+
65
+ # Add dev-kit (all solo development commands)
66
+ lite-kits add
67
+
68
+ # Check what was installed
69
+ lite-kits status
70
+ ```
71
+
72
+ ### 3. Use the commands
73
+
74
+ ```bash
75
+ # In Claude Code or GitHub Copilot
76
+ /orient # Get project context
77
+ /commit # Smart commit with staging
78
+ /pr # Create PR with auto-push
79
+ /review # Review staged changes
80
+ /cleanup # Clean up merged branches
81
+ /audit # Security analysis
82
+ /stats # Project metrics
83
+ ```
84
+
85
+ That's it! See [GUIDE.md](docs/GUIDE.md) for detailed command documentation and examples.
86
+
87
+ ## Features
88
+
89
+ **Dev-Kit** (solo development):
90
+ - `/orient` - Quick project orientation for AI agents
91
+ - `/commit` - Smart commits with staging proposals and conventional commits
92
+ - `/pr` - Pull request creation with auto-push and smart descriptions
93
+ - `/review` - Code review against best practices
94
+ - `/cleanup` - Safe merged branch cleanup
95
+ - `/audit` - Security analysis on dependencies and code patterns
96
+ - `/stats` - Project metrics and complexity analysis
97
+
98
+ **Multiagent-Kit** (optional, for multi-agent workflows):
99
+ - `/sync` - Multi-agent coordination status
100
+ - Collaboration directories and templates
101
+ - Memory guides (PR workflow, git worktrees protocol)
102
+
103
+ **CLI Features:**
104
+ - Beautiful terminal output with proper spacing
105
+ - Preview-first (see changes before applying)
106
+ - Smart auto-detection (agents and shells)
107
+ - File count summaries
108
+ - `help` command: `lite-kits help [COMMAND]`
109
+ - `--force` flag to skip confirmations
110
+
111
+ ## Installation
112
+
113
+ ### Prerequisites
114
+
115
+ lite-kits enhances GitHub spec-kit projects. You'll need:
116
+
117
+ 1. **Python 3.11+** - [Download here](https://www.python.org/downloads/)
118
+ - Automatically checked by pip/uv during installation
119
+
120
+ 2. **Node.js & npm** - [Download here](https://nodejs.org/)
121
+ - Required to install spec-kit (spec-kit is a Node.js package)
122
+
123
+ 3. **spec-kit** - GitHub's spec-driven development framework (REQUIRED)
124
+ ```bash
125
+ npm install -g @github/spec-kit
126
+ ```
127
+ - lite-kits won't work without spec-kit initialized first
128
+ - Creates `.claude/` or `.github/prompts/` directories where commands are installed
129
+
130
+ ### Complete Installation Flow
131
+
132
+ ```bash
133
+ # 1. Install spec-kit (if not already installed)
134
+ npm install -g @github/spec-kit
135
+
136
+ # 2. Create a spec-kit project (or use existing)
137
+ specify init my-project
138
+ cd my-project
139
+
140
+ # 3. Install lite-kits
141
+ uv tool install lite-kits # Recommended: with uv
142
+ # OR
143
+ pip install lite-kits # Alternative: with pip
144
+
145
+ # 4. Add enhancement kits to your project
146
+ lite-kits add # Adds dev-kit (all commands)
147
+
148
+ # 5. Start using commands in your AI assistant
149
+ /orient # Get project context
150
+ /commit # Smart commit workflow
151
+ ```
152
+
153
+ ### Alternative Install Methods
154
+
155
+ **With pip:**
156
+ ```bash
157
+ pip install lite-kits
158
+ ```
159
+
160
+ **From source:**
161
+ ```bash
162
+ git clone https://github.com/tmorgan181/lite-kits.git
163
+ cd lite-kits
164
+ uv build
165
+ uv tool install dist/lite_kits-*.whl
166
+ ```
167
+
168
+ ### AI Assistant Compatibility
169
+
170
+ lite-kits commands work with any AI assistant that supports slash commands:
171
+ - ✅ **GitHub Copilot** (VSCode extension or CLI) - Native GitHub integration
172
+ - ✅ **Claude Code** (VSCode extension)
173
+ - ✅ Any assistant that reads `.md` prompt files
174
+
175
+ No additional configuration required—commands are just markdown files that your AI assistant reads.
176
+
177
+ ## CLI Commands
178
+
179
+ ```bash
180
+ # Kit management
181
+ lite-kits add # Add dev-kit
182
+ lite-kits add --kit dev # Add specific kit
183
+ lite-kits add --kit multiagent # Add multiagent-kit
184
+ lite-kits remove --all # Remove all kits
185
+ lite-kits remove --kit dev --force # Remove without confirmation
186
+
187
+ # Status and info
188
+ lite-kits status # Show installed kits
189
+ lite-kits validate # Verify installation
190
+ lite-kits info # Package information
191
+ lite-kits help [COMMAND] # Show help
192
+
193
+ # Global options
194
+ lite-kits --version / -V # Show version
195
+ lite-kits --banner # Show animated banner
196
+ lite-kits --quiet / -q # Suppress output
197
+ lite-kits --verbose / -v # Extra output
198
+ ```
199
+
200
+ See [GUIDE.md](docs/GUIDE.md) for detailed documentation and examples.
201
+
202
+ ## What's New in v0.2.0
203
+
204
+ **Major rewrite with focus on modularity and UX:**
205
+
206
+ - ✨ Manifest-driven architecture (zero hardcoded logic)
207
+ - 🔧 Modular installer (detector, validator, conflict_checker)
208
+ - 📦 Kit consolidation: project-kit + git-kit → **dev-kit**
209
+ - 🎨 Perfect terminal spacing and file count summaries
210
+ - 💬 `help` command with optional command argument
211
+ - ⚡ `--force` flag for remove command
212
+ - 🐛 Fixed all critical bugs (#1, #3, #4, #6, #7)
213
+
214
+ See [CHANGELOG.md](CHANGELOG.md) for full release notes.
215
+
216
+ ## Documentation
217
+
218
+ - **[GUIDE.md](docs/GUIDE.md)** - Complete command reference, workflows, and examples
219
+ - **[CHANGELOG.md](CHANGELOG.md)** - Version history and migration notes
220
+ - **[CONTRIBUTING.md](CONTRIBUTING.md)** - How to contribute
221
+ - **[manifest-schema.md](docs/manifest-schema.md)** - Technical reference for kits.yaml
222
+
223
+ ## Architecture
224
+
225
+ **Enhance, don't replace:**
226
+ - lite-kits is an add-on for vanilla spec-kit (not a fork)
227
+ - Only adds files, never modifies spec-kit core
228
+ - Get upstream spec-kit updates automatically
229
+ - Modular kits (add/remove as needed)
230
+
231
+ **Content-first structure:**
232
+ - `kits/{kit-name}/commands/{command}.{agent}.md`
233
+ - Easy to add new commands, agents, and shells
234
+ - Single manifest (kits.yaml) as source of truth
235
+
236
+ **Modular installer:**
237
+ - Auto-detect agents (Claude, Copilot) and shells (Bash, PowerShell)
238
+ - Preview-first operations with conflict checking
239
+ - Clean separation of concerns across focused modules
240
+
241
+ ## Support & Contributing
242
+
243
+ - **Issues**: [GitHub Issues](https://github.com/tmorgan181/lite-kits/issues)
244
+ - **Discussions**: [GitHub Discussions](https://github.com/tmorgan181/lite-kits/discussions)
245
+ - **Contributing**: See [CONTRIBUTING.md](CONTRIBUTING.md)
246
+
247
+ ## License
248
+
249
+ MIT License - see [LICENSE](LICENSE) for details.
250
+
251
+ ## Acknowledgments
252
+
253
+ Built to enhance [GitHub Spec-Kit](https://github.com/github/spec-kit), a framework for spec-driven development with AI agents.
254
+
255
+ ---
256
+
257
+ **Status**: Beta (v0.3.0) - Ready for production use
258
+
259
+ **Philosophy**: Enhance, don't replace. lite-kits adds features to vanilla spec-kit without forking or modifying core files.
@@ -0,0 +1,230 @@
1
+ # 🌈 LITE-KITS 🎒
2
+
3
+ [![Version](https://img.shields.io/badge/version-0.3.0-blue.svg)](https://github.com/tmorgan181/lite-kits/releases/tag/v0.3.0)
4
+ [![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
5
+ [![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
6
+ [![Spec-Kit](https://img.shields.io/badge/spec--kit-compatible-purple.svg)](https://github.com/github/spec-kit)
7
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
8
+
9
+ **Lightweight enhancement kits for spec-driven development.**
10
+
11
+ <img width="750" height="450" alt="lite-kits banner in terminal" src="assets/banner.gif" />
12
+
13
+ ## What is this?
14
+
15
+ **lite-kits** adds productivity-enhancing slash commands to [spec-kit](https://github.com/github/spec-kit) projects. Get smart git workflows (`/commit`, `/pr`, `/cleanup`), project orientation (`/orient`), code quality tools (`/review`, `/audit`, `/stats`), and optional multi-agent coordination.
16
+
17
+ It's an **add-on**, not a fork—your vanilla spec-kit stays vanilla, and you benefit from upstream updates automatically.
18
+
19
+ ## Quick Start
20
+
21
+ ### 1. Install lite-kits
22
+
23
+ ```bash
24
+ # Recommended: Install with uv
25
+ uv tool install lite-kits
26
+
27
+ # Or with pip
28
+ pip install lite-kits
29
+ ```
30
+
31
+ ### 2. Add kits to your spec-kit project
32
+
33
+ ```bash
34
+ cd your-spec-kit-project
35
+
36
+ # Add dev-kit (all solo development commands)
37
+ lite-kits add
38
+
39
+ # Check what was installed
40
+ lite-kits status
41
+ ```
42
+
43
+ ### 3. Use the commands
44
+
45
+ ```bash
46
+ # In Claude Code or GitHub Copilot
47
+ /orient # Get project context
48
+ /commit # Smart commit with staging
49
+ /pr # Create PR with auto-push
50
+ /review # Review staged changes
51
+ /cleanup # Clean up merged branches
52
+ /audit # Security analysis
53
+ /stats # Project metrics
54
+ ```
55
+
56
+ That's it! See [GUIDE.md](docs/GUIDE.md) for detailed command documentation and examples.
57
+
58
+ ## Features
59
+
60
+ **Dev-Kit** (solo development):
61
+ - `/orient` - Quick project orientation for AI agents
62
+ - `/commit` - Smart commits with staging proposals and conventional commits
63
+ - `/pr` - Pull request creation with auto-push and smart descriptions
64
+ - `/review` - Code review against best practices
65
+ - `/cleanup` - Safe merged branch cleanup
66
+ - `/audit` - Security analysis on dependencies and code patterns
67
+ - `/stats` - Project metrics and complexity analysis
68
+
69
+ **Multiagent-Kit** (optional, for multi-agent workflows):
70
+ - `/sync` - Multi-agent coordination status
71
+ - Collaboration directories and templates
72
+ - Memory guides (PR workflow, git worktrees protocol)
73
+
74
+ **CLI Features:**
75
+ - Beautiful terminal output with proper spacing
76
+ - Preview-first (see changes before applying)
77
+ - Smart auto-detection (agents and shells)
78
+ - File count summaries
79
+ - `help` command: `lite-kits help [COMMAND]`
80
+ - `--force` flag to skip confirmations
81
+
82
+ ## Installation
83
+
84
+ ### Prerequisites
85
+
86
+ lite-kits enhances GitHub spec-kit projects. You'll need:
87
+
88
+ 1. **Python 3.11+** - [Download here](https://www.python.org/downloads/)
89
+ - Automatically checked by pip/uv during installation
90
+
91
+ 2. **Node.js & npm** - [Download here](https://nodejs.org/)
92
+ - Required to install spec-kit (spec-kit is a Node.js package)
93
+
94
+ 3. **spec-kit** - GitHub's spec-driven development framework (REQUIRED)
95
+ ```bash
96
+ npm install -g @github/spec-kit
97
+ ```
98
+ - lite-kits won't work without spec-kit initialized first
99
+ - Creates `.claude/` or `.github/prompts/` directories where commands are installed
100
+
101
+ ### Complete Installation Flow
102
+
103
+ ```bash
104
+ # 1. Install spec-kit (if not already installed)
105
+ npm install -g @github/spec-kit
106
+
107
+ # 2. Create a spec-kit project (or use existing)
108
+ specify init my-project
109
+ cd my-project
110
+
111
+ # 3. Install lite-kits
112
+ uv tool install lite-kits # Recommended: with uv
113
+ # OR
114
+ pip install lite-kits # Alternative: with pip
115
+
116
+ # 4. Add enhancement kits to your project
117
+ lite-kits add # Adds dev-kit (all commands)
118
+
119
+ # 5. Start using commands in your AI assistant
120
+ /orient # Get project context
121
+ /commit # Smart commit workflow
122
+ ```
123
+
124
+ ### Alternative Install Methods
125
+
126
+ **With pip:**
127
+ ```bash
128
+ pip install lite-kits
129
+ ```
130
+
131
+ **From source:**
132
+ ```bash
133
+ git clone https://github.com/tmorgan181/lite-kits.git
134
+ cd lite-kits
135
+ uv build
136
+ uv tool install dist/lite_kits-*.whl
137
+ ```
138
+
139
+ ### AI Assistant Compatibility
140
+
141
+ lite-kits commands work with any AI assistant that supports slash commands:
142
+ - ✅ **GitHub Copilot** (VSCode extension or CLI) - Native GitHub integration
143
+ - ✅ **Claude Code** (VSCode extension)
144
+ - ✅ Any assistant that reads `.md` prompt files
145
+
146
+ No additional configuration required—commands are just markdown files that your AI assistant reads.
147
+
148
+ ## CLI Commands
149
+
150
+ ```bash
151
+ # Kit management
152
+ lite-kits add # Add dev-kit
153
+ lite-kits add --kit dev # Add specific kit
154
+ lite-kits add --kit multiagent # Add multiagent-kit
155
+ lite-kits remove --all # Remove all kits
156
+ lite-kits remove --kit dev --force # Remove without confirmation
157
+
158
+ # Status and info
159
+ lite-kits status # Show installed kits
160
+ lite-kits validate # Verify installation
161
+ lite-kits info # Package information
162
+ lite-kits help [COMMAND] # Show help
163
+
164
+ # Global options
165
+ lite-kits --version / -V # Show version
166
+ lite-kits --banner # Show animated banner
167
+ lite-kits --quiet / -q # Suppress output
168
+ lite-kits --verbose / -v # Extra output
169
+ ```
170
+
171
+ See [GUIDE.md](docs/GUIDE.md) for detailed documentation and examples.
172
+
173
+ ## What's New in v0.2.0
174
+
175
+ **Major rewrite with focus on modularity and UX:**
176
+
177
+ - ✨ Manifest-driven architecture (zero hardcoded logic)
178
+ - 🔧 Modular installer (detector, validator, conflict_checker)
179
+ - 📦 Kit consolidation: project-kit + git-kit → **dev-kit**
180
+ - 🎨 Perfect terminal spacing and file count summaries
181
+ - 💬 `help` command with optional command argument
182
+ - ⚡ `--force` flag for remove command
183
+ - 🐛 Fixed all critical bugs (#1, #3, #4, #6, #7)
184
+
185
+ See [CHANGELOG.md](CHANGELOG.md) for full release notes.
186
+
187
+ ## Documentation
188
+
189
+ - **[GUIDE.md](docs/GUIDE.md)** - Complete command reference, workflows, and examples
190
+ - **[CHANGELOG.md](CHANGELOG.md)** - Version history and migration notes
191
+ - **[CONTRIBUTING.md](CONTRIBUTING.md)** - How to contribute
192
+ - **[manifest-schema.md](docs/manifest-schema.md)** - Technical reference for kits.yaml
193
+
194
+ ## Architecture
195
+
196
+ **Enhance, don't replace:**
197
+ - lite-kits is an add-on for vanilla spec-kit (not a fork)
198
+ - Only adds files, never modifies spec-kit core
199
+ - Get upstream spec-kit updates automatically
200
+ - Modular kits (add/remove as needed)
201
+
202
+ **Content-first structure:**
203
+ - `kits/{kit-name}/commands/{command}.{agent}.md`
204
+ - Easy to add new commands, agents, and shells
205
+ - Single manifest (kits.yaml) as source of truth
206
+
207
+ **Modular installer:**
208
+ - Auto-detect agents (Claude, Copilot) and shells (Bash, PowerShell)
209
+ - Preview-first operations with conflict checking
210
+ - Clean separation of concerns across focused modules
211
+
212
+ ## Support & Contributing
213
+
214
+ - **Issues**: [GitHub Issues](https://github.com/tmorgan181/lite-kits/issues)
215
+ - **Discussions**: [GitHub Discussions](https://github.com/tmorgan181/lite-kits/discussions)
216
+ - **Contributing**: See [CONTRIBUTING.md](CONTRIBUTING.md)
217
+
218
+ ## License
219
+
220
+ MIT License - see [LICENSE](LICENSE) for details.
221
+
222
+ ## Acknowledgments
223
+
224
+ Built to enhance [GitHub Spec-Kit](https://github.com/github/spec-kit), a framework for spec-driven development with AI agents.
225
+
226
+ ---
227
+
228
+ **Status**: Beta (v0.3.0) - Ready for production use
229
+
230
+ **Philosophy**: Enhance, don't replace. lite-kits adds features to vanilla spec-kit without forking or modifying core files.
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "lite-kits"
7
- version = "0.1.1"
7
+ version = "0.3.1"
8
8
  description = "Lightweight enhancement kits for vanilla dev tools (spec-kit, etc.)"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.11"
@@ -14,7 +14,7 @@ authors = [
14
14
  ]
15
15
  keywords = ["spec-kit", "enhancement", "kits", "ai", "development-workflow", "git"]
16
16
  classifiers = [
17
- "Development Status :: 3 - Alpha",
17
+ "Development Status :: 4 - Beta",
18
18
  "Intended Audience :: Developers",
19
19
  "License :: OSI Approved :: MIT License",
20
20
  "Programming Language :: Python :: 3",
@@ -0,0 +1,61 @@
1
+ """
2
+ lite-kits: Lightweight enhancement kits for spec-driven development
3
+
4
+ This package adds productivity-enhancing slash commands to vanilla spec-kit projects
5
+ without forking or replacing any core files.
6
+ """
7
+
8
+ # Version
9
+ __version__ = "0.3.1"
10
+
11
+ # Package metadata
12
+ APP_NAME = "lite-kits"
13
+ APP_DESCRIPTION = "Quick start: lite-kits add • Get help: lite-kits help [COMMAND]"
14
+ REPOSITORY_URL = "https://github.com/tmorgan181/lite-kits"
15
+ LICENSE = "MIT"
16
+
17
+ # Kit identifiers
18
+ KIT_DEV = "dev"
19
+ KIT_MULTIAGENT = "multiagent"
20
+ KITS_ALL = [KIT_DEV, KIT_MULTIAGENT]
21
+
22
+ # Kit descriptions
23
+ KIT_DESC_DEV = "Solo development essentials: /orient, /commit, /pr, /review, /cleanup, /audit, /stats"
24
+ KIT_DESC_MULTIAGENT = "Multi-agent coordination: /sync, collaboration dirs, memory guides (EXPERIMENTAL)"
25
+
26
+ # Directory paths
27
+ DIR_CLAUDE_COMMANDS = r".claude\commands"
28
+ DIR_GITHUB_PROMPTS = r".github\prompts"
29
+ DIR_SPECIFY_MEMORY = r".specify\memory"
30
+ DIR_SPECIFY_SCRIPTS_BASH = r".specify\scripts\bash"
31
+ DIR_SPECIFY_SCRIPTS_POWERSHELL = r".specify\scripts\powershell"
32
+ DIR_SPECIFY_TEMPLATES = r".specify\templates"
33
+
34
+ # Spec-kit detection paths
35
+ SPEC_KIT_DIRS = [r".specify", r".claude", r".github\prompts"]
36
+
37
+ # Error messages
38
+ ERROR_NOT_SPEC_KIT = "does not appear to be a spec-kit project!"
39
+ ERROR_SPEC_KIT_HINT = r"Looking for one of: .specify\, .claude\, or .github\prompts"
40
+
41
+ __all__ = [
42
+ "__version__",
43
+ "APP_NAME",
44
+ "APP_DESCRIPTION",
45
+ "REPOSITORY_URL",
46
+ "LICENSE",
47
+ "KIT_DEV",
48
+ "KIT_MULTIAGENT",
49
+ "KITS_ALL",
50
+ "KIT_DESC_DEV",
51
+ "KIT_DESC_MULTIAGENT",
52
+ "DIR_CLAUDE_COMMANDS",
53
+ "DIR_GITHUB_PROMPTS",
54
+ "DIR_SPECIFY_MEMORY",
55
+ "DIR_SPECIFY_SCRIPTS_BASH",
56
+ "DIR_SPECIFY_SCRIPTS_POWERSHELL",
57
+ "DIR_SPECIFY_TEMPLATES",
58
+ "SPEC_KIT_DIRS",
59
+ "ERROR_NOT_SPEC_KIT",
60
+ "ERROR_SPEC_KIT_HINT",
61
+ ]