@devran-ai/kit 4.1.0

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

@@ -0,0 +1,65 @@
+---
+name: code-review
+description: Perform comprehensive code review on files or directories
+invokes: code-reviewer
+workflow: review
+---
+
+# /code-review
+
+> **Purpose**: Quality and security review of code changes
+
+---
+
+## Usage
+
+```
+/code-review [path]
+/code-review              # Review uncommitted changes
+/code-review src/auth/    # Review specific directory
+/code-review file.ts      # Review specific file
+```
+
+---
+
+## Behavior
+
+1. **Invoke Code Reviewer Agent**
+2. **Capture Changes** - Get diff or specified files
+3. **Apply Checklist** - Security, quality, best practices
+4. **Generate Report** - Categorized findings
+5. **Provide Verdict** - APPROVE / BLOCK / WARNING
+
+---
+
+## Output
+
+```markdown
+## Code Review Report
+
+| Severity | Count |
+| :------- | :---- |
+| CRITICAL | 0     |
+| HIGH     | 1     |
+| MEDIUM   | 3     |
+| LOW      | 2     |
+
+### [HIGH] Missing Error Handling
+
+**File**: `src/api/client.ts:42`
+**Issue**: Async call without try/catch
+**Fix**: Add error boundary
+
+---
+
+**Verdict**: ⚠️ WARNING
+
+Fix HIGH issues before merging.
+```
+
+---
+
+## Related Commands
+
+- `/security-scan` - Deep security analysis
+- `/verify` - Full verification loop

package/.agent/commands/compact.md

@@ -0,0 +1,28 @@
+---
+description: Compact context to preserve memory
+---
+
+# /compact Command
+
+Summarize and compact the current session context.
+
+## Usage
+
+```
+/compact               # Compact current session
+/compact <focus>       # Focus on specific area
+```
+
+## Examples
+
+```
+/compact
+/compact authentication work
+/compact database changes
+```
+
+## Purpose
+
+- Preserve important context
+- Reduce memory usage
+- Continue work across sessions

package/.agent/commands/cook.md

@@ -0,0 +1,30 @@
+---
+description: Full page coding workflow
+---
+
+# /cook Command
+
+Complete "from scratch to done" coding workflow.
+
+## Usage
+
+```
+/cook <feature>
+```
+
+## Examples
+
+```
+/cook user authentication
+/cook product listing page
+/cook payment checkout flow
+```
+
+## Process
+
+1. Analyze requirements
+2. Design architecture
+3. Write implementation
+4. Add tests
+5. Document
+6. Verify quality

package/.agent/commands/db.md

@@ -0,0 +1,30 @@
+---
+description: Database schema design and migrations
+---
+
+# /db Command
+
+Design, modify, or migrate database schemas.
+
+## Usage
+
+```
+/db design <entity>    # Design new schema
+/db migrate            # Create migration
+/db seed               # Create seed data
+/db analyze            # Analyze current schema
+```
+
+## Examples
+
+```
+/db design User entity with relations
+/db migrate add email verification fields
+/db seed create test users
+```
+
+## Output
+
+- Prisma schema updates
+- Migration files generated
+- Seed scripts created

package/.agent/commands/debug.md

@@ -0,0 +1,31 @@
+---
+description: Debug issues systematically
+workflow: debug
+---
+
+# /debug Command
+
+Systematically debug and fix issues.
+
+## Usage
+
+```
+/debug <issue>
+```
+
+## Examples
+
+```
+/debug Why login fails
+/debug API returns 500 error
+/debug Component not rendering
+```
+
+## Process
+
+1. Reproduce the issue
+2. Gather evidence (logs, errors)
+3. Form hypotheses
+4. Test hypotheses
+5. Apply fix
+6. Verify resolution

package/.agent/commands/deploy.md

