lite-kits 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

lite_kits/kits/git/claude/commands/review.md

@@ -0,0 +1,202 @@
+---
+description: Review staged changes against best practices
+---
+
+# Code Review of Staged Changes
+
+**Purpose**: Review staged git changes for quality, best practices, and potential issues before committing.
+
+## Execution Steps
+
+Execute the following steps to review staged changes:
+
+### 1. Check Staged Files
+
+```bash
+# Get list of staged files with status
+git diff --staged --name-status
+```
+
+**If no files are staged**:
+- Inform user that nothing is staged
+- Suggest running `git add` or `/commit` to stage and commit together
+- Exit gracefully
+
+### 2. Analyze Staged Changes
+
+```bash
+# Get the actual diff with context
+git diff --staged
+```
+
+### 3. Review Changes
+
+Analyze the diff output for:
+
+**✅ Good Practices to Acknowledge**:
+- Clear, descriptive function/variable names
+- Appropriate comments where needed
+- Consistent formatting
+- Type hints (Python) or type annotations
+- Test coverage for new code
+- Error handling
+- Input validation
+
+**⚠️ Issues to Flag**:
+- **Security**:
+  - Hardcoded credentials or API keys
+  - SQL injection vulnerabilities
+  - XSS vulnerabilities
+  - Unsafe deserialization
+  - Missing authentication/authorization checks
+  
+- **Code Quality**:
+  - TODOs or FIXMEs (should be tracked in issues)
+  - Commented-out code blocks
+  - Magic numbers without explanation
+  - Overly complex functions (>50 lines)
+  - Duplicate code patterns
+  - Inconsistent naming conventions
+  
+- **Best Practices**:
+  - Missing error handling
+  - No logging for important operations
+  - Hardcoded configuration values
+  - Missing input validation
+  - Unused imports or variables
+  - Missing docstrings for public APIs
+
+### 4. Present Review Results
+
+Format output as follows:
+
+```
+## Code Review Results
+
+**Staged files**: [count]
+[list files with status: A=added, M=modified, D=deleted]
+
+**Summary of changes**:
+[brief description of what's being changed]
+
+===========================================================
+**✅ Good Practices Found:**
+===========================================================
+
+[List positive findings, grouped by file]
+- [file]: [specific good practice observed]
+
+===========================================================
+**⚠️ Suggestions for Improvement:**
+===========================================================
+
+[List issues/suggestions, grouped by file with line numbers if possible]
+- [file]:[line]: [specific issue and suggested fix]
+
+===========================================================
+**🔒 Security Check:**
+===========================================================
+
+[Report any security concerns or confirm none found]
+- ✓ No hardcoded credentials detected
+- ✓ No obvious security vulnerabilities
+- ⚠ [Any security concerns]
+
+===========================================================
+**📊 Overall Assessment:**
+===========================================================
+
+[One of: "Ready to commit", "Ready with minor suggestions", "Needs changes"]
+
+[Brief summary of overall code quality]
+
+**Recommendation**: [Approve / Address suggestions / Do not commit]
+```
+
+### 5. Handle User Response
+
+After presenting results, wait for user action. They may:
+- Proceed with commit anyway
+- Make changes and re-review
+- Cancel the review
+
+## Example Output
+
+```
+## Code Review Results
+
+**Staged files**: 3
+- A  src/auth.py (new file)
+- M  src/models.py (modified)
+- A  tests/test_auth.py (new file)
+
+**Summary of changes**:
+Adding user authentication system with bcrypt password hashing
+and JWT token generation.
+
+===========================================================
+**✅ Good Practices Found:**
+===========================================================
+
+- src/auth.py: Clear function names (hash_password, verify_password)
+- src/auth.py: Type hints used throughout
+- src/auth.py: Comprehensive docstrings for all functions
+- src/models.py: Proper SQLAlchemy relationship definitions
+- tests/test_auth.py: Good test coverage with fixtures
+
+===========================================================
+**⚠️ Suggestions for Improvement:**
+===========================================================
+
+- src/auth.py:45: Consider extracting hash_password to utils module
+  Current: Function in auth.py
+  Suggest: Move to src/utils/crypto.py for reusability
+
+- src/models.py:12: TODO comment present
+  Line: "# TODO: Add password reset functionality"
+  Suggest: Create GitHub issue and reference it in comment
+
+- tests/test_auth.py:67: Missing edge case test
+  Suggest: Add test for empty password input
+
+- src/auth.py:23: Magic number for token expiration
+  Current: expires_delta = timedelta(hours=24)
+  Suggest: Move to config file or environment variable
+
+===========================================================
+**🔒 Security Check:**
+===========================================================
+
+✓ No hardcoded credentials detected
+✓ Using bcrypt for password hashing (good choice!)
+✓ JWT tokens generated securely
+⚠ Consider adding rate limiting to prevent brute force attacks
+
+===========================================================
+**📊 Overall Assessment:**
+===========================================================
+
+**Status**: Ready with minor suggestions
+
+The code follows good practices with proper type hints, docstrings,
+and test coverage. The suggestions above are minor improvements that
+can be addressed now or in future iterations.
+
+**Recommendation**: Approve and commit - suggestions are non-blocking
+```
+
+## Important Notes
+
+- This command is **read-only** - it never modifies files
+- Focus on **actionable feedback** - be specific about what to change
+- Be **encouraging** - acknowledge good practices
+- **Security first** - always check for security issues
+- Keep review **concise** - don't overwhelm with minor issues
+- **Respect the agent's work** - balance critique with acknowledgment
+
+## Integration with Other Commands
+
+- Run `/review` before `/commit` to catch issues early
+- Use after making changes and staging them with `git add`
+- Combine with `/pr` workflow - review before creating PR
+- Works great in multi-agent workflows (one agent reviews another's work)

lite_kits/kits/git/github/prompts/review.prompt.md

@@ -0,0 +1,202 @@
+---
+description: Review staged changes against best practices
+---
+
+# Code Review of Staged Changes
+
+**Purpose**: Review staged git changes for quality, best practices, and potential issues before committing.
+
+## Execution Steps
+
+Execute the following steps to review staged changes:
+
+### 1. Check Staged Files
+
+```bash
+# Get list of staged files with status
+git diff --staged --name-status
+```
+
+**If no files are staged**:
+- Inform user that nothing is staged
+- Suggest running `git add` or `@terminal /commit` to stage and commit together
+- Exit gracefully
+
+### 2. Analyze Staged Changes
+
+```bash
+# Get the actual diff with context
+git diff --staged
+```
+
+### 3. Review Changes
+
+Analyze the diff output for:
+
+**✅ Good Practices to Acknowledge**:
+- Clear, descriptive function/variable names
+- Appropriate comments where needed
+- Consistent formatting
+- Type hints (Python) or type annotations
+- Test coverage for new code
+- Error handling
+- Input validation
+
+**⚠️ Issues to Flag**:
+- **Security**:
+  - Hardcoded credentials or API keys
+  - SQL injection vulnerabilities
+  - XSS vulnerabilities
+  - Unsafe deserialization
+  - Missing authentication/authorization checks
+  
+- **Code Quality**:
+  - TODOs or FIXMEs (should be tracked in issues)
+  - Commented-out code blocks
+  - Magic numbers without explanation
+  - Overly complex functions (>50 lines)
+  - Duplicate code patterns
+  - Inconsistent naming conventions
+  
+- **Best Practices**:
+  - Missing error handling
+  - No logging for important operations
+  - Hardcoded configuration values
+  - Missing input validation
+  - Unused imports or variables
+  - Missing docstrings for public APIs
+
+### 4. Present Review Results
+
+Format output as follows:
+
+```
+## Code Review Results
+
+**Staged files**: [count]
+[list files with status: A=added, M=modified, D=deleted]
+
+**Summary of changes**:
+[brief description of what's being changed]
+
+===========================================================
+**✅ Good Practices Found:**
+===========================================================
+
+[List positive findings, grouped by file]
+- [file]: [specific good practice observed]
+
+===========================================================
+**⚠️ Suggestions for Improvement:**
+===========================================================
+
+[List issues/suggestions, grouped by file with line numbers if possible]
+- [file]:[line]: [specific issue and suggested fix]
+
+===========================================================
+**🔒 Security Check:**
+===========================================================
+
+[Report any security concerns or confirm none found]
+- ✓ No hardcoded credentials detected
+- ✓ No obvious security vulnerabilities
+- ⚠ [Any security concerns]
+
+===========================================================
+**📊 Overall Assessment:**
+===========================================================
+
+[One of: "Ready to commit", "Ready with minor suggestions", "Needs changes"]
+
+[Brief summary of overall code quality]
+
+**Recommendation**: [Approve / Address suggestions / Do not commit]
+```
+
+### 5. Handle User Response
+
+After presenting results, wait for user action. They may:
+- Proceed with commit anyway
+- Make changes and re-review
+- Cancel the review
+
+## Example Output
+
+```
+## Code Review Results
+
+**Staged files**: 3
+- A  src/auth.py (new file)
+- M  src/models.py (modified)
+- A  tests/test_auth.py (new file)
+
+**Summary of changes**:
+Adding user authentication system with bcrypt password hashing
+and JWT token generation.
+
+===========================================================
+**✅ Good Practices Found:**
+===========================================================
+
+- src/auth.py: Clear function names (hash_password, verify_password)
+- src/auth.py: Type hints used throughout
+- src/auth.py: Comprehensive docstrings for all functions
+- src/models.py: Proper SQLAlchemy relationship definitions
+- tests/test_auth.py: Good test coverage with fixtures
+
+===========================================================
+**⚠️ Suggestions for Improvement:**
+===========================================================
+
+- src/auth.py:45: Consider extracting hash_password to utils module
+  Current: Function in auth.py
+  Suggest: Move to src/utils/crypto.py for reusability
+
+- src/models.py:12: TODO comment present
+  Line: "# TODO: Add password reset functionality"
+  Suggest: Create GitHub issue and reference it in comment
+
+- tests/test_auth.py:67: Missing edge case test
+  Suggest: Add test for empty password input
+
+- src/auth.py:23: Magic number for token expiration
+  Current: expires_delta = timedelta(hours=24)
+  Suggest: Move to config file or environment variable
+
+===========================================================
+**🔒 Security Check:**
+===========================================================
+
+✓ No hardcoded credentials detected
+✓ Using bcrypt for password hashing (good choice!)
+✓ JWT tokens generated securely
+⚠ Consider adding rate limiting to prevent brute force attacks
+
+===========================================================
+**📊 Overall Assessment:**
+===========================================================
+
+**Status**: Ready with minor suggestions
+
+The code follows good practices with proper type hints, docstrings,
+and test coverage. The suggestions above are minor improvements that
+can be addressed now or in future iterations.
+
+**Recommendation**: Approve and commit - suggestions are non-blocking
+```
+
+## Important Notes
+
+- This command is **read-only** - it never modifies files
+- Focus on **actionable feedback** - be specific about what to change
+- Be **encouraging** - acknowledge good practices
+- **Security first** - always check for security issues
+- Keep review **concise** - don't overwhelm with minor issues
+- **Respect the agent's work** - balance critique with acknowledgment
+
+## Integration with Other Commands
+
+- Run `@terminal /review` before `@terminal /commit` to catch issues early
+- Use after making changes and staging them with `git add`
+- Combine with `@terminal /pr` workflow - review before creating PR
+- Works great in multi-agent workflows (one agent reviews another's work)

lite_kits/kits/kits.yaml

@@ -0,0 +1,180 @@
+# Lite-Kits Manifest
+# Defines available kits, their commands, and generated files
+
+kits:
+  dev:
+    name: "Dev Kit"
+    description: "Solo development essentials: /orient, /commit, /pr, /review, /cleanup, /audit, /stats"
+    icon: "🚀"
+    recommended: true
+
+    commands:
+      - name: "orient"
+        description: "Agent orientation protocol"
+        status: "stable"
+
+      - name: "commit"
+        description: "Smart commit with staging and message generation"
+        status: "stable"
+
+      - name: "pr"
+        description: "Pull request creation with auto-push"
+        status: "stable"
+
+      - name: "review"
+        description: "Code review helper for staged changes"
+        status: "stable"
+
+      - name: "cleanup"
+        description: "Safe branch cleanup (delete merged branches)"
+        status: "stable"
+
+      - name: "audit"
+        description: "Security & quality audit"
+        status: "planned"
+
+      - name: "stats"
+        description: "Project statistics"
+        status: "planned"
+
+    # Files that get installed
+    files:
+      claude:
+        - path: ".claude/commands/orient.md"
+          source: "dev/claude/commands/orient.md"
+          required: true
+
+        - path: ".claude/commands/commit.md"
+          source: "dev/claude/commands/commit.md"
+          required: true
+
+        - path: ".claude/commands/pr.md"
+          source: "dev/claude/commands/pr.md"
+          required: true
+
+        - path: ".claude/commands/review.md"
+          source: "dev/claude/commands/review.md"
+          required: true
+
+        - path: ".claude/commands/cleanup.md"
+          source: "dev/claude/commands/cleanup.md"
+          required: true
+
+        - path: ".claude/commands/audit.md"
+          source: "dev/claude/commands/audit.md"
+          required: false
+
+        - path: ".claude/commands/stats.md"
+          source: "dev/claude/commands/stats.md"
+          required: false
+
+      copilot:
+        - path: ".github/prompts/orient.prompt.md"
+          source: "dev/github/prompts/orient.prompt.md"
+          required: true
+
+        - path: ".github/prompts/commit.prompt.md"
+          source: "dev/github/prompts/commit.prompt.md"
+          required: true
+
+        - path: ".github/prompts/pr.prompt.md"
+          source: "dev/github/prompts/pr.prompt.md"
+          required: true
+
+        - path: ".github/prompts/review.prompt.md"
+          source: "dev/github/prompts/review.prompt.md"
+          required: true
+
+        - path: ".github/prompts/cleanup.prompt.md"
+          source: "dev/github/prompts/cleanup.prompt.md"
+          required: true
+
+        - path: ".github/prompts/audit.prompt.md"
+          source: "dev/github/prompts/audit.prompt.md"
+          required: false
+
+        - path: ".github/prompts/stats.prompt.md"
+          source: "dev/github/prompts/stats.prompt.md"
+          required: false
+
+    # Marker files for detection (if any of these exist, kit is installed)
+    markers:
+      - ".claude/commands/orient.md"
+      - ".github/prompts/orient.prompt.md"
+
+  multiagent:
+    name: "Multiagent Kit"
+    description: "Multi-agent coordination: /sync, collaboration dirs, memory guides"
+    icon: "🤝"
+    recommended: false
+
+    commands:
+      - name: "sync"
+        description: "Multi-agent coordination status"
+        status: "stable"
+
+    files:
+      claude:
+        - path: ".claude/commands/sync.md"
+          source: "multiagent/claude/commands/sync.md"
+          required: true
+
+      copilot:
+        - path: ".github/prompts/sync.prompt.md"
+          source: "multiagent/github/prompts/sync.prompt.md"
+          required: true
+
+      memory:
+        - path: ".specify/memory/pr-workflow-guide.md"
+          source: "multiagent/memory/pr-workflow-guide.md"
+          required: true
+
+        - path: ".specify/memory/git-worktrees-protocol.md"
+          source: "multiagent/memory/git-worktrees-protocol.md"
+          required: true
+
+        - path: ".specify/memory/parallel-work-protocol.md"
+          source: "multiagent/memory/parallel-work-protocol.md"
+          required: true
+
+      templates:
+        - path: ".specify/templates/session-log.md"
+          source: "multiagent/templates/session-log.md"
+          required: true
+
+        - path: ".specify/templates/handoff.md"
+          source: "multiagent/templates/handoff.md"
+          required: true
+
+        - path: ".specify/templates/decision.md"
+          source: "multiagent/templates/decision.md"
+          required: true
+
+        - path: ".specify/templates/collaboration-README.md"
+          source: "multiagent/templates/collaboration-structure/README.md"
+          required: true
+
+    markers:
+      - ".specify/memory/pr-workflow-guide.md"
+      - ".claude/commands/sync.md"
+      - ".github/prompts/sync.prompt.md"
+
+# Agent detection
+agents:
+  claude:
+    marker_dir: ".claude"
+    commands_dir: ".claude/commands"
+    file_extension: ".md"
+
+  copilot:
+    marker_dir: ".github/prompts"
+    commands_dir: ".github/prompts"
+    file_extension: ".prompt.md"
+
+# Installation options
+options:
+  default_kit: "dev"
+  recommended_kits: ["dev"]
+  allow_partial_install: true  # Can install for just one agent
+  skip_existing: true          # Don't overwrite existing files by default
+  validate_on_install: true    # Run validation after install

lite_kits/kits/multiagent/README.md

@@ -6,6 +6,12 @@ Multi-agent coordination structure for projects with multiple AI agents working
 
 ## What It Adds
 
+### Commands
+
+| Command | Claude Code | GitHub Copilot | Description |
+|---------|-------------|----------------|-------------|
+| `/sync` | ✅ | ✅ | Show git sync status with worktree visualization |
+
 ### Memory Guides
 
 | Guide | Description | Status |
@@ -23,26 +29,23 @@ Multi-agent coordination structure for projects with multiple AI agents working
 
 ## Dependencies
 
-⚠️ **multiagent-kit requires**:
-- **project-kit**: For `/review` command and best practices
-- **git-kit**: For `/commit`, `/pr` commands used in workflows
+**None** - multiagent-kit is standalone.
 
 **Recommended installation**:
 ```bash
-lite-kits install -Recommended -Kit multiagent
-# Installs: project + git + multiagent
+lite-kits install -Kit multiagent
 ```
 
-**Note**: Installer will automatically install dependencies if missing.
+**Note**: Works best when combined with project-kit and git-kit, but they are not required.
 
 ## Installation
 
-### With dependencies (recommended):
+### As part of recommended kits:
 ```bash
-lite-kits install -Recommended -Kit multiagent
+lite-kits install -Recommended -Kit multiagent  # project + git + multiagent
 ```
 
-### Individually (installs dependencies automatically):
+### Individually:
 ```bash
 lite-kits install -Kit multiagent
 ```
@@ -51,9 +54,14 @@ lite-kits install -Kit multiagent
 
 ```
 your-project/
+├── .claude/commands/              # If Claude Code detected
+│   └── sync.md                    # ✅ Sync status with worktrees
+├── .github/prompts/               # If GitHub Copilot detected
+│   └── sync.prompt.md             # ✅ Sync status with worktrees
 ├── .specify/memory/
 │   ├── pr-workflow-guide.md           # ✅ AI agent PR workflow
-│   └── git-worktrees-protocol.md      # ✅ Parallel development guide
+│   ├── git-worktrees-protocol.md      # ✅ Parallel development guide
+│   └── parallel-work-protocol.md      # ✅ Multi-agent coordination
 └── specs/
     └── NNN-feature/
         └── collaboration/             # 🚧 Created per-feature
@@ -301,15 +309,15 @@ Backend authentication complete. Need frontend integration.
 
 ## Integration with Other Kits
 
-### With project-kit
+### With project-kit (optional)
 - Use `/orient` for each agent to understand their role
-- Use `/review` for agent-to-agent code review
 
-### With git-kit
+### With git-kit (optional)
 - Use `/commit` for agent-attributed commits
 - Use `/pr` to create PRs with multi-agent summary
-- Use `/sync` to visualize worktree status
+- Use `/review` for agent-to-agent code review
 - Use `/cleanup` to remove stale worktrees
+- Combine `/sync` (from multiagent-kit) with git-kit workflows
 
 ---
 
@@ -351,7 +359,7 @@ No configuration needed - works out of the box.
 
 ## Compatibility
 
-- ✅ **Agents**: Claude Code, GitHub Copilot, Cursor
+- ✅ **Agents**: Claude Code, GitHub Copilot
 - ✅ **Platforms**: Linux, macOS, Windows
 - ✅ **Shells**: Bash, PowerShell
 - ✅ **Vanilla safe**: Only adds new files, never modifies existing
@@ -365,8 +373,11 @@ lite-kits remove -Kit multiagent
 ```
 
 Removes:
+- `.claude/commands/sync.md`
+- `.github/prompts/sync.prompt.md`
 - `.specify/memory/pr-workflow-guide.md`
 - `.specify/memory/git-worktrees-protocol.md`
+- `.specify/memory/parallel-work-protocol.md`
 
 **Note**: Existing `specs/*/collaboration/` directories are **preserved** (user data).
 

lite_kits/kits/multiagent/memory/pr-workflow-guide.md

@@ -5,7 +5,7 @@
 
 ## Purpose
 
-This guide defines the workflow for AI agents (Claude Code, GitHub Copilot, Cursor) when creating pull requests in spec-kit projects with multiagent coordination.
+This guide defines the workflow for AI agents (Claude Code, GitHub Copilot) when creating pull requests in spec-kit projects with multiagent coordination.
 
 ## Core Principles
 
@@ -122,12 +122,6 @@ fix: Resolve race condition in async handlers
 via gpt-4 @ github-copilot-cli
 ```
 
-```
-docs: Update API documentation for auth endpoints
-
-via claude-opus-4 @ cursor
-```
-
 ## Multi-Agent Coordination
 
 ### When Multiple Agents Work on Same Feature