personal-projects/leo-claude-mktplace
Template
0
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Page: lessons/patterns/agent-model-field-not-supported-by-claude-code
Pages
Change V5.4.0: Multi-Model Agent Support Proposal Change V5.4.0: Multi-Model Support (Sprint 7 Implementation) Change V04.1.0: Proposal (Implementation 1) Change V04.1.0: Proposal Change-V5.2.0:-Plugin-Enhancements-(Sprint-4-Commands) Change-V5.2.0:-Plugin-Enhancements-(Sprint-5-Documentation) Change-V5.2.0:-Plugin-Enhancements-Proposal.- Change-V5.5.0:-Hook-Efficiency-Quick-Wins-(Sprint-8-Implementation) Change-V5.6.0:-Domain-Advisory-Pattern-(Sprint-9-Implementation).- Change V5.6.0: Domain Advisory Pattern Proposal Change-V5.7.0:-Data-Platform-Domain-Advisory-(Sprint-10-Implementation) RFC-Hook-Efficiency-Improvements RFC-Perf-Sentinel-Plugin Sprint-1-viz-platform-Implementation-Plan branding/header-templates branding/plugin-registry branding/progress-templates branding/visual-spec lessons/patterns/agent-model-field-not-supported-by-claude-code lessons/patterns/command-frontmatter-missing-name-field-causes-silent-load-failure lessons/patterns/hook-message-wording-affects-claude-continuation-behavior lessons/patterns/mcp-venv-symlinks-lost-on-marketplace-update---5-hour-debug-loop lessons/patterns/mcp_servers-field-in-pluginjson---another-failed-debug-theory lessons/patterns/plugin-hooks-must-be-in-separate-file-not-inline lessons/patterns/plugin-load-errors---missing-name-field-in-command-frontmatter lessons/patterns/plugin-load-failure---check-command-frontmatter-first lessons/patterns/plugin-manifest-validation---hooks-and-agents-format-requirements lessons/patterns/plugin-version-mismatch-causes-silent-load-failure lessons/patterns/reset-pandas-index-after-filtering-to-prevent-column-pollution lessons/patterns/session-2026-02-02---mcp-server-venv-package-installation-failures lessons/patterns/setup-wizard-url-format-mismatch lessons/patterns/sprint-4---new-commands-not-discoverable-until-session-restart lessons/patterns/startup-hooks-must-check-venv-cache-path-first lessons/patterns/sync-entire-plugin-directory-not-individual-files lessons/patterns/use-fixes-n-keyword-for-automatic-issue-closing-in-prs lessons/sprints/cache-clearing-breaks-mcp-tools-mid-session lessons/sprints/sprint-1---viz-platform-plugin-implementation lessons/sprints/sprint-10---domain-advisory-pattern-replication-success lessons/sprints/sprint-2---contract-validator-plugin-implementation lessons/sprints/sprint-3---agent-runaway-detection-and-timeout-handling lessons/sprints/sprint-3---background-agent-permissions-must-be-pre-granted lessons/sprints/sprint-3---mcp-server-branch-detection-bug-runs-from-installed-dir lessons/sprints/sprint-4---plugin-commands-implementation lessons/sprints/sprint-6---visual-branding-and-documentation-maintenance lessons/sprints/sprint-8---parallel-hook-optimization-success lessons/sprints/v400-release---wiki-workflow-and-versioning-patterns lessons/sprints/versioning-workflow---use-unreleased-and-release-script lessons-learned/sprints/hook-efficiency-rfc unnamed
Clone
2
lessons/patterns/agent-model-field-not-supported-by-claude-code
Leo Miranda edited this page 2026-02-03 03:52:40 +00:00
Table of Contents

CORRECTION: Agent model: Field IS Supported

Date

2026-02-02 (UPDATED)

Summary

THIS LESSON WAS WRONG. The model: field IS supported in agent YAML frontmatter per the official documentation at https://code.claude.com/docs/en/sub-agents

What Actually Happened

  1. Added model: field to agent frontmatter - THIS WAS CORRECT
  2. Plugin failed to load
  3. I incorrectly blamed the model field
  4. Removed the model field - THIS WAS WRONG
  5. User pointed me to the docs showing model IS supported

The Real Issue

The plugin loading error was NOT caused by the model field. Need to investigate the actual cause.

Valid Agent Frontmatter Fields (from official docs)

Field Required Description
name Yes Unique identifier using lowercase letters and hyphens
description Yes When Claude should delegate to this subagent
tools No Tools the subagent can use
disallowedTools No Tools to deny
model No VALID: sonnet, opus, haiku, or inherit. Defaults to inherit
permissionMode No Permission mode
skills No Skills to load
hooks No Lifecycle hooks

Lesson

READ THE OFFICIAL DOCS BEFORE ASSUMING WHAT'S SUPPORTED.

I made assumptions based on a previous revert that was done without checking if Claude Code had been updated to support the field.

Tags: agents, frontmatter, model, CORRECTION