@devran-ai/kit 4.1.0

package/.agent/commands/integrate.md

@@ -0,0 +1,32 @@
+---
+description: Integrate third-party services or APIs
+---
+
+# /integrate Command
+
+Integrate external services and APIs.
+
+## Usage
+
+```
+/integrate <service>
+```
+
+## Examples
+
+```
+/integrate Stripe for payments
+/integrate Sendgrid for emails
+/integrate AWS S3 for file storage
+/integrate Firebase for authentication
+```
+
+## Process
+
+1. Research service requirements
+2. Install necessary packages
+3. Configure environment variables
+4. Create service abstraction
+5. Implement integration
+6. Add error handling
+7. Write tests

package/.agent/commands/learn.md

@@ -0,0 +1,29 @@
+---
+description: Learn patterns from current session
+---
+
+# /learn Command
+
+Extract reusable patterns from the current session.
+
+## Usage
+
+```
+/learn                 # Extract all patterns
+/learn <topic>         # Focus on specific topic
+```
+
+## Examples
+
+```
+/learn
+/learn authentication patterns
+/learn error handling approaches
+```
+
+## Output
+
+- Identified patterns
+- Reusable code snippets
+- Best practices discovered
+- Saved to knowledge base

package/.agent/commands/perf.md

@@ -0,0 +1,31 @@
+---
+description: Profile and optimize performance
+---
+
+# /perf Command
+
+Analyze and optimize application performance.
+
+## Usage
+
+```
+/perf analyze <file>   # Profile specific file
+/perf bundle           # Analyze bundle size
+/perf web-vitals       # Check Core Web Vitals
+```
+
+## Examples
+
+```
+/perf analyze src/pages/Dashboard
+/perf bundle optimization suggestions
+/perf Check render performance
+```
+
+## Metrics
+
+- Bundle size analysis
+- Render performance
+- Memory usage
+- API response times
+- Core Web Vitals (LCP, FID, CLS)

package/.agent/commands/plan.md

@@ -0,0 +1,56 @@
+---
+name: plan
+description: Create a comprehensive implementation plan for a feature or change
+invokes: planner
+workflow: plan
+---
+
+# /plan
+
+> **Purpose**: Create a detailed, actionable implementation plan before coding
+
+---
+
+## Usage
+
+```
+/plan [feature description]
+```
+
+## Examples
+
+```
+/plan Add user authentication with JWT
+/plan Refactor database layer to use repository pattern
+/plan Implement caching for API responses
+```
+
+---
+
+## Behavior
+
+1. **Invoke Planner Agent** with the feature description
+2. **Analyze Requirements** - Understand what needs to be built
+3. **Check Alignment** - Verify against operating constraints
+4. **Create Plan** - Detailed steps with files, actions, risks
+5. **Wait for Approval** - Plan must be approved before implementation
+
+---
+
+## Output
+
+A structured implementation plan with:
+
+- Requirements summary
+- Architecture changes
+- Implementation steps (phased)
+- Testing strategy
+- Risks and mitigations
+- Estimated effort
+
+---
+
+## Related Commands
+
+- `/implement` - Execute an approved plan
+- `/track` - Start formal tracking

package/.agent/commands/pr-describe.md

