Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .agent/agents/database-architect.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ name: database-architect
description: Expert database architect for schema design, query optimization, migrations, and modern serverless databases. Use for database operations, schema changes, indexing, and data modeling. Triggers on database, sql, schema, migration, query, postgres, index, table.
tools: Read, Grep, Glob, Bash, Edit, Write
model: inherit
skills: clean-code, database-design
skills: clean-code, database-design, prisma-expert
---

# Database Architect
Expand Down
2 changes: 1 addition & 1 deletion .agent/agents/devops-engineer.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ name: devops-engineer
description: Expert in deployment, server management, CI/CD, and production operations. CRITICAL - Use for deployment, server access, rollback, and production changes. HIGH RISK operations. Triggers on deploy, production, server, pm2, ssh, release, rollback, ci/cd.
tools: Read, Grep, Glob, Bash, Edit, Write
model: inherit
skills: clean-code, deployment-procedures, server-management, powershell-windows, bash-linux
skills: clean-code, deployment-procedures, docker-expert, server-management, powershell-windows, bash-linux
---

# DevOps Engineer
Expand Down
30 changes: 30 additions & 0 deletions .agent/skills/docker-expert/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
---
name: docker-expert
description: Docker and containerization expertise for reliable builds, secure images, and efficient deployment pipelines.
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
---

# Docker Expert

Use this skill for Dockerfiles, image optimization, container runtime hardening, and CI/CD image workflows.

## Core Rules

1. Use multi-stage builds to keep runtime images small.
2. Pin base image major versions and keep them updated.
3. Run as non-root in production containers.
4. Copy only required files and use `.dockerignore` aggressively.

## Build and Security Checklist

- Keep dependency install layers cache-friendly.
- Avoid baking secrets into image layers.
- Set explicit `NODE_ENV=production` (or equivalent runtime env).
- Expose only required ports.
- Validate startup command and health behavior for orchestrators.

## Performance Practices

- Minimize context size and invalidating layers.
- Cache dependency installs by copying lockfiles first.
- Keep runtime stage free of build tooling and source artifacts.
31 changes: 31 additions & 0 deletions .agent/skills/prisma-expert/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
name: prisma-expert
description: Prisma ORM expertise for schema design, migrations, query performance, and production-safe database changes.
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
---

# Prisma Expert

Use this skill when working with Prisma models, migrations, seed scripts, or query logic.

## Core Rules

1. Prefer additive, backward-compatible schema changes.
2. Never drop or rename a column in one step on production paths.
3. Use transactions for multi-step writes that must be atomic.
4. Avoid N+1 query patterns; use `include`, `select`, and batching deliberately.

## Migration Safety Checklist

- Confirm current schema and generated SQL before applying.
- Add new columns as nullable or with safe defaults first.
- Backfill data in controlled steps.
- Enforce constraints only after backfill is complete.
- Validate rollback strategy before deployment.

## Query Practices

- Select only required fields.
- Add pagination (`take`/`skip` or cursor pagination) for list endpoints.
- Ensure indexed filters for frequent read paths.
- Use `upsert` carefully and verify unique constraints align with business rules.
31 changes: 31 additions & 0 deletions .agent/skills/refactoring-patterns/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
name: refactoring-patterns
description: Practical refactoring playbook for improving legacy code safely with tests, incremental changes, and rollback awareness.
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
---

# Refactoring Patterns

Use this skill when improving existing code structure without changing intended behavior.

## Core Rules

1. Preserve behavior first; optimize structure second.
2. Make small, reversible changes.
3. Add tests (or characterization tests) before risky edits.
4. Prefer extraction and simplification over broad rewrites.

## Safe Refactor Sequence

1. Identify behavior-critical paths and edge cases.
2. Add or expand tests to lock current behavior.
3. Apply one refactor at a time (rename, extract, isolate side effects).
4. Run tests after each step.
5. Document key design decisions and tradeoffs.

## Common Patterns

- Extract method for long functions.
- Replace nested conditionals with guard clauses.
- Introduce parameter object for long argument lists.
- Isolate side effects from pure computation.
1 change: 1 addition & 0 deletions web/src/services/agents.json
Original file line number Diff line number Diff line change
Expand Up @@ -147,6 +147,7 @@
"description": "Legacy code, refactoring",
"skills": [
"clean-code",
"refactoring-patterns",
"code-review-checklist"
]
},
Expand Down
17 changes: 16 additions & 1 deletion web/src/services/skills.json
Original file line number Diff line number Diff line change
Expand Up @@ -39,11 +39,21 @@
"description": "Schema design, optimization",
"category": "Database"
},
{
"name": "prisma-expert",
"description": "Prisma ORM patterns, migrations, and schema management",
"category": "Database"
},
{
"name": "deployment-procedures",
"description": "CI/CD, deploy workflows",
"category": "Cloud & Infrastructure"
},
{
"name": "docker-expert",
"description": "Containerization, Dockerfiles, and image optimization",
"category": "Cloud & Infrastructure"
},
{
"name": "server-management",
"description": "Infrastructure management",
Expand Down Expand Up @@ -139,6 +149,11 @@
"description": "Coding standards (Global)",
"category": "Other"
},
{
"name": "refactoring-patterns",
"description": "Safe refactoring strategies for legacy and evolving codebases",
"category": "Testing & Quality"
},
{
"name": "behavioral-modes",
"description": "Agent personas",
Expand Down Expand Up @@ -184,4 +199,4 @@
"description": "Master Rust 1.75+ with modern async patterns, advanced type system features, and production-ready systems programming.",
"category": "Backend & API"
}
]
]