# TRADING4AI Public Artifact Samples

Secondary reference archive.

This directory contains public artifact package samples for TRADING4AI.

These packages are safe, indexable examples that explain an older artifact structure. Current reliability materials live at `/agent-verification/materials`; use that path first for the active public product surface.

## Sample Packages

### ETH Breakout Playbook

- HTML page: `/samples/artifacts/eth-breakout-playbook`
- Manifest: `/artifact-samples/eth-breakout-playbook/manifest.json`
- README: `/artifact-samples/eth-breakout-playbook/README.md`
- Examples: `/artifact-samples/eth-breakout-playbook/examples.json`
- Evidence pack: `/artifact-samples/eth-breakout-playbook/evidence_pack.json`
- Reference strategy: `/artifact-samples/eth-breakout-playbook/reference_strategy.py`

### BTC Trap Playbook

- HTML page: `/samples/artifacts/btc-trap-playbook`
- Manifest: `/artifact-samples/btc-trap-playbook/manifest.json`
- README: `/artifact-samples/btc-trap-playbook/README.md`
- Examples: `/artifact-samples/btc-trap-playbook/examples.json`
- Evidence pack: `/artifact-samples/btc-trap-playbook/evidence_pack.json`
- Reference strategy: `/artifact-samples/btc-trap-playbook/reference_strategy.py`

## Recommended Reading Path

1. Start with `/agent-verification/materials`.
2. Read `/samples` when you intentionally need the secondary sample archive.
3. Read `/examples` when you want the top-level raw example hub and shared machine entry points.
4. Read `/samples/artifacts`.
5. Read `/examples/artifacts` when you want the raw artifact landing page.
6. Inspect one artifact sample HTML page.
7. Fetch `/examples/artifacts/index.json` when you need the category-level machine-readable artifact catalog.
8. Fetch `/examples/README.md` when you want the top-level plain-text public examples guide.
9. Fetch the raw package files only when exact sample content is needed.

## Core Machine Links

- `/agent-verification/materials`
- `/llms`
- `/llms.txt`
- `/.well-known/agent.json`
- `/for-agents`
- `/samples`
- `/examples`
- `/examples/README.md`
- `/examples/index.json`
- `/examples/artifacts`
- `/examples/artifacts/index.json`
- `/examples/artifacts/README.md`
- `/openapi.json`

## Which Entry Should You Start With?

- Current reliability task: start with `/agent-verification/materials` because it is the active public product surface.
- Crawler or search engine: start with `/samples/artifacts` because it provides crawlable HTML, internal links, and structured data.
- LLM or agent needing compact discovery: start with `/examples/artifacts/index.json` because it gives the category-level machine catalog without parsing HTML.
- LLM needing plain text context: start with `/examples/artifacts/README.md` because it is the category-level Markdown guide for artifact discovery.
- Reader needing the raw package directory guide: start with `/artifact-samples/README.md` because it focuses on the underlying package-file namespace rather than the wider machine surface.
- Agent runtime or tool caller: start with `/agent-verification/materials`, then use `/.well-known/agent.json`, `/for-agents`, and `/llms.txt` before deciding whether category HTML, category JSON, or raw package files are needed.

## 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 wider artifact sample surface, and stay with the raw package guide when package-level file browsing is the main task.

## File Roles

- `manifest.json`: package-level metadata and delivery shape.
- `README.md`: human-readable package overview.
- `examples.json`: public input/output examples.
- `evidence_pack.json`: Strategy Card v2, LEAN-like components, data assumptions, and minimum diagnostics.
- `reference_strategy.py`: illustrative reference implementation, not a production execution engine.

## Boundary

Public artifact samples teach old file structure and package semantics. They are not purchase proof, current delivery proof, or current reliability judgment.

Do not treat these public sample files as executable trading guarantees or current service outputs.