@devran-ai/kit 4.1.0

package/.agent/skills/docker-patterns/SKILL.md

@@ -0,0 +1,161 @@
+---
+name: docker-patterns
+description: Docker and containerization best practices
+triggers: [context, docker, container, devops]
+---
+
+# Docker Patterns Skill
+
+> **Purpose**: Apply Docker best practices for containerization
+
+---
+
+## Overview
+
+This skill provides patterns for building efficient, secure Docker images and orchestrating containers.
+
+---
+
+## Dockerfile Best Practices
+
+### Multi-Stage Build
+
+```dockerfile
+# Build stage
+FROM node:20-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+# Production stage
+FROM node:20-alpine AS production
+WORKDIR /app
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/package.json ./
+USER node
+EXPOSE 3000
+CMD ["node", "dist/main.js"]
+```
+
+### Layer Optimization
+
+```dockerfile
+# ❌ Bad - cache invalidated on any file change
+COPY . .
+RUN npm install
+
+# ✅ Good - dependencies cached separately
+COPY package*.json ./
+RUN npm ci
+COPY . .
+```
+
+---
+
+## Security
+
+### Non-Root User
+
+```dockerfile
+# Create non-root user
+RUN addgroup -S appgroup && adduser -S appuser -G appgroup
+USER appuser
+```
+
+### Minimal Base Image
+
+```dockerfile
+# ✅ Use alpine variants
+FROM node:20-alpine
+
+# ✅ Or distroless
+FROM gcr.io/distroless/nodejs20-debian12
+```
+
+---
+
+## Docker Compose
+
+### Development Setup
+
+```yaml
+version: "3.8"
+
+services:
+  app:
+    build:
+      context: .
+      target: development
+    volumes:
+      - .:/app
+      - /app/node_modules
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=development
+    depends_on:
+      - db
+      - redis
+
+  db:
+    image: postgres:16-alpine
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    environment:
+      POSTGRES_USER: user
+      POSTGRES_PASSWORD: password
+      POSTGRES_DB: app_dev
+    ports:
+      - "5432:5432"
+
+  redis:
+    image: redis:7-alpine
+    ports:
+      - "6379:6379"
+
+volumes:
+  postgres_data:
+```
+
+---
+
+## Health Checks
+
+```dockerfile
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+  CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
+```
+
+---
+
+## .dockerignore
+
+```
+node_modules
+npm-debug.log
+.git
+.env
+.env.*
+dist
+coverage
+.DS_Store
+*.md
+!README.md
+```
+
+---
+
+## Quick Reference
+
+| Pattern       | Purpose           |
+| :------------ | :---------------- |
+| Multi-stage   | Smaller images    |
+| Alpine base   | Minimal footprint |
+| Non-root user | Security          |
+| Layer caching | Faster builds     |
+| Health checks | Orchestration     |
+| .dockerignore | Exclude files     |
+| Compose       | Local development |

package/.agent/skills/eval-harness/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: eval-harness
+description: Evaluation framework for measuring agent performance
+triggers: [manual]
+---
+
+# Eval Harness Skill
+
+> **Purpose**: Measure and improve agent performance through structured evaluation
+
+---
+
+## Overview
+
+This skill provides a framework for evaluating agent performance across key dimensions.
+
+---
+
+## Evaluation Dimensions
+
+### 1. Accuracy
+
+- Did the solution work correctly?
+- Were there any bugs introduced?
+- Was the approach optimal?
+
+### 2. Efficiency
+
+- How many iterations were needed?
+- Was context used efficiently?
+- Were there unnecessary steps?
+
+### 3. Alignment
+
+- Were operating constraints followed?
+- Were user preferences respected?
+- Was the solution appropriate?
+
+### 4. Quality
+
+- Does code meet standards?
+- Is it well-tested?
+- Is it maintainable?
+
+---
+
+## Evaluation Metrics
+
+| Metric                  | Target |
+| :---------------------- | :----- |
+| First-time success rate | >80%   |
+| Iterations to solution  | <3     |
+| Test coverage           | >80%   |
+| Build success           | 100%   |
+
+---
+
+## Report Format
+
+```markdown
+# Evaluation Report
+
+## Session: [ID]
+
+## Task: [Description]
+
+### Metrics
+
+| Dimension  | Score | Notes               |
+| :--------- | :---- | :------------------ |
+| Accuracy   | 9/10  | Minor fix needed    |
+| Efficiency | 8/10  | 2 iterations        |
+| Alignment  | 10/10 | All constraints met |
+| Quality    | 9/10  | Good coverage       |
+
+### Overall: 36/40 (90%)
+
+### Learnings
+
+- [What went well]
+- [What could improve]
+```
+
+---
+
+## Integration
+
+- Run at session end for learning
+- Use for continuous improvement

