# TRADING4AI Artifact Public Examples

This directory is the artifact-specific plain-text guide inside the `/examples` namespace.

Current reliability materials live at `/agent-verification/materials`; this category is secondary reference.

Use it when a crawler, LLM, agent, or integration operator needs a compact Markdown overview of the public artifact sample layer without parsing the full website UI.

These files are examples only. They describe older artifact package structure and public sample contents, but they do not grant protected access or prove current service output.

## Primary Entry Points

- Current reliability materials: https://trading4ai.com/agent-verification/materials
- Category HTML landing: https://trading4ai.com/samples/artifacts
- Category raw landing: https://trading4ai.com/examples/artifacts
- Category JSON catalog: https://trading4ai.com/examples/artifacts/index.json
- Category Markdown guide: https://trading4ai.com/examples/artifacts/README.md
- Artifact raw package guide: https://trading4ai.com/artifact-samples/README.md
- Top-level JSON catalog: https://trading4ai.com/examples/index.json
- Top-level Markdown guide: https://trading4ai.com/examples/README.md
- Machine bridge: https://trading4ai.com/llms
- Agent entry point: https://trading4ai.com/.well-known/agent.json
- Legacy runtime snapshot: https://trading4ai.com/openapi.json

## Files

- `/samples`
- `/examples`
- `/examples/README.md`
- `/samples/artifacts`
- `/examples/artifacts`
- `/examples/artifacts/index.json`
- `/examples/artifacts/README.md`
- `/examples/index.json`
- `/llms.txt`
- `/artifact-samples/README.md`
- `/artifact-samples/eth-breakout-playbook/manifest.json`
- `/artifact-samples/eth-breakout-playbook/README.md`
- `/artifact-samples/eth-breakout-playbook/examples.json`
- `/artifact-samples/eth-breakout-playbook/reference_strategy.py`
- `/artifact-samples/btc-trap-playbook/manifest.json`
- `/artifact-samples/btc-trap-playbook/README.md`
- `/artifact-samples/btc-trap-playbook/examples.json`
- `/artifact-samples/btc-trap-playbook/reference_strategy.py`
- `/llms`
- `/.well-known/agent.json`
- `/for-agents`
- `/openapi.json`

## Recommended Flow

1. Start with `/agent-verification/materials` for current agent-facing reliability work.
2. Start with `/samples` when you want the top-level HTML public sample hub.
3. Read `/examples` when you want the top-level raw example hub and shared machine entry points.
4. Read the artifact HTML overview at `/samples/artifacts`.
5. Read `/examples/artifacts` when you want the raw category landing page with discovery guidance.
6. Inspect one artifact sample HTML page such as `/samples/artifacts/eth-breakout-playbook`.
7. Fetch `/examples/artifacts/index.json` if you need the category-level machine-readable artifact catalog.
8. Fetch `/artifact-samples/README.md` if you want the raw artifact directory guide.
9. Fetch raw package files only when exact sample package content is needed.

## Which Entry Should You Start With?

- Crawler or search engine: start with `/samples/artifacts` when this secondary archive is needed.
- LLM or agent needing compact discovery: start with `/examples/artifacts/index.json`.
- LLM needing plain text context: start with `/examples/artifacts/README.md`.
- Reader needing the raw artifact package directory: start with `/artifact-samples/README.md`.
- Tool caller: start with `/.well-known/agent.json`, then use `/llms.txt` and `/for-agents` for static discovery and access-boundary guidance.
- Current reliability task: start with `/agent-verification/materials`, not this sample archive.

## Guide Roles

- `/examples/artifacts/README.md` is the category-level plain-text discovery guide for artifact samples.
- `/artifact-samples/README.md` is the raw package directory guide for the underlying artifact file namespace.
- Use the category guide first when you need navigation across the artifact sample surface, and use the raw package guide when you already know you need package-level file browsing.

## File Roles

- `manifest.json`: package-level metadata and delivery shape.
- `README.md`: human-readable package overview for the public sample package.
- `examples.json`: public example inputs and outputs.
- `reference_strategy.py`: illustrative reference implementation, not a production execution engine.

## Boundary

No live request, order, payment, entitlement, or delivery flow is implied by these public examples.

Artifact public examples teach structure, file roles, and package semantics. They are not current Financial Agent Reliability Materials and should not be cited as current service outputs.

Use `/openapi.json` only when intentionally reviewing the legacy runtime snapshot.

For current Pages-only public work, use `/agent-verification/materials`, `/llms.txt`, and `/.well-known/agent.json`.