feat: Organize context files and enhance documentation for clarity and structure

ai/context/index.md

@@ -0,0 +1,60 @@
+# Context Index
+
+## Goal
+
+Keep stable Fidelity context organized by domain so the agent can load the right information quickly.
+
+---
+
+## Structure
+
+### `project.md`
+
+High-level overview of the workspace, current Fidelity scope, and where durable context lives.
+
+### `systems/`
+
+Stable context about core product components and how they relate:
+
+- [systems/fid4.md](./systems/fid4.md)
+- [systems/xflowsdk.md](./systems/xflowsdk.md)
+- [systems/xflowviewmaker.md](./systems/xflowviewmaker.md)
+- [systems/ftframeworks.md](./systems/ftframeworks.md)
+
+### `workstreams/`
+
+Durable context about recurring streams of work and investigation:
+
+- [workstreams/rest-migration.md](./workstreams/rest-migration.md)
+- [workstreams/ao-discourse.md](./workstreams/ao-discourse.md)
+- [workstreams/xflow-debugging.md](./workstreams/xflow-debugging.md)
+- [workstreams/xflow-swiftui-migration.md](./workstreams/xflow-swiftui-migration.md)
+- [workstreams/consumer-integration.md](./workstreams/consumer-integration.md)
+
+### `process/`
+
+Rules and expectations for how work should be communicated and maintained:
+
+- [process/communication.md](./process/communication.md)
+- [process/jira-story-rules.md](./process/jira-story-rules.md)
+- [process/context-maintenance.md](./process/context-maintenance.md)
+
+### `people/`
+
+Named people, role mapping, and collaboration context:
+
+- [people/index.md](./people/index.md)
+- [people/manager.md](./people/manager.md)
+
+### `decisions/`
+
+Confirmed technical or product decisions with ongoing impact.
+
+---
+
+## Usage
+
+- Load `project.md` and this index first.
+- Open `systems/` when the question is about architecture, ownership, or integration.
+- Open `workstreams/` when the question is about current priorities, debugging themes, or historical project patterns.
+- Open `process/` when drafting messages, standups, Jira notes, or deciding how to update memory.