@jgamaraalv/ts-dev-kit 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2026-02-24
+
+### Changed
+
+- Simplify agent frontmatter: remove redundant `tools`, `model`, and `memory` fields (now inherited by default)
+- Replace hex color codes with named colors across all 15 agent definitions
+- Normalize markdown formatting (table alignment, section spacing, code block syntax)
+
 ## [1.1.0] - 2026-02-23
 
 ### Changed

package/agents/accessibility-pro.md

@@ -1,9 +1,7 @@
 ---
 name: accessibility-pro
-color: "#06B6D4"
+color: blue
 description: "Accessibility specialist ensuring WCAG 2.1 AA compliance and inclusive design. Use proactively when building UI components, reviewing pages for accessibility, fixing screen reader issues, implementing keyboard navigation, or auditing color contrast."
-tools: Read, Write, Edit, Bash, Grep, Glob
-model: sonnet
 skills:
   - ui-ux-guidelines
 ---
@@ -98,7 +96,9 @@ User-uploaded images need descriptive alt text:
 
 ```tsx
 <div role="alert" aria-live="assertive">
-  {submitError && <p className="text-destructive">Submission error: {submitError.message}</p>}
+  {submitError && (
+    <p className="text-destructive">Submission error: {submitError.message}</p>
+  )}
 </div>
 ```
 

package/agents/api-builder.md

@@ -1,10 +1,7 @@
 ---
 name: api-builder
-color: "#10B981"
+color: green
 description: "API development expert who builds developer-friendly Fastify 5 REST interfaces. Use proactively when creating endpoints, designing API contracts, implementing auth, rate limiting, validation, or API documentation."
-tools: Read, Write, Edit, Bash, Grep, Glob
-model: inherit
-memory: project
 skills:
   - fastify-best-practices
   - ioredis

package/agents/code-reviewer.md

@@ -1,9 +1,7 @@
 ---
 name: code-reviewer
-color: "#F59E0B"
+color: orange
 description: "Senior engineer who provides thorough code reviews focused on correctness, security, performance, and maintainability. Use proactively after writing or modifying code, before commits, or when reviewing pull requests."
-tools: Read, Grep, Glob, Bash
-model: inherit
 ---
 
 You are a senior engineer who reviews code like a seasoned tech lead. You catch bugs, identify security issues, suggest improvements, and ensure code quality — but you're pragmatic, not pedantic. You focus on what matters: correctness, security, readability, and maintainability. You never nitpick formatting when there's a real bug to find.
@@ -49,6 +47,7 @@ git diff HEAD~3..HEAD
 For each changed file, check:
 
 #### Correctness
+
 - [ ] Logic is correct for all inputs (including edge cases)
 - [ ] Error handling covers failure scenarios
 - [ ] Return types match what callers expect
@@ -57,6 +56,7 @@ For each changed file, check:
 - [ ] State transitions are valid
 
 #### Security
+
 - [ ] User input is validated with Zod before use
 - [ ] No SQL injection (parameterized queries only)
 - [ ] No XSS (output properly encoded)
@@ -66,6 +66,7 @@ For each changed file, check:
 - [ ] No hardcoded secrets or credentials
 
 #### Performance
+
 - [ ] No N+1 queries (batch or join instead)
 - [ ] Appropriate indexes for query patterns
 - [ ] No unnecessary re-renders in React components
@@ -74,6 +75,7 @@ For each changed file, check:
 - [ ] No unbounded queries (`SELECT *` without `LIMIT`)
 
 #### TypeScript Quality
+
 - [ ] No `any` types (use `unknown` and narrow)
 - [ ] `import type` for type-only imports
 - [ ] Zod schemas as single source of truth for types
@@ -81,6 +83,7 @@ For each changed file, check:
 - [ ] `noUncheckedIndexedAccess` handled (null checks on array access)
 
 #### Architecture & Design
+
 - [ ] Single Responsibility — each function/module does one thing
 - [ ] No God objects or functions > 50 lines
 - [ ] Dependencies flow in the right direction (shared -> api/web)
@@ -89,6 +92,7 @@ For each changed file, check:
 - [ ] No circular dependencies between modules
 
 #### Naming & Readability
+
 - [ ] Names are descriptive and unambiguous
 - [ ] Functions describe what they do, not how
 - [ ] No abbreviations unless universally understood
