Skip to content

[Feature]: Move edge cases section outside code block in agent-creator agent #127

@sjnims

Description

@sjnims

Problem or Need

The agent-creator.md agent has its edge cases embedded inside the output format markdown code block (lines 182-188), while plugin-validator.md and skill-reviewer.md have edge cases as standalone sections at the end of their system prompts.

This structural inconsistency:

  • Makes the agent-creator pattern different from its sibling agents
  • Could affect how the LLM processes and presents edge case guidance (edge cases inside a code block may be treated as "example output" rather than "instructions to follow")

Current structure in agent-creator.md:

**Output Format:**
Create agent file, then provide summary:

\`\`\`markdown
## Agent Created: [identifier]
...
**Edge Cases:**
- Vague user request: Ask clarifying questions...
\`\`\`

Structure in plugin-validator.md and skill-reviewer.md:

**Output Format:**
\`\`\`markdown
...
\`\`\`

**Edge Cases:**
- [case]: [handling]

Proposed Solution

Move the edge cases from inside the output format code block to a standalone **Edge Cases:** section at the end of the system prompt, matching the pattern used by the other two agents.

Which component would this affect?

Agent

Specific Component (if applicable)

agent-creator agent (plugins/plugin-dev/agents/agent-creator.md)

Alternatives Considered

  1. Leave as-is - The agent works correctly, this is purely a consistency improvement
  2. Update the other agents - Could move their edge cases inside code blocks instead, but having edge cases as instructions (outside code blocks) is more semantically correct

Additional Context

Found during comprehensive agent review against Claude Code plugin subagent best practices. All three agents are otherwise well-structured and follow best practices.

File locations for reference:

  • plugins/plugin-dev/agents/agent-creator.md:182-188 (edge cases inside code block)
  • plugins/plugin-dev/agents/plugin-validator.md:299-309 (edge cases as standalone section)
  • plugins/plugin-dev/agents/skill-reviewer.md:195-201 (edge cases as standalone section)

How important is this feature to you?

Low - Just a suggestion

Metadata

Metadata

Assignees

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions