@malamute/ai-rules 1.0.0 → 1.2.0

package/configs/_shared/.claude/skills/infra/deploy/SKILL.md

@@ -0,0 +1,139 @@
+---
+name: deploy
+description: Generate deployment configuration and CI/CD pipelines
+argument-hint: "<target> [--provider <name>]"
+---
+
+# Deployment Configuration Generator
+
+Generate deployment configurations for various platforms.
+
+## Usage
+
+- `/deploy github-actions` - GitHub Actions workflow
+- `/deploy docker` - Docker + docker-compose production setup
+- `/deploy kubernetes` - Kubernetes manifests
+- `/deploy vercel` - Vercel configuration
+- `/deploy aws` - AWS (ECS/Lambda) configuration
+- `/deploy --provider azure` - Azure-specific setup
+
+## Behavior
+
+1. **Analyze Project**
+   - Detect framework and runtime
+   - Identify build commands
+   - Find environment variables needed
+   - Check for database/cache dependencies
+
+2. **Generate Configuration**
+   - CI/CD pipeline files
+   - Infrastructure configuration
+   - Environment templates
+   - Deployment scripts
+
+## Targets
+
+### `github-actions`
+
+Generate `.github/workflows/` files:
+
+| Workflow | Trigger | Actions |
+|----------|---------|---------|
+| ci.yml | PR, push | Lint, test, build |
+| deploy.yml | push to main | Build, push, deploy |
+| release.yml | tag | Create release, changelog |
+
+**Output files:**
+- `.github/workflows/ci.yml`
+- `.github/workflows/deploy.yml`
+- `.github/workflows/release.yml`
+
+### `docker`
+
+Generate production Docker setup:
+- Multi-stage `Dockerfile`
+- `docker-compose.prod.yml`
+- `docker-compose.override.yml` (dev)
+- `.dockerignore`
+- `scripts/deploy.sh`
+
+### `kubernetes`
+
+Generate K8s manifests:
+- `k8s/deployment.yaml`
+- `k8s/service.yaml`
+- `k8s/ingress.yaml`
+- `k8s/configmap.yaml`
+- `k8s/secrets.yaml` (template)
+- `k8s/hpa.yaml` (autoscaling)
+- `kustomization.yaml`
+
+### `vercel`
+
+Generate Vercel config:
+- `vercel.json`
+- Environment variable setup guide
+- Build configuration
+
+### `aws`
+
+Generate AWS config:
+
+**For ECS:**
+- `ecs/task-definition.json`
+- `ecs/service.json`
+- `buildspec.yml` (CodeBuild)
+- `appspec.yml` (CodeDeploy)
+
+**For Lambda:**
+- `serverless.yml` or `sam/template.yaml`
+- Lambda handler wrapper
+
+## Output Format
+
+```
+## Deployment Configuration
+
+### Target: GitHub Actions + Docker + Kubernetes
+
+## Files Created
+
+### .github/workflows/deploy.yml
+<workflow content>
+
+### k8s/deployment.yaml
+<k8s manifest>
+
+### k8s/service.yaml
+<k8s manifest>
+
+## Environment Variables Required
+
+| Variable | Description | Example |
+|----------|-------------|---------|
+| DATABASE_URL | PostgreSQL connection | postgresql://... |
+| REDIS_URL | Redis connection | redis://... |
+| SECRET_KEY | Application secret | <random> |
+
+## Deployment Steps
+
+1. Configure secrets in GitHub/provider
+2. Push to main branch
+3. Monitor deployment
+4. Verify health checks
+
+## Rollback
+
+To rollback: `kubectl rollout undo deployment/myapp`
+```
+
+## Best Practices Included
+
+- Health checks and readiness probes
+- Resource limits and requests
+- Horizontal pod autoscaling
+- Rolling update strategy
+- Secret management (never in code)
+- Environment-specific configurations
+- Monitoring and logging setup
+- SSL/TLS configuration