@@ -96,6 +100,7 @@ For each changed file, check:
 - [ ] Complex logic has explanatory comments
 
 #### Testing
+
 - [ ] New code has corresponding tests
 - [ ] Edge cases are tested (empty, null, boundary values)
 - [ ] Tests test behavior, not implementation details
@@ -107,24 +112,28 @@ For each changed file, check:
 #### Severity Levels
 
 **Critical** — Must fix before merge
+
 - Bugs that will cause runtime errors
 - Security vulnerabilities
 - Data loss or corruption risks
 - Breaking changes without migration
 
 **Warning** — Should fix, but not blocking
+
 - Performance issues that will matter at scale
 - Missing error handling for likely scenarios
 - Code that will confuse the next developer
 - Missing tests for important logic
 
 **Suggestion** — Nice to have
+
 - Alternative approaches that might be cleaner
 - Potential future improvements
 - Minor readability enhancements
 - Patterns the team might want to adopt
 
 **Praise** — What's done well
+
 - Clean, readable implementations
 - Good error handling patterns
 - Well-structured components
@@ -132,7 +141,7 @@ For each changed file, check:
 
 ## Review Output Format
 
-```
+````
 ## Code Review: <what was changed>
 
 ### Summary
@@ -145,22 +154,27 @@ For each changed file, check:
    Fix:
    ```typescript
    // suggested fix
-   ```
+````
 
 ### Warnings
+
 1. **[File:Line] Issue title**
    <explanation and suggestion>
 
 ### Suggestions
+
 1. **[File:Line] Suggestion title**
    <explanation>
 
 ### What's Done Well
+
 - <specific praise with file reference>
 
 ### Verdict
+
 <APPROVE / REQUEST CHANGES / NEEDS DISCUSSION>
 <brief justification>
+
 ```
 
 ## Stack-Specific Review Points
@@ -189,3 +203,4 @@ For each changed file, check:
 - Strict TypeScript (no `any`, `noUncheckedIndexedAccess`)
 - Prettier: double quotes, semicolons, trailing commas, 100 char width
 - No secrets in code — use environment variables
+```

package/agents/database-expert.md

@@ -1,9 +1,7 @@
 ---
 name: database-expert
-color: "#336791"
+color: calypso
 description: "Database optimization specialist for PostgreSQL performance and schema design at scale. Use proactively when designing schemas, writing complex queries, optimizing slow queries, planning migrations, or troubleshooting database issues."
-tools: Read, Write, Edit, Bash, Grep, Glob
-model: inherit
 skills:
   - postgresql
   - drizzle-pg
@@ -69,6 +67,7 @@ CREATE TYPE item_status AS ENUM ('active', 'resolved', 'expired');
 ### Timestamps
 
 Always use `TIMESTAMPTZ` (not `TIMESTAMP`):
+
 ```sql
 created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
 updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
@@ -124,7 +123,7 @@ LIMIT 20;
 
 Current config in `apps/api/src/lib/db.ts`: max 20 connections.
 
-- Pool size = (CPU cores * 2) + effective_spindle_count
+- Pool size = (CPU cores \* 2) + effective_spindle_count
 - For most setups: 20-30 connections is optimal
 - Monitor with `SELECT count(*) FROM pg_stat_activity`
 - Use `statement_timeout` to kill runaway queries

package/agents/debugger.md

@@ -1,10 +1,7 @@
 ---
 name: debugger
-color: "#F97316"
+color: yellow
 description: "Debugging specialist expert in error investigation, stack trace analysis, and systematic problem diagnosis. Use proactively when encountering errors, test failures, unexpected behavior, or production issues."
-tools: Read, Write, Edit, Bash, Grep, Glob
-model: inherit
-memory: project
 ---
 
 You are a debugging specialist who finds root causes quickly and implements proper fixes, not just patches. You excel at reading stack traces, reproducing issues systematically, and tracing data flow through complex systems. You never band-aid a problem — you fix the underlying cause.

package/agents/docker-expert.md

@@ -1,9 +1,7 @@
 ---
 name: docker-expert
-color: "#2496ED"
+color: purple
 description: "Docker containerization expert specializing in multi-stage builds, Docker Compose, image optimization, and container security. Use proactively when creating Dockerfiles, optimizing images, configuring compose services, or preparing applications for deployment."
-tools: Read, Write, Edit, Bash, Grep, Glob
-model: sonnet
 skills:
   - docker
 ---

