feat: expand agents (10), skills (20), and hooks (11) with profile system
Agents: - Add YAML frontmatter (model, tools) to all 7 existing agents - New agents: planner (opus), build-error-resolver (sonnet), loop-operator (sonnet) Skills: - search-first: research before building (Adopt/Extend/Compose/Build) - verification-loop: full quality gate pipeline (Build→TypeCheck→Lint→Test→Security→Diff) - strategic-compact: when and how to run /compact effectively - autonomous-loops: 6 patterns for autonomous agent workflows - continuous-learning: extract session learnings into instincts Hooks: - Profile system (minimal/standard/strict) via run-with-profile.sh - config-protection: block linter/formatter config edits (standard) - suggest-compact: remind about /compact every ~50 tool calls (standard) - auto-tmux-dev: suggest tmux for dev servers (standard) - session-save/session-load: persist and restore session context (Stop/SessionStart) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
55
DOCS.md
55
DOCS.md
@@ -80,14 +80,17 @@ Technical index for developers and AI agents. Use this as the entry point to all
|
||||
|
||||
## Agent Profiles (`/agents`)
|
||||
|
||||
- `agents/README.md` — agent index, selection guide, and shared context7 guidelines.
|
||||
- `agents/frontend-architect.md` — frontend specialist (React, Next.js, accessibility, performance).
|
||||
- `agents/backend-architect.md` — backend specialist (system design, databases, APIs).
|
||||
- `agents/security-auditor.md` — security review (OWASP, auth, vulnerability assessment).
|
||||
- `agents/test-engineer.md` — testing specialist (strategy, automation, CI/CD).
|
||||
- `agents/code-reviewer.md` — code quality and PR review.
|
||||
- `agents/prompt-engineer.md` — LLM prompt design and optimization.
|
||||
- `agents/documentation-expert.md` — technical writing, user/admin guides, docs maintenance.
|
||||
- `agents/README.md` — agent index, selection guide, model/tools reference, and shared context7 guidelines.
|
||||
- `agents/planner.md` — implementation planner (opus) — task breakdown, risk assessment, phased plans.
|
||||
- `agents/frontend-architect.md` — frontend specialist (opus) — React, Next.js, accessibility, performance.
|
||||
- `agents/backend-architect.md` — backend specialist (opus) — system design, databases, APIs.
|
||||
- `agents/security-auditor.md` — security review (opus) — OWASP, auth, vulnerability assessment.
|
||||
- `agents/code-reviewer.md` — code quality and PR review (sonnet).
|
||||
- `agents/test-engineer.md` — testing specialist (sonnet) — strategy, automation, CI/CD.
|
||||
- `agents/prompt-engineer.md` — LLM prompt design and optimization (sonnet).
|
||||
- `agents/documentation-expert.md` — technical writing, user/admin guides, docs maintenance (sonnet).
|
||||
- `agents/build-error-resolver.md` — build/type/lint error fixer (sonnet) — minimal-diff fixes.
|
||||
- `agents/loop-operator.md` — autonomous loop monitor (sonnet) — stall detection, escalation.
|
||||
|
||||
## Claude Code Skills (`/.claude/skills`)
|
||||
|
||||
@@ -106,15 +109,47 @@ Technical index for developers and AI agents. Use this as the entry point to all
|
||||
- `.claude/skills/review-pr/` — Gitea PR review by number (code-reviewer).
|
||||
- `.claude/skills/improve-prompt/` — diagnose and improve LLM prompt (prompt-engineer).
|
||||
- `.claude/skills/create-skill/` — create or improve a Claude Code skill (meta-skill).
|
||||
- `.claude/skills/search-first/` — research existing solutions before building custom code.
|
||||
- `.claude/skills/verification-loop/` — full quality gate pipeline (Build→TypeCheck→Lint→Test→Security→Diff).
|
||||
- `.claude/skills/strategic-compact/` — when and how to run /compact effectively.
|
||||
- `.claude/skills/autonomous-loops/` — patterns for autonomous agent workflows (6 levels).
|
||||
- `.claude/skills/continuous-learning/` — extract session learnings into instincts and memory.
|
||||
|
||||
## Claude Code Hooks (`/.claude/hooks`)
|
||||
|
||||
### Profile System
|
||||
|
||||
Hooks use a profile system (`minimal|standard|strict`) controlled by `CLAUDE_HOOK_PROFILE` env var (default: `standard`).
|
||||
Individual hooks can be disabled via `CLAUDE_DISABLED_HOOKS` env var (comma-separated filenames).
|
||||
|
||||
- `.claude/hooks/run-with-profile.sh` — profile gate wrapper for hooks.
|
||||
|
||||
### Safety Hooks (always active)
|
||||
|
||||
- `.claude/hooks/protect-files.sh` — blocks edits to `.env`, lock files, `.git/`, keys.
|
||||
- `.claude/hooks/bash-firewall.sh` — blocks destructive commands (`rm -rf /`, `git reset --hard`, etc.).
|
||||
- `.claude/hooks/post-edit-format.sh` — auto-formats files with Prettier after edits.
|
||||
- `.claude/hooks/audit-log.sh` — logs all Bash commands with timestamp to `audit.log`.
|
||||
- `.claude/hooks/commit-docs-reminder.sh` — reminds to check `status-update-checklist.md` before `git commit`.
|
||||
- `.claude/settings.json` — hooks configuration (also: Notification, SessionStart compact context).
|
||||
|
||||
### Quality Hooks (standard+ profile)
|
||||
|
||||
- `.claude/hooks/config-protection.sh` — blocks modifications to linter/formatter config files.
|
||||
- `.claude/hooks/suggest-compact.sh` — suggests /compact every ~50 tool calls.
|
||||
- `.claude/hooks/auto-tmux-dev.sh` — suggests tmux for long-running dev server commands.
|
||||
|
||||
### Strict-Only Hooks
|
||||
|
||||
- `.claude/hooks/post-edit-format.sh` — auto-formats files with Prettier after edits.
|
||||
|
||||
### Session Persistence
|
||||
|
||||
- `.claude/hooks/session-load.sh` — restores previous session context on SessionStart.
|
||||
- `.claude/hooks/session-save.sh` — saves session context (branch, files, commits) on Stop.
|
||||
- `.claude/sessions/` — session state storage directory.
|
||||
|
||||
### Configuration
|
||||
|
||||
- `.claude/settings.json` — hooks configuration (PreToolUse, PostToolUse, SessionStart, Stop, Notification).
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user