Refactor agent spawning and delegation check mechanisms

- Updated agent spawning from `Task()` to `Agent()` across various files to align with new standards.
- Enhanced the `code-developer` agent description to clarify its invocation context and responsibilities.
- Introduced a new `delegation-check` skill to validate command delegation prompts against agent role definitions, ensuring content separation and conflict detection.
- Established comprehensive separation rules for command delegation prompts and agent definitions, detailing ownership and conflict patterns.
- Improved documentation for command and agent design specifications to reflect the updated spawning patterns and validation processes.

codex-lens-v2/src/codexlens_search/watcher/events.py

@@ -0,0 +1,57 @@
+"""Event types for file watcher."""
+from __future__ import annotations
+
+import time
+from dataclasses import dataclass, field
+from enum import Enum
+from pathlib import Path
+from typing import Optional, Set
+
+
+class ChangeType(Enum):
+    """Type of file system change."""
+
+    CREATED = "created"
+    MODIFIED = "modified"
+    DELETED = "deleted"
+
+
+@dataclass
+class FileEvent:
+    """A file system change event."""
+
+    path: Path
+    change_type: ChangeType
+    timestamp: float = field(default_factory=time.time)
+
+
+@dataclass
+class WatcherConfig:
+    """Configuration for file watcher.
+
+    Attributes:
+        debounce_ms: Milliseconds to wait after the last event before
+            flushing the batch.  Default 500ms for low-latency indexing.
+        ignored_patterns: Directory/file name patterns to skip.  Any
+            path component matching one of these strings is ignored.
+    """
+
+    debounce_ms: int = 500
+    ignored_patterns: Set[str] = field(default_factory=lambda: {
+        # Version control
+        ".git", ".svn", ".hg",
+        # Python
+        ".venv", "venv", "env", "__pycache__", ".pytest_cache",
+        ".mypy_cache", ".ruff_cache",
+        # Node.js
+        "node_modules", "bower_components",
+        # Build artifacts
+        "dist", "build", "out", "target", "bin", "obj",
+        "coverage", "htmlcov",
+        # IDE / Editor
+        ".idea", ".vscode", ".vs",
+        # Package / cache
+        ".cache", ".parcel-cache", ".turbo", ".next", ".nuxt",
+        # Logs / temp
+        "logs", "tmp", "temp",
+    })