> For the complete documentation index, see [llms.txt](https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/.spec_system/archive/sessions/phase37-session06-g7-player-animation/tasks.md).

# Task Checklist

**Session ID**: `phase37-session06-g7-player-animation` **Total Tasks**: 20 **Estimated Duration**: 3-4 hours **Created**: 2026-06-29

***

Legend: `[x]` completed; `[ ]` pending; `[P]` parallelizable; `[SNNMM]` session ref; `TNNN` task ID.

***

## Progress Summary

| Metric          | Value                          |
| --------------- | ------------------------------ |
| Tasks Completed | 20 / 20                        |
| Current Branch  | rejected G7 direct runtime use |
| Last Updated    | 2026-06-29 07:45               |

***

## Setup (3 tasks)

* [x] T001 \[S3706] Verify G7 source, alpha derivative, crop manifest, gameplay/UI atlas outputs, docs preview, packer prerequisites, current player render path, and baseline runtime tests before edits (`docs/ongoing-projects/generated/ai-rogue-visual-audio-assets/source/ai-rogue-player-animation-source.png`, `docs/ongoing-projects/generated/ai-rogue-visual-audio-assets/alpha/ai-rogue-player-animation-alpha.png`, `docs/ongoing-projects/generated/ai-rogue-visual-audio-assets/crop-manifest.json`, `src/assets/ai-rogue/gameplay-atlas.json`, `src/assets/ai-rogue/ui-atlas.json`, `scripts/extensions/ai-rogue/pack-visual-assets.py`, `src/extensions/ai-rogue/runtime/render-model.ts`, `src/extensions/ai-rogue/runtime/renderer-sprites.ts`, `src/extensions/ai-rogue/runtime/renderer.ts`)
* [x] T002 \[S3706] Create the G7 implementation ledger with baseline evidence, downscale review criteria, ship-or-redraw decision log, validation commands, desktop proof, mobile proof, and branch-specific outcome notes (`.spec_system/specs/phase37-session06-g7-player-animation/implementation-notes.md`)
* [x] T003 \[S3706] Generate docs-only 16x16 downscale evidence for side-facing, idle, walk, Strike, Surge cast, hurt/recovery, and optional low-HP G7 candidates (`docs/extensions/ai-rogue/generated/ai-rogue-g7-player-downscale-review.png`, `docs/ongoing-projects/generated/ai-rogue-visual-audio-assets/source/ai-rogue-player-animation-source.png`, `docs/ongoing-projects/generated/ai-rogue-visual-audio-assets/alpha/ai-rogue-player-animation-alpha.png`)

***

## Foundation (5 tasks)

* [x] T004 \[S3706] Record accepted or rejected G7 player crop decisions with explicit 16x16 readability, footprint, alpha, no-baked-text, and ship-or-redraw notes (`docs/ongoing-projects/generated/ai-rogue-visual-audio-assets/crop-manifest.json`)
* [x] T005 \[S3706] Run the visual packer only if G7 frames are accepted and refresh gameplay atlas output plus docs preview while preserving the two-atlas model and media-policy caps (`scripts/extensions/ai-rogue/pack-visual-assets.py`, `src/assets/ai-rogue/gameplay-atlas.png`, `src/assets/ai-rogue/gameplay-atlas.json`, `src/assets/ai-rogue/ui-atlas.png`, `src/assets/ai-rogue/ui-atlas.json`, `docs/extensions/ai-rogue/generated/ai-rogue-production-atlas-preview.png`)
* [x] T006 \[S3706] Add accepted G7 player frame-name unions, constants, and required gameplay frame groups, or preserve existing player contracts when rejected with types matching declared contracts and exhaustive enum handling (`src/extensions/ai-rogue/runtime/types-assets.ts`, `src/extensions/ai-rogue/runtime/assets.ts`)
* [x] T007 \[S3706] \[P] Update atlas metadata tests for accepted G7 frame counts, TexturePacker metadata, required frame membership, or rejected branch contract preservation (`src/extensions/ai-rogue/runtime/__tests__/assets.test.ts`)
* [x] T008 \[S3706] \[P] Update simulation tests proving movement, facing, Strike, Surge, hurt/recovery, player footprint, and player frame state remain deterministic (`src/extensions/ai-rogue/runtime/__tests__/simulation.test.ts`)

