Skill: mike007jd/game-architecture-maintainability-audit (version 1.0.0)

--- name: game-architecture-maintainability-audit description: Audit architecture, state management, boundaries, coupling, and maintainability risks that will make future AI or human iteration harder. license: MIT compatibility: Claude Code and Codex. Best results with file read/write access; shell/build access improves evidence quality. metadata: author: game-superpowers version: "1.1.0" domain: game-development --- # Game Architecture Maintainability Audit ## Goal Audit technical structure and changeability, especially where future iteration will become painful. ## Deliverables Update: - `docs/game-studio/audit/audit-summary.md` - `docs/game-studio/audit/scorecard.json` - `docs/game-studio/audit/risk-register.md` Use: - `./shared/checklists/architecture-maintainability-audit-checklist.md` - `./shared/reference/game-dev-abstractions.md` ## Evaluate - state management clarity - coupling between UI, gameplay, systems, and content - module boundaries and change surfaces - hidden complexity and implicit contracts - where future AI edits are likely to rot the codebase

path: CHANGELOG.md
content: # Changelog

## 1.1.0 — 2026-03-30

- Initial ClawHub publish bundle generated from `skills/game-architecture-maintainability-audit/SKILL.md`.
- Added bundle metadata, README, and MANIFEST for OpenClaw / ClawHub distribution.


path: MANIFEST.yaml
content: bundle: game-architecture-maintainability-audit
bundle_version: 1.1.0
bundle_date: 2026-03-30
description: >
  Audit architecture, state management, boundaries, coupling, and maintainability risks that will make future AI or human iteration harder.
compatibility:
  designed_for:
    surfaces:
      - chat
      - cli
      - ide
    capabilities:
      - local filesystem access
      - markdown skill bundles
      - reusable game-development workflows
  tested_on:
    - platform: OpenClaw
      surface: ClawHub
      status: pending
      date: 2026-03-30
    - platform: Claude Code
      surface: CLI
      status: pass
      date: 2026-03-30
    - platform: Codex
      surface: CLI
      status: pass
      date: 2026-03-30
  spec_version: agentskills.io/1.0
  frontmatter_mode: metadata
dependencies:
  []
files:
  - path: CHANGELOG.md
    role: reference
    version: 1
    hash: sha256:1419f7a2e8e0388acdc76312b591ac0d41e05ceba5d323682c089edee09919c6
    note: Bundle release notes
  - path: README.md
    role: reference
    version: 1
    hash: sha256:34c0442f467deeff944e0c1afefc9d7d52e5730a83e4417fc434abd928741df7
    note: ClawHub-facing usage and context
  - path: SKILL.md
    role: skill
    version: 1
    hash: sha256:30127f14aacdb7856737c1ffdedc4e487ccb2f9a4bf5d3592fe5267ce587d2f7
    note: Canonical skill definition for this publish bundle
  - path: examples/usage.md
    role: reference
    version: 1
    hash: sha256:bab01defefa3788fde42dfaca5b37cfff424ef08dbab580dc72657a2fe92df57
    note: Referenced support file: examples/usage.md
  - path: shared/checklists/architecture-maintainability-audit-checklist.md
    role: reference
    version: 1
    hash: sha256:c63a63cf9d5e573b04660c783724771aa5a3a84a76581ac5e5a4c9be15563377
    note: Referenced support file: shared/checklists/architecture-maintainability-audit-checklist.md
  - path: shared/reference/game-dev-abstractions.md
    role: reference
    version: 1
    hash: sha256:95e105fc940e146db363a5b48a5526244c161ec25144f21e558a3fed371ba1df
    note: Referenced support file: shared/reference/game-dev-abstractions.md
  - path: tests/smoke.md
    role: reference
    version: 1
    hash: sha256:8b74eb12ed9b8393300eadc087f41e519ef2ecb8876ebeb0528901e603bb42e5
    note: Referenced support file: tests/smoke.md


path: README.md
content: # game-architecture-maintainability-audit

Part of the **Game Superpowers** skill system.

## Summary

Audit architecture, state management, boundaries, coupling, and maintainability risks that will make future AI or human iteration harder.

## Recommended usage

- Use `game-architecture-maintainability-audit` for this game project and keep the output evidence-based.
- Apply `game-architecture-maintainability-audit` to improve or assess an existing browser game in a focused way.
- Use `game-architecture-maintainability-audit` as part of a larger Game Superpowers workflow when the request clearly matches game architecture maintainability audit.

## Companion skills

- None

## Source of truth

This publish bundle is derived from the Game Superpowers source repository.
Canonical authoring lives in:

```text
skills/game-architecture-maintainability-audit/SKILL.md
```

## Notes

- This bundle is published for OpenClaw / ClawHub distribution.
- The Game Superpowers repository also supports Claude Code and Codex distributions.
- If a workflow references companion skills, install those companion skills as separate bundles.


path: examples/usage.md
content: # Usage Examples

## Example prompts

- Use `game-architecture-maintainability-audit` for this game project and keep the output evidence-based.
- Apply `game-architecture-maintainability-audit` to improve or assess an existing browser game in a focused way.
- Use `game-architecture-maintainability-audit` as part of a larger Game Superpowers workflow when the request clearly matches game architecture maintainability audit.

## Expected behavior

- Load the skill instructions from `SKILL.md`.
- Use any packaged `shared/` references when the skill body points to them.
- If the workflow calls for companion skills, tell the user which companion skills should be installed or invoked next.


path: shared/checklists/architecture-maintainability-audit-checklist.md
content: # Architecture Maintainability Audit Checklist
- UI and gameplay concerns are not hopelessly tangled
- state is not hidden in too many places
- important contracts are explicit enough
- future edits will not be unusually fragile


path: shared/reference/game-dev-abstractions.md
content: # Game-dev abstractions

Prefer these abstractions in plans and code organization when they fit:

- `GameManager`
- `InputGrammar`
- `PlayerController`
- `CameraRig`
- `StateMachine`
- `EncounterDirector`
- `ProgressionModel`
- `HUDFlow`
- `FeedbackLayer`
- `SoundLayer`
- `SaveModel`
- `BackendProfile`

Do not overfit the top-level architecture to one specific renderer or framework unless the project already commits to it.


path: tests/smoke.md
content: # Smoke Test

Bundle: `game-architecture-maintainability-audit`
Version: `1.1.0`

## Prompt

Use `game-architecture-maintainability-audit` on a fitting game-development task.

## Expected checks

- The agent recognizes the skill's stated purpose.
- The agent uses packaged references when `SKILL.md` points to `./shared/...`.
- The agent does not claim companion skills are bundled implicitly when they are separate installs.
- Companion skills referenced in this bundle: none


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)