AGENTS.md@input/gnn_files/pomdp_gridworld git:20260906.e62b9e9A

Immutable. This exact content is served forever at /api/v1/blob/b736e2a59d52e12d.

# POMDP GridWorld Fixture Agent Guide

## Purpose

This directory contains the maintained GridWorld POMDP fixture used to verify that one GNN model can run through render, execute, analysis, and visualization for PyMDP, RxInfer.jl, and ActiveInference.jl.

## Ownership Boundary

- Keep fixtures small enough for strict local and CI runs.
- Preserve explicit `A/B/C/D/E` matrices and matrix provenance comments.
- Generated render, execute, and analysis artifacts belong under `output/`;
  public root-output refreshes may be staged only after the POMDP output verifier
  passes.

## Public Surfaces

- `pomdp_gridworld_3x3.md` is the canonical cross-framework fixture.
- The transition tensor `B` is stored as `(next_state, previous_state, action)`.
- Runtime metadata uses `num_timesteps: 15`, `random_seed: 42`, and five actions.
- Step 16 emits per-framework PNG plots, belief GIFs, 3x3 trajectory GIFs, a
  cross-framework trajectory GIF, and `gridworld_analysis_manifest.json` from the
  current execution outputs.

## Verification

```bash
uv run --extra dev python src/gnn/main.py --only-steps "3,5,8,11,12,16" --target-dir input/gnn_files/pomdp_gridworld --frameworks "pymdp,rxinfer,activeinference_jl" --verbose
```

For public root-output refreshes, replace `output/` with a fresh full-pipeline
run over `pomdp_gridworld_3x3.md` using `--frameworks all`, then run
`uv run --extra dev python scripts/check_pomdp_gridworld_outputs.py output`
before staging generated artifacts. The checker is the publication gate for
parse, render, execute, analysis, report, website, and summary handoffs.