FormWren
Pre-release docs

Optional workflow

Use The Package Normally Or Add Agent Guidance

Rounded Rectangle works normally without a coding agent, MCP server, network connection, or AI account.

Use this page when you already automate Unity authoring and want the agent to follow the package's render-path, ownership, validation, and save-safety rules.

Start with the smallest route

Choose An Automation Route

NeedStart hereResult
Give a coding agent the package workflow Portable skill The agent can inspect, plan, edit, and verify Rounded Rectangle work with package-specific rules.
Call structured actions from Editor code RoundedRectangleAgentFacade Your Editor integration receives structured results without requiring MCP.
Call those actions through an installed MCP for Unity service Optional MCP adapter The external service exposes one manage_rounded_rectangle tool.

Start with the skill. Add the facade or MCP route only when the agent also needs to execute structured Editor actions.

Project-scoped setup

Install The Portable Skill

Copy the whole source folder so that SKILL.md and references/action-contract.md stay together:

Assets/RoundedRectangle/AgentSkill/rounded-rectangle-unity/
CodexCopy to <project-root>/.agents/skills/rounded-rectangle-unity/. Invoke $rounded-rectangle-unity or describe a matching task.
Claude CodeCopy to <project-root>/.claude/skills/rounded-rectangle-unity/. Invoke /rounded-rectangle-unity or describe a matching task.
Other agentsProvide SKILL.md and references/action-contract.md together as project context.

If the destination already exists, inspect it before replacing it. The package does not create or overwrite project-level agent configuration.

Optional CLAUDE.md pointer

If your project already uses CLAUDE.md, a short pointer is enough:

# Rounded Rectangle

          - Use the `rounded-rectangle-unity` skill for Rounded Rectangle asset operations.
          - Inspect the visible owner before editing.
          - Do not save the scene unless the user asks.
          - Validate the result and report whether the scene still has unsaved changes.

First safe run

Use An Inspect-First Workflow

  1. State the visible result and the target object.
  2. Inspect the target and identify its visible owner.
  3. Choose World Mesh, Canvas mesh UI, or Canvas SDF.
  4. Dry-run broad or ambiguous changes.
  5. Apply one bounded change with validation enabled.
  6. Inspect the real Scene or Game view.
  7. Report the result and whether the scene still has unsaved changes.

For Canvas work, run the read-only layout analysis before visual review. A clean layout report does not replace checking the rendered result.

Structured Editor actions

RoundedRectangleAgentFacade supports capability discovery, inspection, creation, shape/style/effect updates, one-transaction configuration, composition creation, read-only layout analysis, render-path conversion, cache configuration, PNG export, and validation.

Mutating actions support dryRun and validateAfter. Results include changed fields, warnings, validation issues, target references, and sceneSaved: false. The facade never saves the scene.

Use Assets/RoundedRectangle/AgentSkill/rounded-rectangle-unity/references/action-contract.md for the current request and response fields.

Copy-ready requests

Start With A Bounded Task

Inspect without changes

Use the rounded-rectangle-unity skill. Inspect Canvas/Main Panel, identify the
          visible owner and rendering path, and report warnings. Do not change or save the
          scene.

Create one Canvas SDF surface

Use the rounded-rectangle-unity skill. Under Canvas, dry-run a 420 x 220 Canvas
          SDF panel with 36 corner radius and 4 border width. If validation is clean,
          create it, inspect the visible result, and leave the scene unsaved.

Diagnose an ineffective setting

Use the rounded-rectangle-unity skill. Inspect the visible owner, cache state,
          Canvas parent, and material for Canvas/Main Panel. Explain which component owns
          the setting. Do not make changes.
Canvas layout check
Analyze Canvas/Main Panel for text overflow, border clearance, sibling overlap,
          and Canvas escape. Keep the analysis read-only and do not save the scene.

External transport

Enable The MCP Adapter Only When Needed

The package does not include an MCP server. Use this route only when a compatible MCP for Unity integration is already installed.

  1. Add ROUNDED_RECTANGLE_MCP_FOR_UNITY to the active build target's Scripting Define Symbols.
  2. Let Unity recompile.
  3. Read mcpforunity://custom-tools and confirm that manage_rounded_rectangle is registered.
  4. Use the tool with the facade action contract.

The adapter source is Assets/RoundedRectangle/Editor/Agent/Integrations/RoundedRectangleMcpForUnityTool.cs.

Remove the define before uninstalling the external MCP integration. Without the define, the adapter is excluded and the package remains MCP-independent.

Operational boundary

Keep Save And Data Control Explicit

  • Agent actions do not save the scene implicitly.
  • Inspect shared materials and generated resources before changing them.
  • The package itself does not send prompts, scene data, or analytics over the network.
  • If you connect an external agent or MCP service, its own data and privacy policy applies to the information you send through it.