@@ -0,0 +1,65 @@
+---
+description: Auto-generate PR title, summary, and labels from diff analysis
+---
+
+# /pr-describe Command
+
+Automatically generate a conventional-commit title, structured summary, change categorization, and suggested labels by analyzing the PR diff.
+
+## Usage
+
+```
+/pr-describe                        # Describe current branch diff
+/pr-describe #<number>              # Describe existing PR
+/pr-describe <url>                  # Describe PR at GitHub URL
+/pr-describe #<number> --update     # Update existing PR description in-place
+/pr-describe --format brief         # Short summary only
+```
+
+## Examples
+
+```
+/pr-describe                        # Generate description for current branch
+/pr-describe #42                    # Generate description for PR #42
+/pr-describe #42 --update           # Overwrite PR #42's description
+/pr-describe --format brief         # One-paragraph summary
+```
+
+## What It Does
+
+1. Analyzes the full diff (commits, file changes, additions/deletions)
+2. Detects the primary change type (feat, fix, refactor, chore, etc.)
+3. Generates conventional-commit title from branch name and diff content
+4. Creates structured body (Summary, Changes by Category, Test Plan)
+5. Suggests labels based on file types and change patterns
+6. Optionally updates the PR description on GitHub
+
+## Output
+
+```markdown
+## Generated PR Description
+
+**Title**: feat(auth): add OAuth2 provider support
+
+**Summary**:
+Adds Google and GitHub OAuth2 providers with PKCE flow,
+token refresh, and session management.
+
+**Changes**:
+- Feature: 4 files (OAuth provider, token service, session middleware, config)
+- Tests: 3 files (unit + integration for OAuth flow)
+- Config: 1 file (environment variables for provider credentials)
+
+**Labels**: `feature`, `auth`, `needs-review`
+
+**Test Plan**:
+- [ ] OAuth login flow with Google provider
+- [ ] Token refresh after expiry
+- [ ] Session persistence across browser restart
+```
+
+## Related
+
+- `/pr` — Create a pull request (uses /pr-describe internally)
+- `/pr-review` — Review a pull request
+- `/pr-status` — Check PR merge readiness

package/.agent/commands/pr-fix.md

@@ -0,0 +1,45 @@
+---
+description: Fix pull request issues based on review comments
+---
+
+# /pr-fix Command
+
+Fix PR issues by fetching review comments, prioritizing by severity, implementing fixes, and pushing resolution.
+
+## Usage
+
+```
+/pr-fix <url>                      # Fix PR at GitHub URL
+/pr-fix <owner/repo>#<number>      # Fix PR by repo and number
+/pr-fix #<number>                  # Fix PR in current repo
+/pr-fix #<number> --critical-only  # Fix only CRITICAL findings
+/pr-fix #<number> --dry-run        # Show fix plan without implementing
+```
+
+## Examples
+
+```
+/pr-fix https://github.com/org/repo/pull/42
+/pr-fix deelmarkt/app#10
+/pr-fix #5
+/pr-fix #5 --critical-only
+/pr-fix #5 --dry-run
+```
+
+## What It Does
+
+1. Fetches all review comments and requested changes
+2. Categorizes fixes by severity (P0-P3)
+3. Checks out the PR branch
+4. Implements fixes in priority order
+5. Runs `/review` verification pipeline
+6. Pushes fixes and posts resolution summary
+7. Re-requests review from original reviewer
+
+## Related
+
+- `/pr-review` — Review a pull request
+- `/pr` — Create a pull request
+- `/pr-merge` — Merge with dependency validation
+- `/pr-status` — Check merge readiness
+- `/review` — Local code quality gates

package/.agent/commands/pr-merge.md

@@ -0,0 +1,45 @@
+---
+description: Merge a pull request safely with dependency validation and post-merge checks
+---
+
+# /pr-merge Command
+
+Safely merge a pull request after validating CI status, review approval, dependency chain, and branch strategy compliance. Includes post-merge verification and dependent PR notification.
+
+## Usage
+
+```
+/pr-merge #<number>                 # Merge PR in current repo
+/pr-merge <url>                     # Merge PR at GitHub URL
+/pr-merge #<number> --squash        # Force squash merge
+/pr-merge #<number> --merge-commit  # Force merge commit
+/pr-merge #<number> --rebase        # Force rebase merge
+/pr-merge #<number> --dry-run       # Validate merge readiness without merging
+```
+
+## Examples
+
+```
+/pr-merge #42                       # Merge with auto-detected strategy
+/pr-merge #42 --squash              # Squash merge
+/pr-merge #42 --dry-run             # Check if #42 is ready to merge
+/pr-merge https://github.com/org/repo/pull/42
+```
+
+## What It Does
+
+1. Validates PR state (open, mergeable, not blocked)
+2. Verifies review approval and CI checks passing
+3. Validates dependency chain (`Depends-On:` PRs all merged)
+4. Checks branch strategy compliance (correct merge target)
+5. Selects merge strategy (squash / merge commit / rebase)
+6. Executes merge and deletes merged branch
+7. Runs post-merge validation (CI on target branch)
+8. Notifies dependent PRs that this dependency is resolved
+
+## Related
+
+- `/pr` — Create a pull request
+- `/pr-review` — Review a pull request
+- `/pr-status` — Check merge readiness
+- `/pr-split` — Split oversized PR into sub-PRs

