add SKILL

agents/README.md

@@ -0,0 +1,68 @@
+# Agent Profiles
+
+This directory contains specialized AI agent profiles. Each profile defines a role, principles, constraints, and workflow for a specific domain.
+
+## Available Agents
+
+| Agent | File | Use When |
+|-------|------|----------|
+| Frontend Architect | `frontend-architect.md` | UI components, performance, accessibility, React/Next.js |
+| Backend Architect | `backend-architect.md` | System design, databases, APIs, scalability |
+| Security Auditor | `security-auditor.md` | Security review, vulnerability assessment, auth flows |
+| Test Engineer | `test-engineer.md` | Test strategy, automation, CI/CD, coverage |
+| Code Reviewer | `code-reviewer.md` | Code quality, PR review, best practices |
+| Prompt Engineer | `prompt-engineer.md` | LLM prompts, agent instructions, prompt optimization |
+
+## Agent Selection
+
+See `RULES.md` sections 4-5 for the selection protocol and multi-agent coordination.
+
+## Using context7 (Shared Guidelines)
+
+All agents use context7 to access up-to-date documentation. Training data may be outdated — always verify through context7 before making recommendations.
+
+### When to Use
+
+**Always query context7 before:**
+- Recommending specific library/framework versions
+- Suggesting API patterns or method signatures
+- Advising on security configurations or CVEs
+- Checking for deprecated features or breaking changes
+- Verifying browser support or compatibility matrices
+
+### How to Use
+
+1. **Resolve library ID**: Use `resolve-library-id` to find the correct context7 library identifier
+2. **Query documentation**: Use `query-docs` with the resolved ID and a specific topic
+
+### Example
+
+```
+User asks about React Server Components
+
+1. resolve-library-id: "react" → get library ID
+2. query-docs: topic="Server Components patterns"
+3. Base recommendations on returned documentation, not training data
+```
+
+### What to Verify
+
+| Category | Verify |
+|----------|--------|
+| Versions | LTS versions, deprecation timelines, migration guides |
+| APIs | Current method signatures, new features, removed APIs |
+| Security | CVE advisories, security best practices, auth patterns |
+| Performance | Current optimization techniques, benchmarks, configuration |
+| Compatibility | Version compatibility matrices, breaking changes |
+
+### Critical Rule
+
+When context7 documentation contradicts training knowledge, **trust context7**. Technologies evolve rapidly — training data may reference deprecated patterns or outdated versions.
+
+## Adding a New Agent
+
+1. Create a new `.md` file in this directory
+2. Use consistent frontmatter: `name` and `description`
+3. Follow the structure: Role → Core Principles → Constraints → Workflow → Responsibilities → Output Format → Pre-Response Checklist
+4. Reference this README for context7 usage instead of duplicating the section
+5. Update `DOCS.md` and `README.md` to list the new agent