Islo Factory examples

Runnable Factory line templates for Islo sandboxes. Each example is a self-contained package: line.toml, jobs, and snapshot recipes.

Quick start (PR review)

The fastest path to a working line:

1. Install the CLI: curl -fsSL https://islo.dev/install.sh | bash
2. Log in: islo login
3. Connect GitHub in the Islo console and select your repository.
4. Edit examples/pr-review/line.toml — replace REPLACE_WITH_OWNER/REPLACE_WITH_REPOSITORY.
5. Deploy:

islo job deploy --path examples/pr-review/jobs/pr-review/job.toml --dry-run
islo job deploy --path examples/pr-review/jobs/pr-review/job.toml
islo factory line validate examples/pr-review/line.toml
islo factory line deploy examples/pr-review/line.toml

6. Open a pull request and inspect islo factory line runs pr-review.

See examples/pr-review/README.md for details.

Examples

Example	Trigger	Outcome
pr-review	GitHub PR opened	Advisory review comment + typed verdict
feature-delivery	Linear label on issue	Implement, review, and verify across a PR set
designer-line	Manual	Storybook design in a retained sandbox, publish on a later steer
qa	Schedule	Parallel black-box QA agents, then a Slack message
red-team-cli	Schedule	White-box + black-box CLI security review
weekly-skills-refresh	Schedule	Refresh agent skills repo from product changes

Each example README covers snapshot build, environment variables, placeholders, deploy order, and cleanup.

Repository layout

examples/<name>/
  README.md          # How to deploy this example
  line.toml          # Factory line manifest
  jobs/<job>/job.toml
  snapshots/<name>/  # Snapshot bake contract + snapshot-src/ (supporting prompts live here)
scripts/
  validate_examples.py

Contributing

See CONTRIBUTING.md. CI runs scripts/validate_examples.py on every pull request.

License

Apache-2.0 — see LICENSE.