lite-kits 0.1.0__py3-none-any.whl

lite_kits/kits/project/README.md

@@ -0,0 +1,244 @@
+# Project Kit
+
+**Status**: ✅ Recommended (Default)
+
+Essential project-level utilities and enhancements for vanilla spec-kit. Includes agent orientation, code review, quality checks, and enhanced feature creation scripts.
+
+## What It Adds
+
+### Commands (AI Agents)
+
+| Command | Claude Code | GitHub Copilot | Description |
+|---------|-------------|----------------|-------------|
+| `/orient` | ✅ | ✅ | Agent orientation protocol (most essential!) |
+| `/review` | 🚧 | 🚧 | Code review helper |
+| `/audit` | 🚧 | 🚧 | Security & quality audit |
+| `/stats` | 🚧 | 🚧 | Project statistics |
+
+### Scripts (Enhanced Vanilla)
+
+| Script | Bash | PowerShell | Description |
+|--------|------|------------|-------------|
+| Feature creation | 🚧 | 🚧 | Custom feature numbering/naming |
+
+✅ = Implemented | 🚧 = Coming Soon
+
+## Installation
+
+### As part of recommended kits:
+```bash
+lite-kits install -Recommended  # project + git
+```
+
+### Individually:
+```bash
+lite-kits install -Kit project
+```
+
+## What Gets Installed
+
+```
+your-project/
+├── .claude/commands/              # If Claude Code detected
+│   ├── orient.md                  # ✅ Essential!
+│   ├── review.md                  # 🚧 Coming Soon
+│   ├── audit.md                   # 🚧 Coming Soon
+│   └── stats.md                   # 🚧 Coming Soon
+├── .github/prompts/               # If GitHub Copilot detected
+│   ├── orient.prompt.md           # ✅ Essential!
+│   ├── review.prompt.md           # 🚧 Coming Soon
+│   ├── audit.prompt.md            # 🚧 Coming Soon
+│   └── stats.prompt.md            # 🚧 Coming Soon
+└── .specify/scripts/              # Enhanced vanilla scripts
+    ├── bash/
+    │   └── create-feature-enhanced.sh      # 🚧 Coming Soon
+    └── powershell/
+        └── Create-Feature-Enhanced.ps1     # 🚧 Coming Soon
+```
+
+**Note**: Vanilla spec-kit files are **never modified** - only new files are added.
+
+## Commands
+
+### `/orient` - Agent Orientation ⭐ ESSENTIAL
+
+**Purpose**: Help AI agents quickly understand project context before starting work.
+
+**What it does**:
+1. Reads `.github/copilot-instructions.md` (primary source)
+2. Reads `.specify/memory/constitution.md` (project philosophy)
+3. Checks current git state (branch, recent commits)
+4. Reviews collaboration directories (if multiagent-kit installed)
+5. Determines agent role (Claude = leader, Copilot = specialist)
+6. Outputs concise summary (~150-200 words)
+
+**Example usage**:
+```
+/orient
+
+## Orientation Complete - Primary Agent
+
+**I am**: claude-sonnet-4.5 @ Claude Code (Primary)
+
+**Project**: Pip-installable add-on for spec-kit
+
+**Stack**: Python 3.11+, typer, rich
+
+**Principles**:
+- Add-on pattern (no vanilla modifications)
+- Cross-platform (Bash + PowerShell)
+- Cross-agent (Claude + Copilot)
+
+**State**: Branch dev/001-starter-kits, 3 files changed
+
+**Coordination**: Solo work
+
+**Next**: Implement project-kit structure
+
+**Confirm?**: Ready to proceed?
+```
+
+**Why this is essential**: Every AI agent should run `/orient` at the start of each session to get up to speed quickly without wasting tokens.
+
+---
+
+### `/review` - Code Review (Coming Soon)
+
+**Purpose**: Review code changes against project constitution and best practices.
+
+**What it will do**:
+- Check staged changes against constitution principles
+- Identify common code smells
+- Suggest improvements
+- Verify test coverage
+- Check documentation completeness
+
+---
+
+### `/audit` - Security & Quality Audit (Coming Soon)
+
+**Purpose**: Scan for security issues and quality problems.
+
+**What it will do**:
+- Scan for hardcoded secrets/credentials
+- Check for common vulnerabilities (SQL injection, XSS, CSRF)
+- Analyze dependencies for known CVEs
+- Verify input validation
+- Check file permissions
+
+---
+
+### `/stats` - Project Statistics (Coming Soon)
+
+**Purpose**: Show project health metrics.
+
+**What it will do**:
+- Lines of code by language
+- Test coverage percentage
+- Git activity with agent attribution
+- Complexity metrics
+- Dependency count
+- Health score
+
+---
+
+## Enhanced Scripts
+
+### Feature Creation Enhancement (Coming Soon)
+
+**Problem**: Vanilla `create-new-feature` script auto-generates feature numbers and uses first 3 words of description for naming.
+
+**Enhancement**: Full control over feature numbering and naming.
+
+**Usage** (planned):
+```bash
+# Vanilla (auto number, auto name from "Add user authentication system")
+.specify/scripts/bash/create-new-feature.sh "Add user authentication system"
+# Creates: 003-add-user-authentication
+
+# Enhanced (custom number and name)
+.specify/scripts/bash/create-feature-enhanced.sh --num 010 --name user-auth-v2 "Add user authentication system"
+# Creates: 010-user-auth-v2
+
+# Enhanced (custom number, auto name)
+.specify/scripts/bash/create-feature-enhanced.sh --num 007 "Add user authentication system"
+# Creates: 007-add-user-authentication
+```
+
+**Benefits**:
+- Match feature numbers to issue/ticket numbers
+- Use shorter, clearer names
+- Support feature name conventions (e.g., `api-`, `ui-`, `db-` prefixes)
+
+---
+
+## Use Cases
+
+### Solo Developer with AI Agent
+**Install**: `--recommended` (includes project-kit)
+**Use**: `/orient` at start of every session (essential!)
+
+### Team with Multiple Agents
+**Install**: `--recommended` + `--kit=multiagent`
+**Use**: `/orient` + `/review` before committing
+
+### Security-Focused Project
+**Install**: `--recommended`
+**Use**: `/audit` regularly, `/review` on every change
+
+### Custom Workflow Needs
+**Install**: `--kit=project`
+**Use**: Enhanced scripts for precise feature naming
+
+---
+
+## Configuration
+
+No configuration needed - works out of the box.
+
+**Optional customization**:
+- Edit `.github/copilot-instructions.md` - Affects `/orient` output
+- Edit `.specify/memory/constitution.md` - Project principles for `/review`
+
+---
+
+## Dependencies
+
+**None** - project-kit is standalone.
+
+**Note**: multiagent-kit recommends project-kit for `/review` and best practices.
+
+---
+
+## Compatibility
+
+- ✅ **Agents**: Claude Code, GitHub Copilot
+- ✅ **Platforms**: Linux, macOS, Windows
+- ✅ **Shells**: Bash, PowerShell
+- ✅ **Vanilla safe**: Only adds new files, never modifies existing
+
+---
+
+## Uninstall
+
+```bash
+lite-kits remove -Kit project
+```
+
+Removes:
+- `.claude/commands/{orient,review,audit,stats}.md`
+- `.github/prompts/{orient,review,audit,stats}.prompt.md`
+- `.specify/scripts/{bash,powershell}/create-feature-enhanced.{sh,ps1}`
+
+---
+
+## Future Enhancements
+
+Considering for project-kit:
+- `/docs` - Generate/update documentation
+- `/history` - Show project timeline
+- `/dependencies` - Dependency analysis
+- `/performance` - Performance profiling
+- Template library (api, cli, library, frontend feature templates)
+
+Suggest more in [GitHub Discussions](https://github.com/tmorgan181/spec-kit-multiagent-lite/discussions).

lite_kits/kits/project/claude/commands/orient.md

@@ -0,0 +1,163 @@
+---
+description: Quickly orient to project context, installed kits, and current state
+---
+
+# Agent Orientation Protocol
+
+**Purpose**: Provide concise project orientation for AI agents at start of work session.
+
+## Execution Steps
+
+Execute the following steps to gather orientation information:
+
+### 1. Detect Installed Kits
+
+Check for kit marker files to determine what's installed:
+
+```bash
+# Initialize kit detection variables
+PROJECT_KIT=false
+GIT_KIT=false
+MULTIAGENT_KIT=false
+
+# Check for project-kit markers
+[ -f .claude/commands/review.md ] && PROJECT_KIT=true
+
+# Check for git-kit markers
+[ -f .claude/commands/commit.md ] && GIT_KIT=true
+
+# Check for multiagent-kit markers
+[ -f .specify/memory/pr-workflow-guide.md ] && MULTIAGENT_KIT=true
+```
+
+### 2. Determine Agent Role
+
+Identify which agent you are and your role:
+
+```bash
+# Detect model and interface
+MODEL="claude-sonnet-4.5"  # Default Claude model, adjust based on actual model used
+INTERFACE="Claude Code"
+AGENT_ROLE="$MODEL @ $INTERFACE (Primary)"
+```
+
+### 3. Read Primary Documentation
+
+Read these files in order (if they exist):
+
+1. **`.github/copilot-instructions.md`** - Project overview, stack, conventions
+2. **`.specify/memory/constitution.md`** - Project philosophy and principles
+3. **`README.md`** - General project information
+
+Extract:
+- Project name and description
+- Technology stack
+- Key architectural decisions
+- Development conventions
+
+### 4. Check Git State
+
+```bash
+# Current branch
+git branch --show-current
+
+# Recent commits (last 5)
+git log --oneline -5
+
+# Uncommitted changes
+git status --short
+
+# Untracked files count
+git ls-files --others --exclude-standard | wc -l
+```
+
+### 5. Check Active Work
+
+Look for active feature work:
+
+```bash
+# List specs directories
+ls -1d specs/*/ 2>/dev/null | tail -3
+
+# Check for current spec/plan/tasks
+CURRENT_BRANCH=$(git branch --show-current)
+if [[ "$CURRENT_BRANCH" =~ ^[0-9]+ ]]; then
+  SPEC_DIR="specs/$CURRENT_BRANCH"
+  [ -f "$SPEC_DIR/spec.md" ] && echo "✓ Spec exists"
+  [ -f "$SPEC_DIR/plan.md" ] && echo "✓ Plan exists"
+  [ -f "$SPEC_DIR/tasks.md" ] && echo "✓ Tasks exist"
+fi
+```
+
+### 6. Check Multi-Agent Coordination (if multiagent-kit installed)
+
+If `MULTIAGENT_KIT=true`:
+
+```bash
+# Check for active sessions
+find specs/*/collaboration/active/sessions/ -name "*.md" 2>/dev/null | wc -l
+
+# Check for pending handoffs
+find specs/*/collaboration/active/decisions/ -name "handoff-*.md" 2>/dev/null | head -1
+```
+
+### 7. Generate Concise Output
+
+Provide a **concise summary** (~150 words max) in this format:
+
+```
+## Orientation Complete
+
+**Installed Kits**: [list detected kits or "vanilla only"]
+
+**I am**: [AGENT_ROLE from step 2]
+**Project**: [project name from docs]
+**Stack**: [main technologies]
+**Branch**: [current branch]
+**Recent work**: [summary of last 1-2 commits]
+**Uncommitted changes**: [count of modified files]
+**Active feature**: [current spec if on feature branch]
+**Coordination**: [solo work / handoff pending / etc]
+
+**Next suggested action**: [based on state analysis below]
+```
+
+### 8. Suggest Next Action
+
+Based on the state you discovered, suggest the next logical action:
+
+**Decision logic**:
+
+- **No spec on current branch** → "Run `/specify` to start a new feature"
+- **Spec exists, no plan** → "Run `/plan` to create implementation plan"
+- **Plan exists, no tasks** → "Run `/tasks` to break down into tasks"
+- **Tasks exist** → "Run `/implement` to start coding"
+- **Handoff detected** (multiagent) → "Review handoff in `specs/[feature]/collaboration/active/decisions/`"
+- **Uncommitted changes** → "Review changes and consider running `/commit`" (if git-kit installed)
+
+## Important Notes
+
+- Keep output **concise** - this is an orientation, not a full analysis
+- Focus on **actionable context** - what the agent needs to know right now
+- **Don't modify any files** - this is read-only orientation
+- If documentation is missing, note it briefly and continue
+- Gracefully handle missing files (don't error if docs don't exist)
+
+## Example Output
+
+```
+## Orientation Complete
+
+**Installed Kits**: project, git
+
+**I am**: claude-sonnet-4.5 @ Claude Code (Primary)
+**Project**: Blog Platform API (TypeScript/Node.js)
+**Stack**: Node.js, Express, PostgreSQL, TypeScript
+**Branch**: dev/003-user-authentication
+**Recent work**: Added JWT token validation (2 commits today)
+**Uncommitted changes**: 3 modified files
+**Active feature**: specs/003-user-authentication/ (spec + plan complete)
+**Coordination**: Solo work
+
+**Next suggested action**: Run `/tasks` to break down the implementation plan into actionable tasks.
+```

lite_kits/kits/project/github/prompts/orient.prompt.md

@@ -0,0 +1,163 @@
+---
+description: Quickly orient to project context, installed kits, and current state
+---
+
+# Agent Orientation Protocol
+
+**Purpose**: Provide concise project orientation for AI agents at start of work session.
+
+## Execution Steps
+
+Execute the following steps to gather orientation information:
+
+### 1. Detect Installed Kits
+
+Check for kit marker files to determine what's installed:
+
+```powershell
+# Initialize kit detection variables
+$PROJECT_KIT = $false
+$GIT_KIT = $false
+$MULTIAGENT_KIT = $false
+
+# Check for project-kit markers
+if (Test-Path .github/prompts/review.prompt.md) { $PROJECT_KIT = $true }
+
+# Check for git-kit markers
+if (Test-Path .github/prompts/commit.prompt.md) { $GIT_KIT = $true }
+
+# Check for multiagent-kit markers
+if (Test-Path .specify/memory/pr-workflow-guide.md) { $MULTIAGENT_KIT = $true }
+```
+
+### 2. Determine Agent Role
+
+Identify which agent you are and your role:
+
+```powershell
+# Detect model and interface
+$MODEL = "Grok Code Fast 1"  # Default Grok model for GitHub Copilot, adjust based on actual model used
+$INTERFACE = "GitHub Copilot"
+$AGENT_ROLE = "$MODEL @ $INTERFACE (Specialist)"
+```
+
+### 3. Read Primary Documentation
+
+Read these files in order (if they exist):
+
+1. **`.github/copilot-instructions.md`** - Project overview, stack, conventions
+2. **`.specify/memory/constitution.md`** - Project philosophy and principles
+3. **`README.md`** - General project information
+
+Extract:
+- Project name and description
+- Technology stack
+- Key architectural decisions
+- Development conventions
+
+### 4. Check Git State
+
+```powershell
+# Current branch
+git branch --show-current
+
+# Recent commits (last 5)
+git log --oneline -5
+
+# Uncommitted changes
+git status --short
+
+# Untracked files count
+(git ls-files --others --exclude-standard).Count
+```
+
+### 5. Check Active Work
+
+Look for active feature work:
+
+```powershell
+# List specs directories
+Get-ChildItem -Path specs -Directory -ErrorAction SilentlyContinue | Select-Object -Last 3 -ExpandProperty Name
+
+# Check for current spec/plan/tasks
+$CURRENT_BRANCH = git branch --show-current
+if ($CURRENT_BRANCH -match '^\d+') {
+  $SPEC_DIR = "specs/$CURRENT_BRANCH"
+  if (Test-Path "$SPEC_DIR/spec.md") { Write-Host "✓ Spec exists" }
+  if (Test-Path "$SPEC_DIR/plan.md") { Write-Host "✓ Plan exists" }
+  if (Test-Path "$SPEC_DIR/tasks.md") { Write-Host "✓ Tasks exist" }
+}
+```
+
+### 6. Check Multi-Agent Coordination (if multiagent-kit installed)
+
+If `$MULTIAGENT_KIT -eq $true`:
+
+```powershell
+# Check for active sessions
+(Get-ChildItem -Path specs/*/collaboration/active/sessions/ -Filter *.md -Recurse -ErrorAction SilentlyContinue).Count
+
+# Check for pending handoffs
+Get-ChildItem -Path specs/*/collaboration/active/decisions/ -Filter handoff-*.md -Recurse -ErrorAction SilentlyContinue | Select-Object -First 1
+```
+
+### 7. Generate Concise Output
+
+Provide a **concise summary** (~150 words max) in this format:
+
+```
+## Orientation Complete
+
+**Installed Kits**: [list detected kits or "vanilla only"]
+
+**I am**: [$AGENT_ROLE from step 2]
+**Project**: [project name from docs]
+**Stack**: [main technologies]
+**Branch**: [current branch]
+**Recent work**: [summary of last 1-2 commits]
+**Uncommitted changes**: [count of modified files]
+**Active feature**: [current spec if on feature branch]
+**Coordination**: [solo work / handoff pending / etc]
+
+**Next suggested action**: [based on state analysis below]
+```
+
+### 8. Suggest Next Action
+
+Based on the state you discovered, suggest the next logical action:
+
+**Decision logic**:
+
+- **No spec on current branch** → "Run `/specify` to start a new feature"
+- **Spec exists, no plan** → "Run `/plan` to create implementation plan"
+- **Plan exists, no tasks** → "Run `/tasks` to break down into tasks"
+- **Tasks exist** → "Run `/implement` to start coding"
+- **Handoff detected** (multiagent) → "Review handoff in `specs/[feature]/collaboration/active/decisions/`"
+- **Uncommitted changes** → "Review changes and consider running `/commit`" (if git-kit installed)
+
+## Important Notes
+
+- Keep output **concise** - this is an orientation, not a full analysis
+- Focus on **actionable context** - what the agent needs to know right now
+- **Don't modify any files** - this is read-only orientation
+- If documentation is missing, note it briefly and continue
+- Gracefully handle missing files (don't error if docs don't exist)
+
+## Example Output
+
+```
+## Orientation Complete
+
+**Installed Kits**: project, git
+
+**I am**: Grok Code Fast 1 @ GitHub Copilot (Specialist)
+**Project**: Blog Platform API (TypeScript/Node.js)
+**Stack**: Node.js, Express, PostgreSQL, TypeScript
+**Branch**: dev/003-user-authentication
+**Recent work**: Added JWT token validation (2 commits today)
+**Uncommitted changes**: 3 modified files
+**Active feature**: specs/003-user-authentication/ (spec + plan complete)
+**Coordination**: Solo work
+
+**Next suggested action**: Run `/tasks` to break down the implementation plan into actionable tasks.
+```