# Repository Index

## Start here

- `README_FIRST_GITHUB_WEB_USERS.md` — non-technical first step
- `START_HERE.html` — friendly local launch page
- `README.md` — public repository README
- `docs/github_web_launch_guide.md` — step-by-step GitHub web upload guide
- `docs/github_pages_troubleshooting.md` — fixes if Pages does not deploy

## GitHub Actions

- `.github/workflows/pages.yml` — tests, builds, and deploys GitHub Pages
- `.github/workflows/tests.yml` — tests and smoke checks

## Public webpage

- `site/index.html` — source homepage
- `site/styles.css` — source styles
- `site/app.js` — source interactivity
- `scripts/build_pages.py` — generates `dist/`

## Local implementation

- `skillos/runtime.py` — agent runtime
- `skillos/storage.py` — SQLite trace/skill store
- `skillos/learning.py` — lesson discovery
- `skillos/trainer.py` — candidate skill generation
- `skillos/evals.py` — Test Lab
- `skillos/releases.py` — Release Center
- `skillos/api.py` — local web server
- `skillos/cli.py` — command line interface

## Product docs

- `docs/architecture.md`
- `docs/production_blueprint.md`
- `docs/type_ii_roadmap.md`
- `docs/vision.md`
- `docs/governance.md`
