Ue Project Context

Fallback questionnaire

Use this only when there is no Source/ tree to scan (Blueprint-only project, or an empty project being planned). Work through one group at a time and confirm each before moving on.

Engine and project. Project name and a one-sentence description. Engine version, launcher or source build. Project type (game, simulation, visualisation, tool, plugin) and genre. Target platforms.

Modules. Module names, which is the primary game module, and each module's host type (Runtime, Editor, Developer, CookedOnly, UncookedOnly, Program). Key dependencies per module.

Plugins. Walk the Plugin checklist by area rather than reciting names. Then in-house plugins under Plugins/, Fab/marketplace plugins critical to gameplay, and any licence restriction worth recording.

Conventions. Epic's F/U/A/E/I prefixes or a house variant. TObjectPtr for UPROPERTY object references, or raw pointers. Module API macro style — MYGAME_API on each declaration, or a per-header #define UE_API MYGAME_API. Log category names. Assertion policy (check, checkf, ensure, ensureMsgf, verify) and where each is allowed. Public/Private header layout. Any rule enforced in review.

Gameplay framework. Class names for GameMode, GameState, PlayerController, PlayerState, Pawn/Character, GameInstance. Subsystem classes in use and what each owns.

GAS. Whether GameplayAbilities is enabled; if so, the AbilitySystemComponent subclass, AttributeSet class names, the ability base class, and where the tag hierarchy is defined.

Networking. Listen server, dedicated server, or single-player. Iris or classic replication. Push model on or off. ReplicationGraph in use. Expected player count and tick budget.

Input. EnhancedInput or legacy mappings. Where UInputMappingContext and UInputAction assets live, and which class adds the contexts.

UI. UMG only, CommonUI, or CommonUI plus ModelViewViewModel. Base widget classes and how the HUD/menu stack is managed.

AI. Behavior Trees, StateTree/GameplayStateTree, Mass, or a custom stack. Navigation setup and whether SmartObjects is in use.

Streaming. World Partition with Data Layers, or classic sub-levels. Level-instancing approach.

Saves. USaveGame subclass names, slot naming, versioning approach.

Build. Which target types ship. Custom preprocessor defines. Third-party libraries and how they are integrated. Platform-specific code paths. Engine fork or modifications.

Team. Size and roles. Source control (Perforce, Git, Plastic). Branching and asset-lock policy. Review bar. Documentation home.

Document template

Write .agents/ue-project-context.md in this shape. Drop any section the project genuinely has nothing to say about.

# UE Project Context

*Engine: UE 5.8 · Last updated: [date]*

## Engine & Project
**Engine version:** [5.8 — launcher build / source build at [path]]
**Project name:** [name] · **Type:** [game / sim / tool] · **Genre:** [genre]
**Description:** [one sentence]
**Target platforms:** [list]

## Modules
**Primary game module:** [ModuleName]

| Module | Host type | Public deps | Private deps | Notes |
|---|---|---|---|---|
| [MyGame] | Runtime | Core, CoreUObject, Engine, InputCore | [list] | [purpose] |
| [MyGameEditor] | Editor | [list] | [list] | [purpose] |

## Plugins
| Plugin | Maturity | Used for |
|---|---|---|
| [EnhancedInput] | [stable] | [input] |
| [Mover] | [Experimental] | [locomotion prototype] |

**In-house plugins:** [Name — purpose]
**Fab / marketplace:** [Name — purpose, licence notes]

