punkfuncgames/project-overview
.claude/skills/project-overview/SKILL.md
Project architecture overview — layers, LifetimeScope hierarchy, module map, bootstrapping flow. Use when needing project-wide context or understanding module interactions.
tools
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add punkfuncgames/tetris-clone project-overviewInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 1:38 AM6.8s1 file scanned
SKILL.md
- name:
- project-overview
- description:
- Project architecture overview — layers, LifetimeScope hierarchy, module map, bootstrapping flow. Use when needing project-wide context or understanding module interactions.
- user-invocable:
- false
Project Architecture Overview
Project: PunkFuncGames GameTemplate — Unity 6 (URP 17.3.0) idle/incremental game template.
Packages: Packages/com.punkfuncgames.*/ (26 UPM packages)
Template shell: Assets/Scripts/PunkFuncGames/GameTemplate/ (scopes, bootstrapping, gameplay)
Architecture Layers
Presentation (Views/UI)
↓
Application (Controllers/EntryPoints)
↓
Domain (Services/Events)
↓
Infrastructure (Save/Config)
LifetimeScope Hierarchy
ProjectLifetimeScope (Singleton, DontDestroyOnLoad)
├── Registers all module installers
├── MessagePipeOptions shared across all modules
│
├── MainMenuLifetimeScope (scoped to main menu scene)
│ └── Menu-specific registrations
│
└── GameplayLifetimeScope (scoped to gameplay scene)
└── Gameplay-specific registrations
Module Structure
Each module is a UPM package under Packages/ with this layout:
Packages/com.punkfuncgames.<module>/
├── package.json
├── Runtime/PunkFuncGames.<Module>/
│ ├── Config/ # ScriptableObject configs + Data structs
│ ├── Event/ # MessagePipe event structs
│ ├── Installer/ # VContainer installer (static Install method)
│ ├── Model/ # Domain models, containers
│ └── Service/ # Interface + implementation
└── Tests/
├── EditMode/
└── PlayMode/
Cross-module references use #if PUNKFUNC_<MODULE> guards. See docs/MODULE_CATALOG.md for the full package list.
Bootstrapping Flow
Phase-based via BootstrapOrchestrator → IBootstrapPhase:
| Order | Phase | Purpose | |-------|-------|---------| | 0 | AppConfig | Load game settings | | 100 | Logging | Initialize log service | | 200 | Save | Load save data | | 300 | Steam | Initialize Steamworks | | 350 | Localization | Load language files | | 400 | Audio | Initialize audio service | | 450 | ReactiveBindings | Volume auto-save, pause toggling | | 500 | SceneLoad | Load main menu scene | | 1000 | Finalize | Mark bootstrap complete |
Build Scenes
[BOOTSTRAP] → [MAINMENU] → [GAMESCENE]
Assembly Definitions
Each package has its own assembly definitions:
PunkFuncGames.<Module>.asmdef— package runtime codePunkFuncGames.<Module>.Tests.EditMode.asmdef— package unit testsPunkFuncGames.<Module>.Tests.PlayMode.asmdef— package integration tests
Template shell assemblies:
GameTemplate.Runtime.asmdef— template-level code (scopes, bootstrapping)Tests.EditMode.asmdef— template-level unit testsTests.PlayMode.asmdef— template-level integration tests
Module Dependency Map
IdleModule → WalletModule, StatsModule, SaveModule
AchievementModule → UnlockConditionModule, StatsModule, WalletModule, SteamModule
UIModule → LocalizationModule, AssetModule
SceneModule → GameStateModule, AssetModule
AudioModule → SaveModule (volume persistence)
All Modules → LogModule (optional), MessagePipe (events)
Related Skills
punkfuncgames/wallet-module
development
VerifiedTrustedCommunity
WalletModule reference — currency management with BigDouble support, reactive properties, caps, lifetime stats, and persistence. Use when working with currencies, wallets, or financial systems.
SKILL.mdUpdated Apr 16, 2026
punkfuncgames/unlock-condition-module
development
VerifiedTrustedCommunity
UnlockConditionModule reference — composable unlock conditions using ScriptableObjects with AND/OR/NOT logic, stat/currency/upgrade/prestige/gamestate/boolean checks, reactive service layer with progress tracking. Use when implementing unlock systems, gating, or progression requirements.
SKILL.mdUpdated Apr 16, 2026
punkfuncgames/undo-module
development
VerifiedTrustedCommunity
UndoModule reference — command pattern with undo/redo stacks, command merging, and reactive state. Use when implementing undo/redo, undoable actions, or command patterns.
SKILL.mdUpdated Apr 16, 2026
punkfuncgames/ui-toolkit
tools
VerifiedTrustedCommunity
Unity UI Toolkit reference — UXML documents, USS styling, MVVM pattern (ViewModel + Presenter), custom VisualElements, responsive layout, animations, performance guidelines, and complete Figma-to-UI-Toolkit property mapping. Use when building or modifying UI with UI Toolkit, creating UXML/USS files, writing ViewModels or Presenters, designing screens/panels/components, or converting Figma designs to UI Toolkit.
SKILL.mdUpdated Apr 16, 2026