Add effort frontmatter to all agents and skills

claude · claude · commit cd523b1a5a1f · 2026-04-16T19:02:05.000Z
Configure Opus 4.7 adaptive thinking via effort: field in frontmatter:
- 19 agents: max (2), xhigh (10), high (4), medium (5)
- 23 skills: xhigh (3), high (10), medium (9), low (1)

Effort levels calibrated by task complexity:
- max: architect, spec-writer (deep reasoning required)
- xhigh: implementer, migrator, refactorer, etc. (code writing)
- high: debug-logs, dependency-analyst, etc. (analysis tasks)
- medium: explorer, bash-exec, etc. (simple operations)
- low: worktree (basic git commands)
diff --git a/container/.devcontainer/CHANGELOG.md b/container/.devcontainer/CHANGELOG.md
@@ -37,6 +37,7 @@
 - **Model upgrade** — all 9 opus-based agents now pinned to explicit `opus-4-5` model version (architect, documenter, implementer, investigator, migrator, refactorer, security-auditor, spec-writer, test-writer)
 - **Worktree isolation removed** — write-capable agents (documenter, implementer, migrator, refactorer, test-writer) now run in the main worktree instead of isolated git worktrees
 - **Model tier upgrade** — investigator and security-auditor upgraded from sonnet to opus for improved analysis quality
+- **Effort levels configured** — all 19 agents and 23 skills now have `effort:` frontmatter for Opus 4.7 adaptive thinking
 
 ### Configuration
 
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/architect.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/architect.md
@@ -25,6 +25,7 @@ hooks:
       type: command
       command: "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/guard-readonly-bash.py --mode general-readonly"
       timeout: 5
+effort: max
 ---
 
 # Architect Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/bash-exec.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/bash-exec.md
@@ -14,6 +14,7 @@ color: yellow
 permissionMode: default
 memory:
   scope: project
+effort: medium
 ---
 
 # Bash Execution Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/claude-guide.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/claude-guide.md
@@ -21,6 +21,7 @@ memory:
 skills:
   - claude-code-headless
   - claude-agent-sdk
+effort: medium
 ---
 
 # Claude Guide Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/debug-logs.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/debug-logs.md
@@ -24,6 +24,7 @@ hooks:
       type: command
       command: "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/guard-readonly-bash.py --mode general-readonly"
       timeout: 5
+effort: high
 ---
 
 # Debug Logs Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/dependency-analyst.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/dependency-analyst.md
@@ -28,6 +28,7 @@ hooks:
       type: command
       command: "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/guard-readonly-bash.py --mode general-readonly"
       timeout: 5
+effort: high
 ---
 
 # Dependency Analyst Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/documenter.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/documenter.md
@@ -22,6 +22,7 @@ skills:
   - spec
   - build
   - specs
+effort: xhigh
 ---
 
 # Documenter Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/explorer.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/explorer.md
@@ -26,6 +26,7 @@ hooks:
       type: command
       command: "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/guard-readonly-bash.py --mode general-readonly"
       timeout: 5
+effort: medium
 ---
 
 # Explorer Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/generalist.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/generalist.md
@@ -22,6 +22,7 @@ skills:
   - spec
   - build
   - specs
+effort: xhigh
 ---
 
 # Generalist Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/git-archaeologist.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/git-archaeologist.md
@@ -24,6 +24,7 @@ hooks:
       type: command
       command: "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/guard-readonly-bash.py --mode git-readonly"
       timeout: 5
+effort: medium
 ---
 
 # Git Archaeologist Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/implementer.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/implementer.md
@@ -22,6 +22,7 @@ hooks:
     - type: command
       command: "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/verify-no-regression.py"
       timeout: 120
+effort: xhigh
 ---
 
 # Implementer Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/investigator.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/investigator.md
@@ -33,6 +33,7 @@ hooks:
       type: command
       command: "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/guard-readonly-bash.py --mode general-readonly"
       timeout: 5
+effort: xhigh
 ---
 
 # Investigator Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/migrator.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/migrator.md
@@ -19,6 +19,7 @@ memory:
 skills:
   - migration-patterns
   - build
+effort: xhigh
 ---
 
 # Migrator Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/perf-profiler.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/perf-profiler.md
@@ -26,6 +26,7 @@ hooks:
       type: command
       command: "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/guard-readonly-bash.py --mode general-readonly"
       timeout: 5
