How To Use UCM
UCM is designed for Junior through Senior developers who want to build better codebases. Choose your workflow based on what you want to accomplish:
💡 Important: Always Start Here
When working with AI agents and the UCM MCP server, always begin your conversation with:
This ensures the AI agent understands your context and follows proper UCM workflows.
Two Ways to Work with UCM
As a Reader
Use the public utaba/ repository with battle-tested guidance, patterns, and implementations.
- • Access proven micro-block patterns
- • Learn from established guidance
- • Build on tested foundations
As an Author
Create and manage your own guidance and code artifacts in a private repository.
- • Store your team's patterns
- • Create custom guidance
- • Build your knowledge base
Choose Your Workflow
Getting Started with UCM
Set up your AI environment, install the MCP server, configure API keys, and prepare for guided development. Essential first step.
Build Your First App (UCM guidance and patterns)
Learn how to create a new application using UCM micro-block architecture, utaba guidance, and proven patterns. Avoid technical debt from day one.
The Human-AI Peer Programming Process
Learn the collaborative workflow between humans and AI for building software together. Master effective communication, guidance sharing, and iterative development.
Store Your Codebase Guidance
Learn how to use UCM to store and manage guidance for your existing codebase, enabling AI developers to get up to speed quickly in future conversations.
Build Without Public Repository
Create and modify applications using only your private UCM repository without relying on the public utaba patterns.
Transform Your Development Process
Stop building technical debt. Start building maintainable, well-architected systems with UCM guidance and micro-block patterns.
Remember: Without guidance, you create massive piles of crap. With UCM, you create cohesive systems.