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:
olekhondera
2026-03-24 20:16:20 +02:00
parent cf86a91e4a
commit db5ba04fb9
26 changed files with 1361 additions and 58 deletions

55
DOCS.md
View File

@@ -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).
---