+effort: high
 ---
 
 # Perf Profiler Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/refactorer.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/refactorer.md
@@ -25,6 +25,7 @@ hooks:
       type: command
       command: "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/verify-no-regression.py"
       timeout: 30
+effort: xhigh
 ---
 
 # Refactorer Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/researcher.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/researcher.md
@@ -25,6 +25,7 @@ hooks:
       type: command
       command: "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/guard-readonly-bash.py --mode general-readonly"
       timeout: 5
+effort: xhigh
 ---
 
 # Research Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/security-auditor.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/security-auditor.md
@@ -30,6 +30,7 @@ hooks:
       type: command
       command: "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/guard-readonly-bash.py --mode general-readonly"
       timeout: 5
+effort: xhigh
 ---
 
 # Security Auditor Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/spec-writer.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/spec-writer.md
@@ -19,6 +19,7 @@ memory:
 skills:
   - spec
   - specs
+effort: max
 ---
 
 # Spec Writer Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/statusline-config.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/statusline-config.md
@@ -14,6 +14,7 @@ color: orange
 permissionMode: acceptEdits
 memory:
   scope: user
+effort: medium
 ---
 
 # Status Line Configuration Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/test-writer.md b/container/.devcontainer/plugins/devs-marketplace/plugins/agent-system/agents/test-writer.md
@@ -24,6 +24,7 @@ hooks:
     - type: command
       command: "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/verify-tests-pass.py"
       timeout: 120
+effort: xhigh
 ---
 
 # Test Writer Agent
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/agent-browser/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/agent-browser/SKILL.md
@@ -11,6 +11,7 @@ description: >-
 version: 0.1.0
 allowed-tools: Bash
 argument-hint: "[url or action]"
+effort: high
 ---
 
 # Headless Browser Automation
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/api-design/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/api-design/SKILL.md
@@ -10,6 +10,7 @@ description: >-
   status codes. DO NOT USE for API implementation code — use the fastapi skill
   for building endpoints.
 version: 0.2.0
+effort: high
 ---
 
 # API Design
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/ast-grep-patterns/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/ast-grep-patterns/SKILL.md
@@ -8,6 +8,7 @@ description: >-
   with sg run, $$$ARGS meta-variables, tree-sitter tags. DO NOT USE for
   simple text searches where Grep suffices.
 version: 0.2.0
+effort: medium
 ---
 
 # AST-Grep Patterns
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/claude-agent-sdk/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/claude-agent-sdk/SKILL.md
@@ -9,6 +9,7 @@ description: >-
   query(), PermissionResult, AgentDefinition. DO NOT USE for PydanticAI Python
   agents or Claude Code CLI headless mode.
 version: 0.2.0
+effort: high
 ---
 
 # Claude Agent SDK (TypeScript)
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/claude-code-headless/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/claude-code-headless/SKILL.md
@@ -9,6 +9,7 @@ description: >-
   --output-format stream-json, --permission-mode, --json-schema, --resume.
   DO NOT USE for the TypeScript SDK API — use claude-agent-sdk instead.
 version: 0.3.0
+effort: high
 ---
 
 # Claude Code Headless
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/debugging/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/debugging/SKILL.md
@@ -12,6 +12,7 @@ description: >-
 version: 0.2.0
 allowed-tools: Bash, Read, Glob, Grep
 argument-hint: "[service or log-path]"
+effort: high
 ---
 
 # Debugging & Log Analysis
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/dependency-management/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/dependency-management/SKILL.md
@@ -11,6 +11,7 @@ description: >-
   or application-level vulnerability scanning.
 version: 0.2.0
 allowed-tools: Bash, Read, Glob, Grep
+effort: high
 ---
 
 # Dependency Management
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/docker-py/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/docker-py/SKILL.md
@@ -10,6 +10,7 @@ description: >-
   DO NOT USE for writing Dockerfiles or Docker Compose files — use the docker
   skill instead.
 version: 0.2.0
+effort: medium
 ---
 
 # Docker SDK for Python
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/docker/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/docker/SKILL.md
@@ -9,6 +9,7 @@ description: >-
   DO NOT USE for programmatic container management from Python — use
   docker-py instead.
 version: 0.2.0
+effort: medium
 ---
 
 # Docker & Docker Compose
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/documentation-patterns/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/documentation-patterns/SKILL.md
@@ -8,6 +8,7 @@ description: >-
   Google-style docstrings, Sphinx, rustdoc, TSDoc, OpenAPI annotations.
   DO NOT USE for writing code, fixing bugs, or generating changelogs.
 version: 0.2.0
