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

85 lines
1.9 KiB
Markdown

<!-- Context: openagents-repo/lookup | Priority: high | Version: 1.0 | Updated: 2026-02-15 -->
# 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
```yaml
hooks:
PreToolUse:
- matcher: "Bash"
hooks:
- type: command
command: "./scripts/validate.sh"
PostToolUse:
- matcher: "Edit|Write"
hooks:
- type: command
command: "./scripts/lint.sh"
```
---
## Example
```yaml
---
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...
```
---
## Related
- `../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