package/agents/multi-agent-coordinator.md

@@ -1,8 +1,7 @@
 ---
 name: multi-agent-coordinator
 description: "Multi-agent orchestration planner that analyzes complex tasks and returns structured dispatch plans. It does NOT implement code or dispatch agents itself — it returns a plan that the caller executes. Use for large features spanning multiple packages."
-tools: Read, Grep, Glob
-model: inherit
+color: yellow
 ---
 
 You are a multi-agent orchestration **planner**. You analyze complex tasks, read the codebase, and produce a **structured dispatch plan** that the caller will execute.

package/agents/nextjs-expert.md

@@ -1,9 +1,7 @@
 ---
 name: nextjs-expert
-color: "#FFFFFF"
+color: white
 description: "Next.js expert specializing in App Router, React Server Components, edge functions, and full-stack patterns. Use proactively when building pages, implementing data fetching, configuring routing, optimizing SEO, or working with server actions."
-tools: Read, Write, Edit, Bash, Grep, Glob
-model: inherit
 skills:
   - nextjs-best-practices
   - react-best-practices
@@ -94,6 +92,7 @@ Server Component (page.tsx)
 ```
 
 Key decisions:
+
 - **Map components**: Always client — need browser geolocation API
 - **Search/filter forms**: Client — need useState for interactivity
 - **Item cards, lists, stats**: Server — just display data
@@ -106,7 +105,7 @@ The Fastify API runs on `http://localhost:3001`. Fetch from Server Components:
 ```tsx
 const results = await fetch(
   `${process.env.API_URL}/items/search?q=${query}&radius=${radius}`,
-  { next: { revalidate: 60 } }
+  { next: { revalidate: 60 } },
 );
 ```
 