+effort: medium
 ---
 
 # Documentation Patterns
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/fastapi/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/fastapi/SKILL.md
@@ -10,6 +10,7 @@ description: >-
   DO NOT USE for general Python web frameworks like Flask or Django, or for
   frontend development.
 version: 0.2.0
+effort: high
 ---
 
 # FastAPI Development
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/git-forensics/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/git-forensics/SKILL.md
@@ -11,6 +11,7 @@ description: >-
   routine git operations like committing, branching, or merging.
 version: 0.2.0
 allowed-tools: Bash, Read, Grep
+effort: medium
 ---
 
 # Git Forensics
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/migration-patterns/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/migration-patterns/SKILL.md
@@ -8,6 +8,7 @@ description: >-
   or works with Pydantic v1-to-v2, Django upgrades, CommonJS to ESM.
   DO NOT USE for routine dependency updates without API changes.
 version: 0.2.0
+effort: xhigh
 ---
 
 # Migration Patterns
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/performance-profiling/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/performance-profiling/SKILL.md
@@ -11,6 +11,7 @@ description: >-
   auditing, dependency management, or code refactoring.
 version: 0.2.0
 allowed-tools: Bash, Read, Glob, Grep
+effort: high
 ---
 
 # Performance Profiling
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/pydantic-ai/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/pydantic-ai/SKILL.md
@@ -9,6 +9,7 @@ description: >-
   RunContext, TestModel, FallbackModel, VercelAIAdapter. DO NOT USE for Claude
   Agent SDK TypeScript agents or general LLM API calls.
 version: 0.2.0
+effort: high
 ---
 
 # PydanticAI Agent Development
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/refactoring-patterns/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/refactoring-patterns/SKILL.md
@@ -10,6 +10,7 @@ description: >-
   primitive obsession, or inline variable. DO NOT USE for adding new
   features, fixing bugs, or performance optimization.
 version: 0.2.0
+effort: high
 ---
 
 # Refactoring Patterns
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/security-checklist/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/security-checklist/SKILL.md
@@ -10,6 +10,7 @@ description: >-
   profiling or general code quality reviews.
 version: 0.2.0
 allowed-tools: Bash, Read, Glob, Grep
+effort: xhigh
 ---
 
 # Security Checklist
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/skill-building/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/skill-building/SKILL.md
@@ -8,6 +8,7 @@ description: >-
   instructions", or works with skill authoring patterns or plugin directory
   structure. DO NOT USE for application code or general prompt engineering.
 version: 0.2.0
+effort: medium
 ---
 
 # Skill Building for Claude Code Plugins
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/sqlite/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/sqlite/SKILL.md
@@ -10,6 +10,7 @@ description: >-
   expression indexes. DO NOT USE for PostgreSQL, MySQL, or other client-server
   database systems.
 version: 0.2.0
+effort: medium
 ---
 
 # SQLite Development
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/svelte5/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/svelte5/SKILL.md
@@ -8,6 +8,7 @@ description: >-
   with $state, $derived, $effect, $props, @ai-sdk/svelte, svelte-dnd-action.
   DO NOT USE for Svelte 4 legacy codebases or React/Vue development.
 version: 0.2.0
+effort: medium
 ---
 
 # Svelte 5 Development
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/team/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/team/SKILL.md
@@ -12,6 +12,7 @@ description: >-
   workstreams.
 version: 0.2.0
 disable-model-invocation: true
+effort: xhigh
 ---
 
 # Agent Team Orchestration
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/testing/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/testing/SKILL.md
@@ -11,6 +11,7 @@ description: >-
 version: 0.2.0
 allowed-tools: Bash, Read, Write, Edit, Glob, Grep
 argument-hint: "[file or module]"
+effort: high
 ---
 
 # Testing (FastAPI + Svelte)
diff --git a/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/worktree/SKILL.md b/container/.devcontainer/plugins/devs-marketplace/plugins/skill-engine/skills/worktree/SKILL.md
@@ -11,6 +11,7 @@ description: >-
   or single-branch workflows.
 version: 0.1.0
 allowed-tools: Bash, Read, Grep, Glob, EnterWorktree
+effort: low
 ---
 
 # Git Worktrees
