unison-development

Write, test, and update Unison code using MCP tools. Use when working with Unison language files (.u extension), UCM operations, or Unison projects. Enforces TDD with strict typechecking via development skill. Used as a part of the XP skill.

⭐3stars🔀0forks📁View on GitHub🕐Updated Jan 3, 2026

When & Why to Use This Skill

The Unison Development skill empowers developers to build, test, and maintain Unison language projects through a specialized MCP interface. By automating interactions with the Unison Code Manager (UCM) and enforcing strict typechecking, it ensures high-quality code production following Extreme Programming (XP) and Test-Driven Development (TDD) methodologies.

Use Cases

  • Streamlined Unison Coding: Write and update Unison code (.u files) directly through MCP tools, eliminating the need for manual UCM command-line operations.
  • Strict Type-Safe Development: Automatically typecheck code definitions to prevent errors before adding them to the Unison codebase via the scratch file workflow.
  • Efficient Project Management: Explore and navigate complex Unison namespaces and projects using integrated codebase exploration tools to understand existing definitions.
  • Advanced Refactoring: Manage complex updates to Unison abilities and functions with automated handling of typecheck errors and guided update branch management.
nameUnison Development
descriptionWrite, test, and update Unison code using the Unison MCP tool. Use when working with Unison language files (.u extension), UCM operations, or Unison projects. An extension to the XP skill.

Unison Development

  • Uses xp skill.
  • Use the Unison MCP server commands for all operations.

Core Principles

  1. NEVER run Unison Code Manager (UCM) commands on the command line — use MCP tools only
  2. Code is stored by the UCM, not Git
  3. Always use fully qualified names in scratch.u
  4. Never create multiple scratch files
  5. ALWAYS wait for user confirmation after update before continuing
  6. ALWAYS Typecheck code with unison MCP server before adding to scratch file
  7. Write code to the scratch.u file in the current directory after it typechecks
  8. After successful update, you may delete the scratch file
  9. Use the MCP service tool to explore the codebase before writing code

UPDATE MODE: Handling Typecheck Errors

When an update is performed that results in further changes required, the UCM adds this comment after the user updates:

-- The definitions below no longer typecheck with the changes above.
-- Please fix the errors and try `update` again.

CRITICAL:

  • DO NOT delete functions from scratch.u — they will be removed from codebase
  • Repair broken code, typechecking as you go
  • Ask user to verify via UCM output
  • After successful update, you may remove code from scratch.u

Success Criteria

  • All code typechecks successfully
  • Fully qualified names in scratch.u

Modifying Abilities

When modifying abilities it is easier to modify the ability first, ask the user to update in the UCM which will result in an update branch, fix the code in the update branch, then ask the user to update.