package/.agent/commands/pr-review.md

@@ -0,0 +1,50 @@
+---
+description: Review a pull request with Senior Staff Engineer expertise
+---
+
+# /pr-review Command
+
+Review any pull request with multi-perspective analysis covering PR hygiene, branch strategy, code quality, security, testing, and architecture.
+
+## Usage
+
+```
+/pr-review <url>                    # Review PR at GitHub URL
+/pr-review <owner/repo>#<number>    # Review PR by repo and number
+/pr-review #<number>                # Review PR in current repo
+/pr-review #<number> --local        # Review locally only (don't post)
+/pr-review #<number> --focus <area> # Focus on specific perspective
+```
+
+## Examples
+
+```
+/pr-review https://github.com/org/repo/pull/42
+/pr-review deelmarkt/app#10
+/pr-review #5
+/pr-review #5 --local
+/pr-review #5 --focus security
+```
+
+## Focus Areas
+
+- `security` — Security-only review
+- `quality` — Code quality-only review
+- `hygiene` — PR structure and process compliance
+
+## What It Does
+
+1. Fetches PR metadata, diff, and existing reviews
+2. Detects branch strategy (GitFlow / Trunk-Based)
+3. Applies 6-perspective review framework
+4. Generates findings with severity and fix suggestions
+5. Posts review to GitHub (REQUEST_CHANGES / APPROVE / COMMENT)
+
+## Related
+
+- `/pr` — Create a pull request
+- `/pr-fix` — Fix issues from review comments
+- `/pr-merge` — Merge with dependency validation
+- `/pr-split` — Split oversized PRs
+- `/pr-status` — Check merge readiness
+- `/review` — Local code quality gates

package/.agent/commands/pr-split.md

@@ -0,0 +1,54 @@
+---
+description: Split oversized PRs into focused sub-PRs by concern category
+---
+
+# /pr-split Command
+
+Split large (L/XL) pull requests into focused, independently-reviewable sub-PRs organized by concern category with a dependency-ordered merge plan.
+
+## Usage
+
+```
+/pr-split                           # Analyze current branch for splitting
+/pr-split #<number>                 # Analyze existing PR for splitting
+/pr-split --dry-run                 # Show split plan without creating branches
+/pr-split --auto                    # Auto-split by file category
+```
+
+## Examples
+
+```
+/pr-split                           # Split current branch
+/pr-split #42                       # Split PR #42
+/pr-split --dry-run                 # Preview split plan only
+/pr-split #42 --auto                # Auto-split without manual grouping
+```
+
+## What It Does
+
+1. Analyzes full diff and classifies PR size (must be L or XL)
+2. Categorizes files by concern (feature, tests, config, deps, docs, infra)
+3. Proposes split plan with merge ordering and dependencies
+4. Waits for user approval of the split plan
+5. Creates sub-branches with selective cherry-pick/checkout
+6. Verifies each sub-branch independently (build + tests)
+7. Creates sub-PRs with structured bodies and dependency declarations
+8. Updates original PR with links to all sub-PRs
+
+## Split Categories
+
+| Category | Examples |
+| :--- | :--- |
+| Feature Code | `src/`, application logic |
+| Tests | `tests/`, `*.test.*`, `*.spec.*` |
+| Configuration | `.eslintrc`, `tsconfig`, tool configs |
+| Dependencies | `package.json`, lock files |
+| Documentation | `README`, `docs/`, `CHANGELOG` |
+| Infrastructure | `Dockerfile`, CI/CD, deploy configs |
+
+## Related
+
+- `/pr` — Create a pull request (warns on XL size)
+- `/pr-review` — Review each sub-PR
+- `/pr-merge` — Merge sub-PRs in dependency order
+- `/pr-status` — Check status of all sub-PRs