***

## Implementation (7 tasks)

* [x] T009 \[S3706] Add player frame selection only for accepted G7 frames, preserving 16x16 source footprint, product-facing labels, and existing static fallback when rejected (`src/extensions/ai-rogue/runtime/render-model.ts`)
* [x] T010 \[S3706] Add renderer sprite animation only for accepted G7 idle and movement frames with cleanup on scope exit for all acquired resources and reduced-motion fallback (`src/extensions/ai-rogue/runtime/renderer-sprites.ts`)
* [x] T011 \[S3706] Wire accepted player animation into the renderer after sprite sync without changing command dispatch, tween positioning, reset, load, resize, destroy, or input semantics (`src/extensions/ai-rogue/runtime/renderer.ts`)
* [x] T012 \[S3706] Wire accepted Strike, Surge cast, hurt, recovery, and optional low-HP presentation through existing event/effects timing without changing combat rules or status semantics (`src/extensions/ai-rogue/runtime/effects.ts`, `src/extensions/ai-rogue/runtime/render-model.ts`)
* [x] T013 \[S3706] \[P] Update render-model tests for accepted G7 facing, frame-selection, health/action fallback, stable dimensions, reduced-motion expectations, or rejected baseline stability (`src/extensions/ai-rogue/runtime/__tests__/render-model.test.ts`)
* [x] T014 \[S3706] \[P] Update renderer lifecycle tests for player animation cycling, reduced-motion static frames, missing-texture fallback, cleanup, and no inactive sprite leaks (`src/extensions/ai-rogue/runtime/__tests__/renderer-lifecycle.test.ts`)
* [x] T015 \[S3706] \[P] Update desktop/mobile browser specs for accepted G7 runtime readability or rejected no-op baseline, with product-facing copy only and diagnostics confined to tests/docs (`tests/e2e/ai-rogue-runtime.spec.ts`, `tests/e2e/ai-rogue-mobile.spec.ts`)

***

## Testing (5 tasks)

* [x] T016 \[S3706] Run packer when applicable, typecheck, asset-size validation, and diff whitespace checks, then record command results (`scripts/extensions/ai-rogue/pack-visual-assets.py`, `bun run typecheck`, `scripts/check-asset-sizes.sh`, `git diff --check`)
* [x] T017 \[S3706] Run focused Vitest suites for assets, render-model, renderer lifecycle, and simulation behavior touched by the chosen G7 branch (`src/extensions/ai-rogue/runtime/__tests__/assets.test.ts`, `src/extensions/ai-rogue/runtime/__tests__/render-model.test.ts`, `src/extensions/ai-rogue/runtime/__tests__/renderer-lifecycle.test.ts`, `src/extensions/ai-rogue/runtime/__tests__/simulation.test.ts`)
* [x] T018 \[S3706] Run desktop AI Rogue browser proof for readable accepted G7 player animation or unchanged rejected baseline (`tests/e2e/ai-rogue-runtime.spec.ts`)
* [x] T019 \[S3706] Run mobile AI Rogue browser proof for 16x16 readability, reduced-motion behavior, compact controls, no horizontal overflow, and no product-copy diagnostics (`tests/e2e/ai-rogue-mobile.spec.ts`)
* [x] T020 \[S3706] Update visual asset documentation, implementation notes, ASCII/LF evidence, final ship-or-redraw result, and phase closeout readiness (`docs/extensions/ai-rogue/visual-assets.md`, `.spec_system/specs/phase37-session06-g7-player-animation/implementation-notes.md`)

***

## Completion Checklist

* [x] All tasks marked `[x]`
* [x] All tests and checks passing
* [x] All files ASCII-encoded with LF line endings
* [x] implementation-notes.md updated
* [x] Ready for `creview` to start the creview -> validate sequence

***

## Next Steps

Run the `creview` workflow step.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/.spec_system/archive/sessions/phase37-session06-g7-player-animation/tasks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.