OpenWriterControle/plugins/claude-code/scripts/context/openagents-repo/lookup/subagent-frontmatter.md
Darren Hinde a8fc9c7715
feat(plugin): enhance context management and skill invocation (#239)
* fix(shellcheck): declare and assign separately in router.sh (SC2155)

* feat(plugin): enhance context management and skill invocation

- Update .context-manifest.json to include profile and detailed source information.
- Revise context-scout.md to clarify context root discovery and navigation.
- Modify commands to replace deprecated skills with updated ones (brainstorming → approach, systematic-debugging → debugger).
- Streamline install-context.md for clarity and remove interactive profile selection.
- Improve oac-status.md to provide a more comprehensive status report.
- Add OAC system paths to session-start.sh for better context management.
- Remove obsolete skills and improve documentation for existing commands.
2026-02-23 12:12:29 +00:00

1.9 KiB

Subagent Frontmatter

Purpose: Quick reference for subagent configuration fields


Required Fields

Field Description
name Unique identifier (lowercase, hyphens)
description When Claude should delegate to this subagent

Optional Fields

Field Default Description
tools All Tools subagent can use
disallowedTools - Tools to deny (removed from list)
model sonnet Model: sonnet, opus, haiku, inherit
permissionMode default Permission handling mode
skills - Skills to load into context
hooks - Lifecycle hooks for this subagent

Permission Modes

Mode Behavior
default Standard permission checking
acceptEdits Auto-accept file edits
dontAsk Auto-deny permission prompts
bypassPermissions Skip all permission checks
plan Read-only exploration

⚠️ bypassPermissions is dangerous - skips all checks


Hooks Syntax

hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/validate.sh"
  PostToolUse:
    - matcher: "Edit|Write"
      hooks:
        - type: command
          command: "./scripts/lint.sh"

Example

---
name: debugger
description: Debugging specialist for errors and test failures
tools: Read, Edit, Bash, Grep, Glob
model: inherit
permissionMode: default
---

You are an expert debugger...

  • ../concepts/subagents-system.md - Subagents overview
  • ../guides/creating-subagents.md - Creation guide
  • ../lookup/builtin-subagents.md - Built-in subagents

Reference: https://docs.anthropic.com/en/docs/claude-code/sub-agents