package/configs/_shared/.claude/skills/infra/docker/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: docker
+description: Generate Dockerfile and docker-compose configuration for the project
+argument-hint: "[service-name]"
+---
+
+# Docker Configuration Generator
+
+Generate production-ready Docker configuration for the current project.
+
+## Behavior
+
+1. **Detect Project Type**
+   - Check for `package.json` → Node.js/Next.js/NestJS
+   - Check for `requirements.txt` / `pyproject.toml` → Python/FastAPI/Django
+   - Check for `*.csproj` / `*.sln` → .NET
+
+2. **Analyze Dependencies**
+   - Database requirements (PostgreSQL, MySQL, MongoDB, Redis)
+   - Message queues (RabbitMQ, Kafka)
+   - Cache layers (Redis, Memcached)
+   - Storage requirements
+
+3. **Generate Configuration**
+   - Create multi-stage `Dockerfile` with:
+     - Build stage with dev dependencies
+     - Production stage with minimal footprint
+     - Non-root user
+     - Health checks
+     - Proper caching of layers
+   - Create `docker-compose.yml` with:
+     - Application service
+     - Required infrastructure services
+     - Volume mounts for persistence
+     - Network configuration
+     - Health checks and dependencies
+   - Create `.dockerignore` if not present
+
+4. **Optional: Generate for specific service**
+   - If service name provided (e.g., `/docker worker`), generate worker-specific config
+
+## Output Format
+
+```
+## Dockerfile
+
+<dockerfile content>
+
+## docker-compose.yml
+
+<compose content>
+
+## .dockerignore
+
+<ignore patterns>
+
+## Commands
+
+- Build: `docker compose build`
+- Start: `docker compose up -d`
+- Logs: `docker compose logs -f`
+- Stop: `docker compose down`
+```
+
+## Framework-Specific Requirements
+
+### Node.js / Next.js
+- Use `node:20-alpine` base
+- Copy `package*.json` first for layer caching
+- Use `npm ci --only=production`
+- Set `NODE_ENV=production`
+
+### Python / FastAPI
+- Use `python:3.12-slim` base
+- Install only production requirements
+- Use `gunicorn` + `uvicorn` workers
+- Set `PYTHONDONTWRITEBYTECODE=1`
+
+### .NET
+- Use `mcr.microsoft.com/dotnet/aspnet:8.0` runtime
+- Build with `mcr.microsoft.com/dotnet/sdk:8.0`
+- Publish as self-contained if needed
+
+### NestJS
+- Similar to Node.js
+- Include Prisma generation if detected
+- Handle migrations in entrypoint
+
+## Security Considerations
+
+- Never include secrets in Dockerfile
+- Use `.dockerignore` to exclude sensitive files
+- Run as non-root user
+- Pin base image versions
+- Scan for vulnerabilities recommendation

package/configs/_shared/.claude/skills/infra/migration/SKILL.md

