Updates agent instructions

Author: d13

CLAUDE.md renamed to AGENTS.md

@@ -1,6 +1,7 @@
-# CLAUDE.md
+# AGENTS.md
 
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+> Guidance for AI-powered coding assistants (Augment Agent Mode, Augment Auggie CLI, Copilot Agent Mode, Claude Code, Cursor, Windsurf, etc.) when working with code in this repository.
+> Read this before writing, editing, or executing anything in this repo.
 
 ## Project Overview
 
@@ -9,18 +10,21 @@ This is a VS Code extension that provides web component information to AI assist
 ## Common Commands
 
 ### Development
+
 - `pnpm run build` - Build extension in development mode
 - `pnpm run bundle` - Build extension for production
 - `pnpm run watch` - Watch mode for development
 - `pnpm run clean` - Clean build artifacts
 
 ### Code Quality
+
 - `pnpm run lint` - Run ESLint on TypeScript files
 - `pnpm run lint:fix` - Run ESLint with auto-fix
 - `pnpm run format` - Format code with Prettier
 - `pnpm run format:check` - Check code formatting
 
 ### Packaging & Publishing
+
 - `pnpm run package` - Create VSIX package
 - `pnpm run package-pre` - Create pre-release VSIX package
 - `pnpm run pub` - Publish to marketplace
@@ -31,32 +35,39 @@ This is a VS Code extension that provides web component information to AI assist
 ### Core Components
 
 **Extension Entry Point** (`src/extension.ts`):
+
 - Main activation point that initializes logging, configuration, and container
 - Sets up the dependency injection container and registers commands
 
 **Container** (`src/container.ts`):
+
 - Dependency injection container managing all services and providers
 - Central point for service resolution and lifecycle management
 
 **MCP Provider** (`src/mcp/provider.ts`):
+
 - Core MCP server implementation providing web component data
 - Serves HTTP and SSE endpoints for AI assistant integration
 - Implements MCP tools: search-components, get-component-details, list-all-components
 
 **Custom Elements Manifest (CEM) System**:
+
 - `src/cem/locator.ts` - Discovers custom-elements.json files in workspace and dependencies
 - `src/cem/reader.ts` - Reads and parses manifest files with caching
 
 **Commands** (`src/commands/`):
+
 - VS Code command implementations for starting/stopping MCP server
 - Manifest management commands (list, locate, include/exclude)
 - Tree view refresh and information display commands
 
 **Views** (`src/views/`):
+
 - Tree view implementation showing discovered manifests
 - Custom tree nodes for different manifest states and groupings
 
 **System Utilities** (`src/system/`):
+
 - Logging, configuration, decorators, and common utilities
 - Standardized patterns for async operations and error handling
 
@@ -71,6 +82,7 @@ This is a VS Code extension that provides web component information to AI assist
 ### Configuration
 
 The extension uses VS Code settings under the `wcai.*` namespace:
+
 - `wcai.outputLevel` - Logging verbosity (off, error, warn, info, debug)
 - `wcai.manifests.exclude` - Array of manifest URIs to exclude
 - `wcai.mcp.host/port` - MCP server network configuration
@@ -81,4 +93,78 @@ The extension uses VS Code settings under the `wcai.*` namespace:
 - Uses Webpack with TypeScript compilation
 - Node.js target for main extension code
 - Separate webpack configs for extension and potential webviews
-- TypeScript project references for modular compilation
+- TypeScript project references for modular compilation
+
+## Coding Standards & Styles Rules
+
+### TypeScript Configuration
+
+- Recommended TypeScript with `recommendedTypeChecked` ESLint config
+- No `any` usage (exceptions for external APIs)
+- Explicit return types for public methods
+- Prefer `type` over `interface` for unions
+
+### Import Organization
+
+- Group imports: built-in, external, internal, parent, sibling, index
+- Alphabetical order within groups
+- No unused imports or variables
+- Consistent type imports with `import type`
+
+### Naming Conventions
+
+- **Classes**: PascalCase (no I prefix for interfaces)
+- **Methods/Variables**: camelCase
+- **Constants**: camelCase for module-level constants
+- **Private members**: Leading underscore allowed
+- **Files**: `camelCase.ts`, `camelCase.utils.ts` for related utilities
+- **Folders**
+  - Models under a `models/` sub-folder
+  - Utilities under a `utils/` sub-folder if they can be used in both the extension host and webviews, or `utils/-webview/` sub-folder for extension host-specific utilities
+
+### Code Structure
+
+- **Single responsibility** - Each service has focused purpose
+- **Dependency injection** - Services injected via Container
+- **Event-driven** - EventEmitter pattern for service communication
+- **Disposable pattern** - Proper cleanup with VS Code `Disposable` interface
+
+### Error Handling
+
+- Use custom error types extending Error
+- Log errors with context using `Logger.error()`
+- Graceful degradation for network/API failures
+- Validate external data with schema validators
+
+## Repository Guidelines
+
+### Commit Messages
+
+- Use a future-oriented manner, third-person singular present tense (e.g., 'Fixes', 'Updates', 'Improves', 'Adds', 'Removes')
+- Reference issues with #123 syntax for auto-linking
+- Keep first line under 72 characters
+
+### Branch Workflow
+
+- Feature branches from main
+- Prefix with feature type: feature/, bug/, debt/
+- Use descriptive names: feature/search-natural-language
+
+### Code Reviews
+
+- Check TypeScript compilation and tests pass
+- Verify no new ESLint violations
+
+## Development Environment
+
+### Prerequisites
+
+- Node.js ≥ 22.12.0
+- pnpm ≥ 10.x (via corepack)
+- Git ≥ 2.7.2
+
+### VS Code Tasks
+
+- Build - `Ctrl+Shift+P` → "Tasks: Run Task" → "npm: watch"
+- Test - Use VS Code's built-in test runner
+- Debug - `F5` to launch Extension Development Host