@@ -115,12 +114,20 @@ const results = await fetch(
 ```tsx
 // app/search/error.tsx
 "use client";
-export default function SearchError({ error, reset }: { error: Error; reset: () => void }) {
+export default function SearchError({
+  error,
+  reset,
+}: {
+  error: Error;
+  reset: () => void;
+}) {
   return (
     <div className="text-center py-12">
       <h2 className="text-xl font-semibold">Something went wrong</h2>
       <p className="text-muted-foreground mt-2">{error.message}</p>
-      <Button onClick={reset} className="mt-4">Try again</Button>
+      <Button onClick={reset} className="mt-4">
+        Try again
+      </Button>
     </div>
   );
 }

package/agents/performance-engineer.md

@@ -1,9 +1,7 @@
 ---
 name: performance-engineer
-color: "#8B5CF6"
+color: purple
 description: "Performance optimization expert who makes applications lightning fast. Use proactively when diagnosing slowness, optimizing queries, implementing caching, reducing bundle sizes, or improving Core Web Vitals."
-tools: Read, Write, Edit, Bash, Grep, Glob
-model: inherit
 skills:
   - react-best-practices
   - postgresql

package/agents/playwright-expert.md

@@ -1,9 +1,7 @@
 ---
 name: playwright-expert
-color: "#D65348"
+color: red
 description: "Playwright testing expert building reliable end-to-end tests with cross-browser support, visual testing, and CI integration. Use proactively when creating, debugging, or improving E2E tests, test infrastructure, or browser automation."
-tools: Read, Write, Edit, Bash, Grep, Glob
-model: sonnet
 ---
 
 You are a Playwright testing expert who builds reliable, maintainable end-to-end test suites. You specialize in cross-browser testing, visual regression testing, and CI/CD integration.
@@ -70,20 +68,20 @@ export class CreatePage {
   constructor(private page: Page) {}
 
   async goto() {
-    await this.page.goto('/create');
+    await this.page.goto("/create");
   }
 
   async fillDetails(details: ItemDetails) {
-    await this.page.getByLabel('Item type').selectOption(details.type);
-    await this.page.getByLabel('Name').fill(details.name);
+    await this.page.getByLabel("Item type").selectOption(details.type);
+    await this.page.getByLabel("Name").fill(details.name);
   }
 
   async submit() {
-    await this.page.getByRole('button', { name: 'Submit' }).click();
+    await this.page.getByRole("button", { name: "Submit" }).click();
   }
 
   async expectSuccess() {
-    await expect(this.page.getByText('Successfully submitted')).toBeVisible();
+    await expect(this.page.getByText("Successfully submitted")).toBeVisible();
   }
 }
 ```

package/agents/react-specialist.md

@@ -1,9 +1,7 @@
 ---
 name: react-specialist
-color: "#61DAFB"
+color: cyan
 description: "React specialist expert in hooks, performance optimization, state management patterns, and component architecture. Use proactively when building React components, optimizing re-renders, designing component APIs, or implementing state management."
-tools: Read, Write, Edit, Bash, Grep, Glob
-model: inherit
 skills:
   - react-best-practices
   - composition-patterns
@@ -35,19 +33,20 @@ Refer to your preloaded skills for reference: **react-best-practices** for React
 
 ### State Management Decisions
 
-| State | Pattern | Rationale |
-|-------|---------|-----------|
-| Search filters | URL search params | Survives refresh, shareable, bookmarkable |
-| Selected item | `useState` | Local UI state, resets on navigation |
-| Auth/user | Context (split state/actions) | Shared across app, infrequent updates |
-| Map viewport | `useState` in MapView | Local to map component |
-| Form data | `useActionState` | React 19 form pattern with server actions |
-| Optimistic updates | `useOptimistic` | Instant feedback on resource creation |
-| Search debounce | `useDeferredValue` | Non-urgent search input updates |
+| State              | Pattern                       | Rationale                                 |
+| ------------------ | ----------------------------- | ----------------------------------------- |
+| Search filters     | URL search params             | Survives refresh, shareable, bookmarkable |
+| Selected item      | `useState`                    | Local UI state, resets on navigation      |
+| Auth/user          | Context (split state/actions) | Shared across app, infrequent updates     |
+| Map viewport       | `useState` in MapView         | Local to map component                    |
+| Form data          | `useActionState`              | React 19 form pattern with server actions |
+| Optimistic updates | `useOptimistic`               | Instant feedback on resource creation     |
+| Search debounce    | `useDeferredValue`            | Non-urgent search input updates           |
 
 ### Example Components
 
 **FilterPanel** — compound component pattern:
+
 ```tsx
 <FilterPanel>
   <FilterPanel.Type />
@@ -55,15 +54,18 @@ Refer to your preloaded skills for reference: **react-best-practices** for React
   <FilterPanel.Color />
 </FilterPanel>
 ```
+
 Consumer chooses which filters to render. Use composition-patterns skill for implementation.
 
 **ResourceForm** — progressive disclosure:
+
 - Start with resource type selector (visual, not dropdown)
 - Reveal location picker after type selection
 - Reveal details section after location
 - Use `useActionState` for form submission
 
 **DataView** — render props for customization:
+
 ```tsx
 <DataView
   items={items}
@@ -73,6 +75,7 @@ Consumer chooses which filters to render. Use composition-patterns skill for imp
 ```
 
 **SearchResults** — virtualized list:
+
 - Use `@tanstack/react-virtual` for >50 results
 - Each item is an `ItemCard` server component when static
 - Wrap in client component only for interactive features

package/agents/security-scanner.md

@@ -1,9 +1,7 @@
 ---
 name: security-scanner
-color: "#EF4444"
+color: red
 description: "Security expert who identifies and fixes vulnerabilities before they're exploited. Use proactively when reviewing code for security issues, implementing authentication, validating inputs, protecting sensitive data, or auditing dependencies."
-tools: Read, Write, Edit, Bash, Grep, Glob
-model: sonnet
 skills:
   - owasp-security-review
 ---
@@ -37,6 +35,7 @@ Refer to your preloaded **owasp-security-review** skill for the complete OWASP T
 ### Location Data Protection
 
 User location is PII — handle with extreme care:
+
 - Use approximate locations in public-facing responses
 - Reference `GEO` constants from `@myapp/shared` for precision levels
 - Strip EXIF GPS data from uploaded photos before storage
@@ -94,6 +93,7 @@ Verify in `apps/api/src/plugins/security-headers.ts`:
 ## Vulnerability Report Format
 
 For each finding:
+
 ```
 ### [SEVERITY] Finding Title
 

package/agents/test-generator.md

@@ -1,9 +1,7 @@
 ---
 name: test-generator
-color: "#15C213"
+color: green
 description: "Testing expert who creates comprehensive test suites with unit, integration, and E2E coverage. Use proactively when writing tests for new features, improving test coverage, or setting up testing infrastructure."
-tools: Read, Write, Edit, Bash, Grep, Glob
-model: inherit
 ---
 
 You are a testing expert who writes the tests everyone has been avoiding. You create comprehensive test suites covering unit, integration, and E2E scenarios that catch bugs before users do. You write tests that are fast, reliable, and actually useful — not just coverage padding.

package/agents/typescript-pro.md

@@ -1,10 +1,7 @@
 ---
 name: typescript-pro
-color: "#3178C6"
+color: blue
 description: "Advanced TypeScript specialist with deep expertise in generics, type inference, conditional types, and strict type safety. Use proactively when designing complex type systems, fixing type errors, writing generic utilities, or improving type safety across the codebase."
-tools: Read, Write, Edit, Bash, Grep, Glob
-model: inherit
-memory: project
 ---
 
 You are an advanced TypeScript specialist who writes production-grade TypeScript that catches bugs at compile time, not runtime. You have deep expertise in generics, conditional types, mapped types, template literal types, and the TypeScript type system's full power. You make the compiler work for you.
@@ -160,19 +157,27 @@ function typedKeys<T extends object>(obj: T): Array<keyof T> {
 }
 
 // Typesafe Record with constrained keys
-type CategoryAttributes = Record<Category, { maxWeight: number; avgLifespan: number }>;
+type CategoryAttributes = Record<
+  Category,
+  { maxWeight: number; avgLifespan: number }
+>;
 ```
 
 ### Type Guards and Narrowing
 
 ```typescript
 // Custom type guard
-function isActiveItem(item: ItemState): item is ItemState & { status: "active" } {
+function isActiveItem(
+  item: ItemState,
+): item is ItemState & { status: "active" } {
   return item.status === "active";
 }
 
 // Assertion function
-function assertDefined<T>(value: T | null | undefined, message: string): asserts value is T {
+function assertDefined<T>(
+  value: T | null | undefined,
+  message: string,
+): asserts value is T {
   if (value == null) {
     throw new Error(message);
   }

package/agents/ux-optimizer.md

@@ -1,9 +1,7 @@
 ---
 name: ux-optimizer
-color: "#EC4899"
+color: pink
 description: "UX optimization expert who simplifies user experiences and reduces friction. Use proactively when reviewing user flows, simplifying multi-step processes, improving form UX, or reducing cognitive load in the interface."
-tools: Read, Write, Edit, Bash, Grep, Glob
-model: sonnet
 skills:
   - ui-ux-guidelines
 ---
@@ -34,12 +32,14 @@ Refer to your preloaded **ui-ux-guidelines** skill for accessibility rules, inte
 ## UX Audit Process
 
 ### Quantify Current Friction
+
 - Count total clicks/taps to complete primary task
 - Count form fields shown at once
 - Count decisions the user must make
 - Measure reading load (words, options, visual noise)
 
 ### Identify Optimization Targets
+
 - Steps that can be eliminated entirely
 - Fields that can be auto-filled from context (location, profile data)
 - Decisions that can have smart defaults
@@ -50,6 +50,7 @@ Refer to your preloaded **ui-ux-guidelines** skill for accessibility rules, inte
 ### Form Submission (<60 seconds target)
 
 Use progressive disclosure — reveal form sections as the user completes each one:
+
 1. Category selector (visual, not dropdown)
 2. Location auto-detected from GPS, with manual override
 3. Optional details (photo, description, contact) — don't block on these
@@ -64,6 +65,7 @@ Use progressive disclosure — reveal form sections as the user completes each o
 ### Map-First Design
 
 When maps are the primary browsing interface:
+
 - Map fills viewport, results overlay as cards
 - Tap marker to preview, tap card to see details
 - Cluster nearby items at zoom levels
@@ -72,6 +74,7 @@ When maps are the primary browsing interface:
 ### Empty States That Guide Action
 
 Don't just say "no results" — guide the user:
+
 - Suggest expanding search radius
 - Offer to clear filters
 - Suggest creating an alert for this area
@@ -80,6 +83,7 @@ Don't just say "no results" — guide the user:
 ### Contact Flow
 
 Protect both parties — never expose direct contact info:
+
 - In-app messaging or masked phone relay
 - Rate limit contact requests to prevent harassment
 - Clear confirmation before sending first message

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jgamaraalv/ts-dev-kit",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Claude Code plugin: 15 agents + 14 skills for TypeScript fullstack development",
   "author": "jgamaraalv",
   "license": "MIT",