## Coding conventions
**Prefixes:** [standard F/U/A/E/I, exceptions]
**Object references:** [TObjectPtr in UPROPERTY / raw pointers]
**API macro style:** [MYGAME_API per declaration / per-header #define UE_API MYGAME_API]
**Log categories:** `[LogMyGame]` — [scope]
**Assertions:** [check where / ensure where / verify where]
**Header layout:** [Public/Private per module / flat]
**Enforced rules:** [list]

## Gameplay framework
| Role | Class |
|---|---|
| GameMode | `[AMyGameMode]` |
| GameState | `[AMyGameState]` |
| PlayerController | `[AMyPlayerController]` |
| PlayerState | `[AMyPlayerState]` |
| Pawn / Character | `[AMyCharacter]` |
| GameInstance | `[UMyGameInstance]` |

**Subsystems:** `[UMyClass]` ([UGameInstanceSubsystem / UWorldSubsystem / ULocalPlayerSubsystem]) — [owns]

## GAS
**Enabled:** [yes / no]
**AbilitySystemComponent:** `[UMyAbilitySystemComponent]` — lives on [PlayerState / Pawn]
**AttributeSets:** `[UMyAttributeSet]` — [attributes]
**Ability base:** `[UMyGameplayAbility]`
**Tag source:** [Config/DefaultGameplayTags.ini / native tags in [file]]

## Networking
**Model:** [single-player / listen server / dedicated server]
**Replication stack:** [classic / Iris (Beta)]
**Push model:** [on / off] · **ReplicationGraph:** [yes / no]
**Budget:** [N players, tick rate]

## Input
**Stack:** [EnhancedInput / legacy]
**Mapping contexts:** [asset paths] · **Added by:** `[class]`

## UI
**Stack:** [UMG / CommonUI / CommonUI + ModelViewViewModel]
**Base widgets:** `[UMyUserWidget]` · **Layer / stack management:** [description]

## AI
**Stack:** [Behavior Trees / StateTree / GameplayStateTree / Mass / custom]
**Navigation:** [NavMesh setup] · **SmartObjects:** [yes / no]

## Streaming
**Model:** [World Partition + Data Layers / sub-levels]
**Notes:** [cell size, streaming sources, level instances]

## Saves
**SaveGame classes:** `[UMySaveGame]` · **Slots:** [naming] · **Versioning:** [approach]

## Build
**Targets:** [Game, Editor, Client, Server]
**Defines:** `[MYGAME_WITH_CHEATS]` — [purpose]
**Third-party:** [Library — binary / source]
**Platform notes:** [platform: constraint]
**Engine modifications:** [none / fork at [repo] — [what changed]]

## Team
**Size & roles:** [N engineers, N designers, N artists]
**Source control:** [Perforce / Git / Plastic] · **Branching:** [strategy]
**Review bar:** [description] · **Docs:** [where]

Deprecated — do not use

Old forms an agent is likely to write into a context document, or into the code it generates from one.

Common Mistakes

Opening with a questionnaire instead of a draft: the .uproject, the *.Build.cs files and Config/Default*.ini answer most of the document. Scan, draft, then find out what is wrong — do not make the user dictate what is already on disk.

Guessing to fill a gap: a fabricated team size or assertion policy is worse than a blank, because every other skill then acts on it. Write [unknown] and move on.

Writing friendly plugin names: record the .uplugin name (ModelViewViewModel, Metasound, GameplayAbilities), not the display name, so other skills can match it against .uproject Plugins[].

Misjudging plugin state: a plugin is active if its .uproject Plugins[] entry has "Enabled": true, or if it is enabled by default and not disabled there — and a project plugin under Plugins/ with no EnabledByDefault key counts as enabled by default.

Putting GameMapsSettings under the Engine module: the class lives in the EngineSettings module, so the section is [/Script/EngineSettings.GameMapsSettings]. The wrong section silently does nothing.

Omitting maturity: an Experimental or Beta plugin changes what other skills should recommend. Mover (Experimental), Iris (Beta) and GameplayCameras (Experimental) each need the label next to the name.

Dropping module dependencies: most UE link errors trace to a missing entry in PublicDependencyModuleNames/PrivateDependencyModuleNames. Capture both lists per module verbatim.

Overwriting on a refresh: on a re-run, merge into the existing file. Sections the user did not revisit keep their content.

Related Skills

Skills that read .agents/ue-project-context.md, and what each takes from it:

• ue-module-build-system — module list, host types, Build.cs dependency lists, target types
• ue-cpp-foundations — naming prefixes, TObjectPtr policy, API macro style, assertion policy
• ue-gameplay-framework — GameMode, GameState, PlayerController, PlayerState, Pawn classes
• ue-gameplay-abilities — GAS setup, AbilitySystemComponent owner, AttributeSet names
• ue-gameplay-tags-messaging — tag source (DefaultGameplayTags.ini or native tags) and messaging stack
• ue-networking-replication — networking model, Iris versus classic, push model, ReplicationGraph
• ue-input-system — Enhanced Input status, mapping context locations, PlayerController class
• ue-ui-umg-slate — CommonUI / ModelViewViewModel status and base widget classes
• ue-blueprint-cpp-interop — API macro style and which systems are Blueprint-facing
• ue-actor-component-architecture — subsystem list and component conventions
• ue-character-movement — character class and movement stack
• ue-mover — whether the Mover plugin (Experimental) is enabled
• ue-gameplay-cameras — whether GameplayCameras (Experimental) is enabled
• ue-ai-navigation — AI stack, navigation setup, SmartObjects status
• ue-state-trees — StateTree / GameplayStateTree plugin status
• ue-world-level-streaming — World Partition versus sub-levels, Data Layer usage
• ue-serialization-savegames — SaveGame classes, slot naming, versioning
• ue-testing-debugging — log categories, assertion policy, module list
• ue-editor-tools — Editor module names and editor plugin list
• ue-game-features — GameFeatures / ModularGameplay plugin status