@@ -0,0 +1,37 @@
+---
+description: Deploy application to target environment
+workflow: deploy
+---
+
+# /deploy Command
+
+Deploy application to specified environment.
+
+## Usage
+
+```
+/deploy                # Deploy to default (staging)
+/deploy <env>          # Deploy to specific environment
+```
+
+## Examples
+
+```
+/deploy
+/deploy staging
+/deploy production
+```
+
+## Environments
+
+- **development**: Local docker
+- **staging**: Preview deployment
+- **production**: Live deployment
+
+## Process
+
+1. Run verification
+2. Build production bundle
+3. Push to target environment
+4. Run health checks
+5. Report status

package/.agent/commands/design.md

@@ -0,0 +1,29 @@
+---
+description: Design UI/UX components
+---
+
+# /design Command
+
+Create UI/UX design specifications.
+
+## Usage
+
+```
+/design <component>
+```
+
+## Examples
+
+```
+/design dashboard layout
+/design login form
+/design navigation menu
+```
+
+## Output
+
+- Component structure
+- Styling recommendations
+- Accessibility notes
+- Responsive breakpoints
+- Animation specs

package/.agent/commands/doc.md

@@ -0,0 +1,30 @@
+---
+description: Generate or update documentation
+---
+
+# /doc Command
+
+Create comprehensive documentation for code.
+
+## Usage
+
+```
+/doc <path>            # Document file or directory
+/doc api               # Generate API documentation
+/doc readme            # Update README
+```
+
+## Examples
+
+```
+/doc src/services/user.service.ts
+/doc Create API reference for orders module
+/doc Update README with installation steps
+```
+
+## Output
+
+- JSDoc comments added
+- README sections generated
+- API reference documentation
+- Usage examples

package/.agent/commands/eval.md

@@ -0,0 +1,30 @@
+---
+description: Run evaluation metrics on performance
+---
+
+# /eval Command
+
+Evaluate and measure performance metrics.
+
+## Usage
+
+```
+/eval                  # Full evaluation
+/eval <metric>         # Specific metric
+```
+
+## Examples
+
+```
+/eval
+/eval code quality
+/eval test coverage
+```
+
+## Metrics
+
+- Code coverage
+- Cyclomatic complexity
+- Bundle size
+- Response times
+- Quality score

package/.agent/commands/fix.md

@@ -0,0 +1,32 @@
+---
+description: Fix linting, type errors, or compilation issues
+---
+
+# /fix Command
+
+Automatically identify and fix code quality issues.
+
+## Usage
+
+```
+/fix                    # Fix current file
+/fix <path>            # Fix specific file or directory
+/fix lint              # Fix linting errors
+/fix types             # Fix TypeScript errors
+```
+
+## Examples
+
+```
+/fix src/services/
+/fix ESLint errors in utils
+/fix TypeScript errors in api module
+```
+
+## Process
+
+1. Run diagnostic tools
+2. Identify issues
+3. Apply automatic fixes
+4. Manual fixes for remaining issues
+5. Verify all issues resolved

package/.agent/commands/git.md

@@ -0,0 +1,32 @@
+---
+description: Git operations and commit management
+---
+
+# /git Command
+
+Execute Git operations with best practices.
+
+## Usage
+
+```
+/git status            # Show repository status
+/git commit "<msg>"    # Commit with conventional message
+/git branch <name>     # Create feature branch
+/git sync              # Fetch and rebase on main
+```
+
+## Examples
+
+```
+/git commit "feat(auth): add JWT refresh token"
+/git branch feature/ABC-123-user-profile
+/git sync
+```
+
+## Commit Message Format
+
+```
+<type>(<scope>): <description>
+
+Types: feat, fix, docs, style, refactor, test, chore
+```

package/.agent/commands/help.md

