AGENTS.md@input/gnn_files/pomdp_gridworld git:20260521.981b085A

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

# 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 ignored output trees.

## 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.

## Verification

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