package/.agent/commands/pr-status.md

@@ -0,0 +1,56 @@
+---
+description: Triage pull requests with CI status, staleness detection, and dependency readiness
+---
+
+# /pr-status Command
+
+Quick triage view for one or more pull requests — CI status, review state, staleness, dependency readiness, and merge eligibility at a glance.
+
+## Usage
+
+```
+/pr-status                          # All open PRs in current repo
+/pr-status #<number>                # Single PR status
+/pr-status <url>                    # PR at GitHub URL
+/pr-status <owner/repo>            # All open PRs in specified repo
+/pr-status #<number> --deps         # Show dependency chain status
+```
+
+## Examples
+
+```
+/pr-status                          # Triage all open PRs
+/pr-status #42                      # Status of PR #42
+/pr-status https://github.com/org/repo/pull/10
+/pr-status deelmarkt/app            # All open PRs in deelmarkt/app
+/pr-status #42 --deps               # Dependency chain for PR #42
+```
+
+## What It Does
+
+1. Fetches PR metadata (state, reviews, checks, labels)
+2. Classifies CI status (passing / failing / pending / none)
+3. Detects staleness (days since last update, sync status with target)
+4. Validates dependency chain (`Depends-On:` references)
+5. Calculates merge readiness score (0-100)
+6. Outputs a triage dashboard with actionable next steps
+
+## Output
+
+```
+PR #42 — feat(auth): add OAuth2 provider
+├─ Status: OPEN
+├─ Reviews: 1/1 APPROVED
+├─ CI: ✓ All checks passing (3/3)
+├─ Staleness: Fresh (updated 2h ago, in sync with main)
+├─ Dependencies: #40 MERGED, #41 OPEN (blocking)
+├─ Merge Ready: No — dependency #41 not yet merged
+└─ Next: Merge #41 first, then this PR is ready
+```
+
+## Related
+
+- `/pr` — Create a pull request
+- `/pr-review` — Review a pull request
+- `/pr-merge` — Merge a pull request safely
+- `/pr-describe` — Auto-generate PR description

package/.agent/commands/pr.md

@@ -0,0 +1,58 @@
+---
+description: Create production-grade pull requests with branch validation, size guards, and CI verification
+---
+
+# /pr Command
+
+Create pull requests with branch strategy validation, size/scope guards, pre-flight checks, and CI verification.
+
+## Usage
+
+```
+/pr                    # Create PR targeting default branch
+/pr [target]           # Create PR targeting specific branch (e.g., /pr dev)
+/pr --draft            # Create PR as draft
+/pr --draft [target]   # Create draft PR targeting specific branch
+```
+
+## Examples
+
+```
+/pr                    # Auto-detects target via branch strategy
+/pr dev                # Target dev branch explicitly
+/pr --draft            # Create draft PR
+/pr main               # Target main (validated against strategy)
+```
+
+## What It Does
+
+1. Detects branch strategy (GitFlow / Trunk-Based) and validates target
+2. Syncs with target branch and resolves conflicts
+3. Checks PR size (XS-XL) and scope coherence
+4. Runs pre-flight `/review` pipeline (lint, types, tests, security, build)
+5. Generates conventional commit title from branch name
+6. Creates PR with structured body (Summary, Changes, Test Plan)
+7. Monitors CI pipeline status
+
+## PR Toolkit
+
+| Command | Purpose |
+| :--- | :--- |
+| `/pr` | Create a pull request |
+| `/pr-review #N` | Review an existing PR |
+| `/pr-fix #N` | Fix PR based on review comments |
+| `/pr-merge #N` | Merge PR safely with validation |
+| `/pr-split` | Split oversized PR into sub-PRs |
+| `/pr-status` | Triage PRs with merge readiness |
+| `/pr-describe` | Auto-generate PR description |
+
+## Related
+
+- `/pr-review` — Review a pull request
+- `/pr-fix` — Fix issues from review comments
+- `/pr-merge` — Merge with dependency validation
+- `/pr-split` — Split oversized PRs
+- `/pr-status` — Check merge readiness
+- `/pr-describe` — Auto-generate description
+- `/review` — Local code quality gates
+- `/preflight` — Production readiness check