@@ -0,0 +1,273 @@
+---
+description: Comprehensive reference for all Devran AI Kit capabilities
+---
+
+# /help Command
+
+Your complete guide to the Devran AI Kit. Type `/help` for a quick overview, or drill down into specific categories.
+
+## Usage
+
+```
+/help                  # Quick overview of all capabilities
+/help commands         # All 37 slash commands with descriptions
+/help workflows        # All 21 workflows with descriptions
+/help agents           # All 23 AI agents with domains
+/help skills           # All 34 skill modules
+/help rules            # Governance rules
+/help checklists       # Quality gate checklists
+/help cli              # Terminal CLI commands (kit)
+/help <command-name>   # Detail on a specific command (e.g., /help plan)
+```
+
+---
+
+## Quick Overview
+
+**Devran AI Kit v4.1.0** — Trust-Grade AI Development Framework
+
+| Category | Count | Description |
+|:---------|:------|:------------|
+| ⌨️ Commands | 37 | Slash commands for every development task |
+| 🔄 Workflows | 21 | Multi-step development lifecycles |
+| 🤖 Agents | 20 | Specialized AI roles for delegation |
+| 🛠️ Skills | 34 | Domain knowledge modules |
+| ⚖️ Rules | 9 | Modular governance constraints |
+| ✅ Checklists | 4 | Quality gate checklists |
+| ⚙️ Runtime | 29 | Engine modules (governance, reputation, self-healing) |
+
+### Getting Started
+
+```
+/status           → Check your session and project health
+/plan             → Create an implementation plan
+/create           → Build a new feature from scratch
+/review           → Run quality gates before committing
+```
+
+### Recommended Workflow
+
+```
+/brainstorm  →  /plan  →  /create  →  /test  →  /review  →  /deploy
+```
+
+---
+
+## Commands (37)
+
+### Core Workflow
+
+| Command | Description |
+|:--------|:------------|
+| `/plan` | Create structured implementation plan with task breakdown |
+| `/implement` | Execute an approved plan step by step |
+| `/verify` | Run all quality gates (lint, types, tests, security, build) |
+| `/status` | Check project health, session state, and capabilities |
+
+### Feature Development
+
+| Command | Description |
+|:--------|:------------|
+| `/build` | Build a new feature from scratch |
+| `/fix` | Fix linting, type, or build errors |
+| `/debug` | Systematic debugging with hypothesis tracking |
+| `/refactor` | Improve code quality without changing behavior |
+| `/cook` | Full scratch-to-done workflow (plan → build → test → review) |
+| `/design` | UI/UX design specifications and mockups |
+
+### Testing & Quality
+
+| Command | Description |
+|:--------|:------------|
+| `/tdd` | Test-driven development — write tests first, then implement |
+| `/code-review` | Comprehensive code review with security analysis |
+| `/security-scan` | Security audit and vulnerability scan |
+| `/perf` | Performance analysis and optimization |
+| `/eval` | Evaluate metrics and measure quality |
+
+### Documentation & Git
+
+| Command | Description |
+|:--------|:------------|
+| `/doc` | Generate or update documentation |
+| `/adr` | Create Architecture Decision Record |
+| `/changelog` | Generate changelog from commits |
+| `/git` | Git operations with best practices |
+| `/pr` | Create production-grade pull requests |
+| `/pr-review` | Review a pull request with senior engineering expertise |
+| `/pr-fix` | Fix PR issues based on review comments |
+| `/pr-merge` | Merge PR safely with dependency validation |
+| `/pr-split` | Split oversized PRs into focused sub-PRs |
+| `/pr-status` | Triage PRs with CI, staleness, and merge readiness |
+| `/pr-describe` | Auto-generate PR title, summary, and labels |
+| `/checkpoint` | Save progress checkpoint for session continuity |
+
+### Exploration & Research
+
+| Command | Description |
+|:--------|:------------|
+| `/scout` | Explore and understand an unfamiliar codebase |
+| `/research` | Research technologies, libraries, or solutions |
+| `/ask` | Ask questions about code, architecture, or patterns |
+
+### Infrastructure & Integration
+
+| Command | Description |
+|:--------|:------------|
+| `/integrate` | Third-party service integration |
+| `/db` | Database schema design and migrations |
+| `/deploy` | Deploy to target environment with pre-flight checks |
+| `/setup` | Configure a new project with Devran AI Kit |
+
+### Context Management
+
+| Command | Description |
+|:--------|:------------|
+| `/learn` | Extract reusable patterns from current session (PAAL cycle) |
+| `/compact` | Compress context window for long sessions |
+| `/help` | This reference — show available capabilities |
+
+---
+
+## Workflows (21)
+
+Workflows are multi-step development lifecycles. Use them with the `/` prefix.
+
+| Workflow | Description | Key Steps |
+|:---------|:------------|:----------|
+| `/brainstorm` | Structured ideation and discovery | Socratic questioning → options → decision |
+| `/create` | Build new features from scratch | Scaffold → implement → test → review |
+| `/debug` | Systematic debugging | Reproduce → hypothesize → verify → fix |
+| `/deploy` | Production deployment | Pre-flight → execute → verify → monitor |
+| `/enhance` | Iterative feature improvement | Analyze → plan → implement → validate |
+| `/orchestrate` | Multi-agent task coordination | Decompose → delegate → merge → verify |
+| `/plan` | Implementation planning | Research → design → breakdown → verify |
+| `/pr` | Production-grade PR creation | Branch validation → size guard → review → push → CI |
+| `/pr-review` | Multi-perspective PR review | Fetch → analyze → 6-perspective review → post verdict |
+| `/pr-fix` | Fix PR based on review comments | Fetch reviews → prioritize → fix → verify → push |
+| `/pr-merge` | Safe PR merge | Validate → verify prerequisites → merge → post-merge checks |
+| `/pr-split` | Split oversized PRs | Analyze → categorize → split plan → create sub-PRs |
+| `/preflight` | Production readiness audit | 10-domain assessment → scoring → verdict |
+| `/preview` | Local dev server management | Start → verify → iterate → stop |
+| `/quality-gate` | Pre-task validation protocol | Market research → gap analysis → ethics review |
+| `/retrospective` | Sprint audit and review | Metrics → findings → action items |
+| `/review` | Quality gate pipeline | Lint → types → tests → security → build |
+| `/status` | Project state overview | Session → git → health → capabilities |
+| `/test` | Systematic test writing | Strategy → write → run → coverage |
+| `/ui-ux-pro-max` | Premium UI/UX design | Style → palette → typography → implement |
+| `/upgrade` | Non-destructive framework updates | Backup → update → verify → preserve |
+
+---
+
+## Agents (20)
+
+Agents are specialized AI roles. They are automatically activated based on task context, or you can request a specific agent.
+
+| Agent | Domain |
+|:------|:-------|
+| `architect` | System design, DDD, Hexagonal Architecture |
+| `backend-specialist` | Node.js, NestJS, API design |
+| `build-error-resolver` | Rapid build/compile error fixes |
+| `code-reviewer` | Quality + security code review |
+| `database-architect` | Schema design, queries, optimization |
+| `devops-engineer` | CI/CD, Docker, deployment pipelines |
+| `doc-updater` | Documentation synchronization |
+| `e2e-runner` | End-to-end test execution |
+| `explorer-agent` | Codebase discovery and mapping |
+| `frontend-specialist` | React, Next.js, UI architecture |
+| `knowledge-agent` | RAG retrieval and context lookup |
+| `mobile-developer` | React Native, Expo mobile development |
+| `performance-optimizer` | Core Web Vitals, profiling, optimization |
+| `planner` | Task breakdown, Socratic analysis |
+| `pr-reviewer` | PR review, branch strategy, code quality |
+| `refactor-cleaner` | Dead code cleanup, code improvement |
+| `reliability-engineer` | SRE, production readiness, SLA monitoring |
+| `security-reviewer` | Vulnerability analysis, OWASP compliance |
+| `sprint-orchestrator` | Sprint planning, velocity tracking |
+| `tdd-guide` | Test-first development enforcement |
+
+---
+
+## Skills (34)
+
+Skills are domain knowledge modules that agents use. They are loaded automatically based on task context.
+
+| Category | Skills |
+|:---------|:-------|
+| **Architecture** | `architecture`, `api-patterns`, `clean-code`, `database-design`, `docker-patterns` |
+| **Frontend** | `frontend-patterns`, `ui-ux-pro-max`, `mobile-design`, `i18n-localization` |
+| **Backend** | `nodejs-patterns`, `typescript-expert`, `security-practices` |
+| **Testing** | `testing-patterns`, `webapp-testing`, `eval-harness` |
+| **DevOps** | `deployment-procedures`, `git-workflow`, `pr-toolkit`, `shell-conventions` |
+| **AI & Orchestration** | `intelligent-routing`, `parallel-agents`, `mcp-integration`, `context-budget`, `behavioral-modes` |
+| **Planning** | `brainstorming`, `plan-writing`, `plan-validation`, `strategic-compact`, `continuous-learning` |
+| **Performance** | `performance-profiling` |
+| **Production** | `production-readiness` |
+| **Scaffolding** | `app-builder` |
+| **Debugging** | `debugging-strategies` |
+| **Verification** | `verification-loop` |
+
+---
+
+## Rules (9)
+
+Rules are modular governance constraints that all agents must follow.
+
+| Rule | Purpose |
+|:-----|:--------|
+| `coding-style` | Naming conventions, file limits, type safety |
+| `git-workflow` | Conventional commits, atomic changes, branch strategy |
+| `security` | Secret management, input validation, OWASP |
+| `testing` | Test-first, coverage targets, test naming |
+| `documentation` | Doc hierarchy, SSOT, preservation |
+| `sprint-tracking` | ROADMAP.md as SSOT, session protocols |
+| `quality-gate` | Pre-task validation and quality standards |
+| `architecture` | System design patterns and ADR governance |
+| `agent-upgrade-policy` | Framework upgrade preservation rules |
+
+---
+
+## Checklists (4)
+
+Checklists are quality gates run at specific lifecycle moments.
+
+| Checklist | When | Key Checks |
+|:----------|:-----|:-----------|
+| `session-start` | Beginning of each session | Read context, verify git, check dependencies |
+| `session-end` | End of each session | Update ROADMAP, CHANGELOG, commit tracking files |
+| `pre-commit` | Before git commit | Tests pass, lint clean, no secrets, build succeeds |
+| `task-complete` | After task completion | Verification, documentation, cleanup |
+
+---
+
+## CLI Commands (kit)
+
+Terminal commands available after installing the kit:
+
+| Command | Description |
+|:--------|:------------|
+| `kit init` | Install .agent/ into your project |
+| `kit status` | Show project health dashboard |
+| `kit verify` | Run manifest integrity checks (90 checks) |
+| `kit scan` | Enhanced security scanning |
+| `kit update` | Update to latest version (diff-based, preserves customizations) |
+| `kit heal` | Detect and diagnose CI failures |
+| `kit plugin list` | List installed plugins |
+| `kit plugin install <path>` | Install a plugin |
+| `kit plugin remove <name>` | Remove a plugin |
+| `kit market search <query>` | Search marketplace plugins |
+| `kit market info <name>` | Get marketplace plugin details |
+| `kit market install <name>` | Install from marketplace |
+
+---
+
+## Quick Reference Card
+
+```
+Start here:        /status → /plan → /create → /review
+Debug issues:      /debug → /fix → /verify
+Write tests:       /tdd → /test → /verify
+Deploy:            /review → /deploy
+Learn more:        /help <topic>
+Terminal:          kit verify | kit scan | kit status
+```

package/.agent/commands/implement.md

@@ -0,0 +1,30 @@
+---
+description: Implement a feature based on an approved plan
+---
+
+# /implement Command
+
+Execute implementation based on a defined plan.
+
+## Usage
+
+```
+/implement             # Implement current plan
+/implement <task>      # Implement specific task
+```
+
+## Examples
+
+```
+/implement
+/implement user registration
+/implement Add validation to forms
+```
+
+## Process
+
+1. Load plan.md
+2. Check prerequisites
+3. Implement each task
+4. Mark tasks complete
+5. Run verification