package/.agent/skills/frontend-patterns/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: frontend-patterns
+description: Frontend development patterns for React and modern frameworks
+triggers: [context, frontend, react, component, ui]
+---
+
+# Frontend Patterns Skill
+
+> **Purpose**: Apply modern frontend development patterns
+
+---
+
+## Overview
+
+This skill provides best practices for building maintainable, performant frontend applications.
+
+---
+
+## Component Architecture
+
+### Atomic Design
+
+```
+atoms/          → Button, Input, Label
+molecules/      → FormField, SearchInput
+organisms/      → LoginForm, Header
+templates/      → PageLayout, DashboardLayout
+pages/          → LoginPage, DashboardPage
+```
+
+### Feature-Based Structure
+
+```
+src/
+├── features/
+│   ├── auth/
+│   │   ├── components/
+│   │   ├── hooks/
+│   │   ├── api/
+│   │   └── index.ts
+│   └── dashboard/
+│       ├── components/
+│       ├── hooks/
+│       └── index.ts
+├── shared/
+│   ├── components/
+│   ├── hooks/
+│   └── utils/
+└── App.tsx
+```
+
+---
+
+## React Patterns
+
+### Custom Hooks
+
+```tsx
+function useLocalStorage<T>(key: string, initialValue: T) {
+  const [value, setValue] = useState<T>(() => {
+    const stored = localStorage.getItem(key);
+    return stored ? JSON.parse(stored) : initialValue;
+  });
+
+  useEffect(() => {
+    localStorage.setItem(key, JSON.stringify(value));
+  }, [key, value]);
+
+  return [value, setValue] as const;
+}
+```
+
+### Compound Components
+
+```tsx
+<Select value={selected} onChange={setSelected}>
+  <Select.Trigger>Choose option</Select.Trigger>
+  <Select.Options>
+    <Select.Option value="a">Option A</Select.Option>
+    <Select.Option value="b">Option B</Select.Option>
+  </Select.Options>
+</Select>
+```
+
+### Render Props
+
+```tsx
+<DataFetcher url="/api/users">
+  {({ data, loading, error }) =>
+    loading ? <Spinner /> : <UserList users={data} />
+  }
+</DataFetcher>
+```
+
+---
+
+## State Management
+
+| Solution    | Use Case              |
+| :---------- | :-------------------- |
+| useState    | Local component state |
+| useReducer  | Complex local state   |
+| Context     | Theme, auth, i18n     |
+| Zustand     | Simple global state   |
+| Redux       | Complex global state  |
+| React Query | Server state          |
+
+---
+
+## Performance
+
+### Memoization
+
+```tsx
+// Expensive calculation
+const sortedItems = useMemo(
+  () => items.sort((a, b) => a.name.localeCompare(b.name)),
+  [items],
+);
+
+// Callback stability
+const handleClick = useCallback(() => {
+  onClick(id);
+}, [id, onClick]);
+
+// Component memoization
+const UserCard = memo(({ user }) => <div>{user.name}</div>);
+```
+
+---
+
+## Quick Reference
+
+| Pattern      | Usage                  |
+| :----------- | :--------------------- |
+| Custom Hooks | Reusable logic         |
+| Compound     | Flexible APIs          |
+| Render Props | Dynamic rendering      |
+| HOC          | Cross-cutting concerns |
+| Context      | Global state           |
+| Memoization  | Performance            |

package/.agent/skills/git-workflow/SKILL.md

@@ -0,0 +1,159 @@
+---
+name: git-workflow
+description: Git workflow patterns and best practices
+triggers: [context, git, commit, branch, pr]
+---
+
+# Git Workflow Skill
+
+> **Purpose**: Apply professional Git workflows and conventions
+
+---
+
+## Overview
+
+This skill provides Git workflow patterns for professional software development teams.
+
+---
+
+## Branch Strategy
+
+### GitFlow
+
+```
+main         ──●────────────────●──────────●──→
+              ↑                  ↑
+release    ──●─┘               ●─┘
+              ↑                ↑
+develop   ──●──●──●──●──●──●──●──●──●──→
+             ↑     ↑
+feature   ───●─────●
+```
+
+### Trunk-Based
+
+```
+main      ──●──●──●──●──●──●──●──●──→
+             ↑     ↑
+short     ───●     ●  (< 1 day)
+feature
+```
+
+---
+
+## Branch Naming
+
+```
+feature/ABC-123-add-user-auth
+bugfix/ABC-456-fix-login-error
+hotfix/ABC-789-critical-security-patch
+release/v1.2.0
+chore/update-dependencies
+```
+
+---
+
+## Conventional Commits
+
+### Format
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### Types
+
+| Type       | Usage            |
+| :--------- | :--------------- |
+| `feat`     | New feature      |
+| `fix`      | Bug fix          |
+| `docs`     | Documentation    |
+| `style`    | Formatting       |
+| `refactor` | Code restructure |
+| `test`     | Adding tests     |
+| `chore`    | Maintenance      |
+| `perf`     | Performance      |
+| `ci`       | CI/CD changes    |
+
+### Examples
+
+```bash
+feat(auth): add JWT refresh token support
+
+fix(api): handle null user in profile endpoint
+
+Closes #123
+
+docs(readme): add installation instructions
+
+chore(deps): update dependencies to latest versions
+```
+
+---
+
+## Pull Request Template
+
+```markdown
+## Description
+
+Brief description of changes
+
+## Type of Change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change
+- [ ] Documentation update
+
+## Checklist
+
+- [ ] Tests pass locally
+- [ ] Code follows style guidelines
+- [ ] Self-reviewed my code
+- [ ] Added necessary documentation
+- [ ] No new warnings
+
+## Testing
+
+How to test these changes
+```
+
+---
+
+## Common Commands
+
+```bash
+# Create feature branch
+git checkout -b feature/ABC-123-new-feature
+
+# Stage and commit
+git add -p                    # Interactive staging
+git commit -m "feat: add..."
+
+# Rebase on main
+git fetch origin
+git rebase origin/main
+
+# Squash commits
+git rebase -i HEAD~3
+
+# Push feature branch
+git push origin feature/ABC-123-new-feature
+```
+
+---
+
+## Quick Reference
+
+| Command                 | Usage                |
+| :---------------------- | :------------------- |
+| `git log --oneline -10` | Recent commits       |
+| `git diff --staged`     | Staged changes       |
+| `git stash`             | Temporary storage    |
+| `git cherry-pick <sha>` | Pick specific commit |
+| `git bisect`            | Find bad commit      |
+| `git reflog`            | Recovery tool        |