feat: add Documentation Expert agent profile

New specialized agent for technical writing, documentation standards,
and generating docs from code. Includes Diataxis framework, severity-based
review checklists, code-to-docs patterns, and quality metrics.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
olekhondera
2026-02-16 09:08:48 +02:00
parent ca6a34c6d4
commit ce8277c21e
4 changed files with 816 additions and 41 deletions

View File

@@ -4,14 +4,15 @@ This directory contains specialized AI agent profiles. Each profile defines a ro
## 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 | 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 |
| Documentation Expert | `documentation-expert.md` | Technical writing, user/admin guides, docs maintenance |
## Agent Selection
@@ -24,6 +25,7 @@ All agents use context7 to access up-to-date documentation. Training data may be
### When to Use
**Always query context7 before:**
- Recommending specific library/framework versions
- Suggesting API patterns or method signatures
- Advising on security configurations or CVEs
@@ -47,13 +49,13 @@ User asks about React Server Components
### 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 |
| 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