qframework

Implement CQRS-driven architecture for Unity projects using QFramework roles.

Updated Jan 10, 2026
One-click install
npx skills add https://github.com/tja688/ITC-Unity6 --skill qframework
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qframework
Source: https://github.com/tja688/ITC-Unity6/tree/main/.agents/skills/qframework
Command: npx skills add https://github.com/tja688/ITC-Unity6 --skill qframework

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

QFramework provides a standard, CQRS-focused architecture and toolkit for Unity development, helping teams implement features, refactor existing code, and analyze projects with a consistent set of roles (Architecture, Controller, System, Model, Utility, Command, Query, Event, BindableProperty).

Core Features & Use Cases

  • Architecture guidance and separation of concerns (MVC-inspired structure with IArchitecture, IModel, ISystem, IUtility, ICommand, IQuery, IEvent).
  • CQRS-first workflow: Commands write state, Queries read state, and Events notify changes.
  • Bundled references, templates, and docs to accelerate feature work and analysis (Playbook, Templates, API docs, User Manual, etc).

Quick Start

Install and configure QFramework in your Unity project, then map features to QFramework layers and load the bundled references to begin architecture-driven development.

Frequently Asked Questions about qframework

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the best way to implement CQRS architecture in Unity?

The best way to implement CQRS architecture in Unity is to separate state mutations into stateless Commands and state reads into Queries, utilizing QFramework roles like IModel and ISystem to standardize feature development.

How do I refactor an existing Unity project using QFramework?

To refactor a Unity project using QFramework, map existing features to the single-root Architecture pattern and assign components to specific roles like IController, ISystem, and IUtility to enforce separation of concerns and event lifecycle discipline.

When do I need to use single-root Architecture pattern in Unity development?

You need the single-root Architecture pattern in Unity development when enforcing a strict CQRS workflow where Commands write state, Queries read state, and Events notify changes, ensuring consistent feature analysis and separation of concerns.

Does QFramework work with standard Unity layers like MVC?

Yes, QFramework applies an MVC-inspired structure using interfaces like IArchitecture, IModel, ISystem, and IUtility. It extends standard Unity layers by enforcing a CQRS-first workflow for feature development and code analysis.

Why should Commands in QFramework be stateless?

Commands in QFramework should be stateless to maintain strict CQRS architecture discipline. This ensures that Commands only write state to the Model, while Queries handle reading state, preventing unintended side effects during feature execution.

Can I use QFramework for game jam projects?

Yes, QFramework can be used for game jam projects. It provides bundled templates, API docs, and a playbook to accelerate architecture setup, allowing rapid feature development while maintaining event lifecycle discipline.