@@ -0,0 +1,158 @@
+---
+name: migration
+description: Generate and manage database migrations
+argument-hint: "<action> [name]"
+---
+
+# Database Migration Manager
+
+Generate and manage database migrations across different ORMs.
+
+## Usage
+
+- `/migration create add_users_table` - Create new migration
+- `/migration status` - Show migration status
+- `/migration up` - Apply pending migrations
+- `/migration down` - Rollback last migration
+- `/migration reset` - Reset database (dev only)
+
+## Behavior
+
+1. **Detect ORM/Migration Tool**
+   - Prisma → `prisma migrate`
+   - TypeORM → TypeORM migrations
+   - Drizzle → Drizzle Kit
+   - Alembic → Alembic migrations
+   - EF Core → Entity Framework migrations
+   - Django → Django migrations
+
+2. **Create Migration**
+
+### Prisma
+```bash
+npx prisma migrate dev --name <name>
+```
+
+### Alembic
+```bash
+alembic revision --autogenerate -m "<name>"
+```
+
+### EF Core
+```bash
+dotnet ef migrations add <name>
+```
+
+3. **Migration File Template**
+
+Generate migration with:
+- Descriptive name with timestamp
+- Up migration (forward)
+- Down migration (rollback)
+- Safe operations (transactions where supported)
+
+## Actions
+
+### `create <name>`
+
+1. Analyze schema changes (if ORM detected)
+2. Generate migration file
+3. Show what will be migrated
+
+**Output:**
+```
+## Migration Created
+
+File: migrations/20240115_add_users_table.ts
+
+### Changes Detected
+- CREATE TABLE users (id, email, name, created_at)
+- CREATE INDEX ix_users_email ON users(email)
+
+### Commands
+- Apply: npm run migrate
+- Rollback: npm run migrate:down
+```
+
+### `status`
+
+Show current migration status:
+```
+## Migration Status
+
+Applied:
+✓ 20240110_initial
+✓ 20240112_add_posts
+
+Pending:
+○ 20240115_add_comments
+
+Current: 20240112_add_posts
+```
+
+### `up`
+
+Apply pending migrations with safety checks:
+1. Backup reminder for production
+2. Show what will be applied
+3. Confirm before applying
+4. Run migrations
+5. Verify success
+
+### `down`
+
+Rollback with safety:
+1. Show what will be rolled back
+2. Warn about data loss
+3. Confirm before rolling back
+4. Run rollback
+5. Verify success
+
+## Common Migration Patterns
+
+### Add Column (Nullable First)
+```sql
+-- Up
+ALTER TABLE users ADD COLUMN phone VARCHAR(20);
+
+-- Down
+ALTER TABLE users DROP COLUMN phone;
+```
+
+### Add Column (Non-Nullable)
+```sql
+-- Up
+ALTER TABLE users ADD COLUMN role VARCHAR(20);
+UPDATE users SET role = 'user' WHERE role IS NULL;
+ALTER TABLE users ALTER COLUMN role SET NOT NULL;
+
+-- Down
+ALTER TABLE users DROP COLUMN role;
+```
+
+### Rename Column
+```sql
+-- Up
+ALTER TABLE users RENAME COLUMN name TO full_name;
+
+-- Down
+ALTER TABLE users RENAME COLUMN full_name TO name;
+```
+
+### Add Index
+```sql
+-- Up
+CREATE INDEX CONCURRENTLY ix_users_email ON users(email);
+
+-- Down
+DROP INDEX ix_users_email;
+```
+
+## Safety Guidelines
+
+- Always provide rollback path
+- Use `CONCURRENTLY` for index creation (PostgreSQL)
+- Avoid locks on large tables
+- Split large data migrations into batches
+- Test migrations on copy of production data
+- Never modify applied migrations

package/configs/_shared/.claude/skills/nx/nx-affected/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: nx-affected
+description: Run Nx affected commands to test/build/lint only changed projects
+argument-hint: [test|build|lint|e2e] (optional, defaults to test)
+---
+
+# Nx Affected Analysis
+
+Analyze and run commands only on affected projects based on git changes.
+
+## Behavior
+
+1. **Determine base branch**
+   ```bash
+   # Check if main or master
+   git rev-parse --verify main 2>/dev/null && echo "main" || echo "master"
+   ```
+
+2. **Show affected projects**
+   ```bash
+   nx show projects --affected --base=<base> --head=HEAD
+   ```
+
+3. **Visualize dependencies** (optional)
+   ```bash
+   nx affected:graph --base=<base> --head=HEAD
+   ```
+
+4. **Run the requested target**
+
+   Based on argument (default: `test`):
+
+   | Argument | Command |
+   |----------|---------|
+   | `test` | `nx affected -t test --base=<base> --head=HEAD` |
+   | `build` | `nx affected -t build --base=<base> --head=HEAD` |
+   | `lint` | `nx affected -t lint --base=<base> --head=HEAD` |
+   | `e2e` | `nx affected -t e2e --base=<base> --head=HEAD` |
+   | `all` | Run test, lint, build sequentially |
+
+## Output Format
+
+```
+## Affected Projects
+
+Based on changes from `main`:
+
+- `users-feature-list` (3 files changed)
+- `users-data-access` (1 file changed)
+- `shared-ui-button` (2 files changed)
+
+## Running: nx affected -t test
+
+✓ users-feature-list (2.3s)
+✓ users-data-access (1.1s)
+✓ shared-ui-button (0.8s)
+
+All 3 affected projects passed.
+```
+
+## CI Usage Hint
+
+Suggest adding to CI if not present:
+
+```yaml
+# .github/workflows/ci.yml
+- name: Test affected
+  run: nx affected -t test --base=origin/main --head=HEAD
+
+- name: Build affected
+  run: nx affected -t build --base=origin/main --head=HEAD
+```