# START HERE — A2X Workshop Resources

This repo is the public, attendee-safe resource bundle for tomorrow's A2X Claude Code / agent workflow workshop.

## Use these first

1. **OpenSpec setup:** [`HowTo-OpenSpec.md`](HowTo-OpenSpec.md)
2. **LLM Wiki with Claude Code:** [`llm-wiki/HowTo-LLM-Wiki.md`](llm-wiki/HowTo-LLM-Wiki.md)
3. **LLM-Wiki raw source chooser:** [`llm-wiki/raw-sources/`](llm-wiki/raw-sources/) — use `memory/` for the agent-memory synthesis demo and `kids-books/` for simple ingestion practice.
4. **Karpathy original LLM Wiki Markdown copy:** [`llm-wiki/local-copies/karpathy-llm-wiki.md`](llm-wiki/local-copies/karpathy-llm-wiki.md)
5. **OpenSpec example workspace:** [`Examples/OpenSpec/`](Examples/OpenSpec/)
6. **A2X public marketplace links:** [`A2X-public-marketplace/`](A2X-public-marketplace/)
7. **Curated library of existing artifacts:** [`Library/`](Library/)

## What is in here

- `HowTo-OpenSpec.md` — basic setup instructions for OpenSpec-style proposal/spec workflows.
- `llm-wiki/` — LLM-Wiki guide, Karpathy local copy, legacy HTML pages, and the raw source chooser for memory synthesis or children’s story ingestion demos.
- `Examples/OpenSpec/` — intentionally empty tree for Tomer to fill during or after the workshop.
- `A2X-public-marketplace/` — marketplace links and workshop-safe material while the full marketplace package is organized.
- `Library/` — curated index of the older generated handouts and demos, sorted into useful buckets.
- `resources/` — the underlying HTML artifact files used by the library. This folder is intentionally not the starting point.
- `docs/` — project notes, audits, and historical operating documents.
- `scripts/` — local verification scripts.

## What not to do tomorrow

Do not start from the full `resources/` folder. It has many artifacts and can overwhelm attendees.

For the workshop, start with this file, then use only the specific handouts needed for the moment.

## Public safety rule

This repository is public. Do not add secrets, credentials, private client material, internal links, local machine paths, private repo URLs, or personal notes that are not intended for attendees.