package/.agent/commands/refactor.md

@@ -0,0 +1,32 @@
+---
+description: Refactor code for better quality
+---
+
+# /refactor Command
+
+Refactor code to improve quality and maintainability.
+
+## Usage
+
+```
+/refactor <file>       # Refactor specific file
+/refactor extract      # Extract functions/components
+/refactor rename       # Rename with updates
+/refactor cleanup      # Remove dead code
+```
+
+## Examples
+
+```
+/refactor src/services/user.service.ts
+/refactor Extract common validation logic
+/refactor Cleanup unused imports in utils/
+```
+
+## Principles
+
+- Maintain functionality
+- Improve readability
+- Apply SOLID principles
+- Reduce complexity
+- Add missing tests

package/.agent/commands/research.md

@@ -0,0 +1,28 @@
+---
+description: Research technologies, best practices, or solutions
+---
+
+# /research Command
+
+Conduct thorough research on a topic for informed decisions.
+
+## Usage
+
+```
+/research <topic>
+```
+
+## Examples
+
+```
+/research React vs Vue for our use case
+/research best authentication patterns for mobile
+/research database options for high-write workloads
+```
+
+## Output
+
+- Summary of findings
+- Pros and cons comparison
+- Recommendations
+- Sources and references

package/.agent/commands/scout.md

@@ -0,0 +1,30 @@
+---
+description: Explore and understand codebase structure
+---
+
+# /scout Command
+
+Analyze and document codebase architecture.
+
+## Usage
+
+```
+/scout                  # Overview of entire project
+/scout <path>          # Explore specific directory
+/scout <file>          # Deep dive into file
+```
+
+## Examples
+
+```
+/scout src/services
+/scout authentication module
+/scout database schema
+```
+
+## Output
+
+- File structure overview
+- Key components identified
+- Dependencies mapped
+- Architecture patterns detected

package/.agent/commands/security-scan.md

@@ -0,0 +1,33 @@
+---
+description: Run security audit and vulnerability scan
+---
+
+# /security-scan Command
+
+Scan codebase for security vulnerabilities.
+
+## Usage
+
+```
+/security-scan                 # Full security audit
+/security-scan deps           # Dependency vulnerabilities
+/security-scan code           # Code vulnerabilities
+/security-scan secrets        # Secret detection
+```
+
+## Examples
+
+```
+/security-scan
+/security-scan Check for hardcoded credentials
+/security-scan Review authentication implementation
+```
+
+## Checks
+
+- Dependency vulnerabilities (npm audit)
+- Hardcoded secrets/credentials
+- SQL injection risks
+- XSS vulnerabilities
+- Authentication weaknesses
+- OWASP Top 10 compliance

package/.agent/commands/setup.md

@@ -0,0 +1,31 @@
+---
+description: Setup project with kit configuration
+---
+
+# /setup Command
+
+Initialize or configure the AI kit for a project.
+
+## Usage
+
+```
+/setup                 # Full setup
+/setup <component>     # Setup specific component
+```
+
+## Examples
+
+```
+/setup
+/setup TypeScript
+/setup Git hooks
+```
+
+## Setup Items
+
+- Project structure
+- TypeScript configuration
+- ESLint/Prettier
+- Git hooks
+- CI/CD templates
+- Testing setup