# State 003 Learning Guide

> For the complete documentation index, see [llms.txt](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/llms.txt).

## Position In Learning Graph

*   Previous state(s): [002-edge-proxy-uncontainerized](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-002-edge-proxy-uncontainerized.md)
*   Dotted-line parent(s): none
*   Next state(s): [004-containerized-compose-runtime](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-004-containerized-compose-runtime.md)

## Convergence Metadata

*   Convergence state: `no`
*   Convergence level: `none`
*   Lineage role: `prelude`
*   Nearest previous convergence: `none`
*   Nearest next convergence: `none`

## Rendered Code

*   Generated branch: [code/generated-state-003-agentic-harness-foundation](https://github.com/finos/traderX/tree/code/generated-state-003-agentic-harness-foundation)
*   Authoring branch (spec source): [main](https://github.com/finos/traderX/tree/main)

## Code Comparison With Previous State

*   Compare against `002-edge-proxy-uncontainerized`: [code/generated-state-002-edge-proxy-uncontainerized...code/generated-state-003-agentic-harness-foundation](https://github.com/finos/traderX/compare/code%2Fgenerated-state-002-edge-proxy-uncontainerized...code%2Fgenerated-state-003-agentic-harness-foundation)

## Plain-English Code Delta

*   **Added:** Generated codebase root includes `AGENTS.md` with agent operating contract.
*   **Added:** Generated codebase root includes `ARCHITECTURE.md` summarizing module boundaries and extension points.
*   **Added:** Generated codebase root includes `CONTRIBUTING.md` clarifying generated snapshot contribution policy.
*   **Changed:** State lineage introduces a new prelude state before containerized compose baseline.
*   **Flow Impact:** No runtime endpoint or service-flow changes compared with state `002`.
*   **Flow Impact:** Development workflow gains explicit agent guidance and contribution boundary in generated outputs.

## Run This State

```bash
./scripts/start-state-003-agentic-harness-foundation-generated.sh
```

## Canonical Spec Links

*   State spec pack: [/specs/agentic-harness-foundation](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/agentic-harness-foundation.md)
*   Architecture: [/specs/agentic-harness-foundation/system/architecture](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/agentic-harness-foundation/system/architecture.md)
*   Flows / topology: [/specs/agentic-harness-foundation/system/runtime-topology](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/agentic-harness-foundation/system/runtime-topology.md)
*   Research: [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/agentic-harness-foundation/research.md)
*   Data model: [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/agentic-harness-foundation/data-model.md)
*   Quickstart: [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/agentic-harness-foundation/quickstart.md)