refactor: update instruction files to enhance clarity and structure

Author: chrisreddington

.github/instructions/api-routes.instructions.md

@@ -3,9 +3,12 @@ applyTo: "web/src/app/api/**/*.{ts,js}"
 description: Next.js API route development patterns for the turn-based games platform
 ---
 
-# API Route Instructions
+# Next.js API Routes
+
+## Purpose
+
+Patterns for creating API routes in the web package. Covers request handling, game integration, error handling, and security.
 
-Follow these patterns when creating Next.js API routes:
 
 ## File Structure and Naming
 

.github/instructions/mcp-server.instructions.md

@@ -3,9 +3,12 @@ applyTo: "mcp-server/src/**/*.{ts,js}"
 description: MCP server development patterns for the turn-based games platform
 ---
 
-# MCP Server Instructions
+# MCP Server Development
+
+## Purpose
+
+Patterns for the Model Context Protocol server. Covers tool definitions, HTTP integration with the web API, AI algorithms, and error handling.
 
-Follow these patterns when developing the Model Context Protocol server:
 
 ## Server Architecture
 

.github/instructions/shared-library.instructions.md

@@ -3,9 +3,12 @@ applyTo: "shared/src/**/*.{ts,tsx}"
 description: Shared library development patterns for the turn-based games platform
 ---
 
-# Shared Library Instructions
+# Shared Library Development
+
+## Purpose
+
+Patterns for the `@turn-based-mcp/shared` package. Covers game implementations, storage abstraction, type system design, and constants.
 
-Follow these patterns when developing the shared library (`@turn-based-mcp/shared`):
 
 ## Library Architecture
 

.github/instructions/testing.instructions.md

@@ -3,9 +3,12 @@ applyTo: "**/{*.test.{ts,tsx,js,jsx},__tests__/**/*.{ts,tsx,js,jsx}}"
 description: Testing guidelines and patterns for the turn-based games platform
 ---
 
-# Testing Instructions
+# Testing Guidelines
+
+## Purpose
+
+Testing patterns and requirements for all packages. Covers test structure, mocking, shared utilities, and coverage requirements.
 
-Follow these testing patterns for the turn-based games platform:
 
 ## Test Structure and Organization
 

.github/instructions/typescript.instructions.md

@@ -3,9 +3,12 @@ applyTo: "**/*.{ts,tsx}"
 description: TypeScript development patterns and best practices for the turn-based games platform
 ---
 
-# TypeScript Instructions
+# TypeScript Development
+
+## Purpose
+
+TypeScript patterns for type-safe code. Covers type definitions, generics, error handling, and module organization.
 
-Follow these TypeScript patterns for consistent, type-safe code:
 
 ## Type Definitions
 

.github/instructions/ui-components.instructions.md

@@ -3,9 +3,12 @@ applyTo: "web/src/components/**/*.{tsx,ts}"
 description: React component development patterns for the turn-based games platform
 ---
 
-# UI Component Instructions
+# React Components
+
+## Purpose
+
+Patterns for React components in the web package. Covers component structure, styling with TailwindCSS, accessibility, and animations.
 
-Follow these patterns when creating React components:
 
 ## Component Structure