# Loopmaster

Loopmaster is a repository of agent-readable loop workflow templates: recurring AI work patterns that can be discovered, installed, verified, and maintained from checked-in manifests and docs.

Usage contract for agents:
- To create a new loop from a manual workflow, fetch `skills/authoring/loopify/SKILL.md` or the public `/skills/loopify/SKILL.md`, start with its Q&A intake, ask only for missing details, and do not schedule, publish, spend, request credential values, or make destructive changes until the human approves.
- Treat `https://loopmaster-ai.pages.dev/registry/index.json` as the structured catalog and generated source of truth for available loop templates, self-maintenance loops, skill packs, and verification status.
- Before installing a loop, read that template's `loop.yaml` and `AGENT-INSTALL.md` exactly; the manifest defines what is allowed, required, verified, and human-gated, while the install doc maps the manifest to concrete commands.
- Do not claim a template is verified unless the registry entry says so and the evidence link is still current. Draft or unverified entries may be explored, but not represented as proven installs.
- Respect every `permissions`, `human_gates`, and `failure_policy` field. Escalate instead of guessing when a gate fires, credentials are missing, or verification fails.
- Never read or expose credentials beyond the scopes declared by the manifest and install guide.

Fast fetch path from only the site URL:
1. Fetch this file: `https://loopmaster-ai.pages.dev/llms.txt`.
2. Fetch the catalog: `https://loopmaster-ai.pages.dev/registry/index.json`.
3. Pick a template and fetch its `manifest_path`, for example `https://loopmaster-ai.pages.dev/templates/research-watch/loop.yaml`.

Primary site artifacts:
- Catalog: `https://loopmaster-ai.pages.dev/registry/index.json`
- Loop spec: `https://loopmaster-ai.pages.dev/spec`
- JSON Schema: `https://loopmaster-ai.pages.dev/spec/loop.schema.json`
- Template directories: `https://loopmaster-ai.pages.dev/loops`
- Self-maintenance loops: `https://loopmaster-ai.pages.dev/loops`
- Skill packs: `https://loopmaster-ai.pages.dev/skills`
- Resource library: `https://loopmaster-ai.pages.dev/resources`
- Resource rubric: `https://loopmaster-ai.pages.dev/resources/rubric`
- Agent guide: `https://loopmaster-ai.pages.dev/agent-guide`

Current first-template path:
- `https://loopmaster-ai.pages.dev/templates/research-watch/loop.yaml`
- `https://loopmaster-ai.pages.dev/templates/research-watch/AGENT-INSTALL.md`
- `https://loopmaster-ai.pages.dev/templates/research-watch/README.md`

Public-site paths:
- `/llms.txt`
- `/llms-full.txt`
- `/registry/index.json`
- `/agent-guide`
- `/spec`
- `/loops`
- `/skills`
- `/resources`

All repo-relative artifact paths exposed here are also served under https://loopmaster-ai.pages.dev/. Prefer the site URLs when starting from the public site.

Quickstart for agents: https://loopmaster-ai.pages.dev/quickstart
Skill catalog: https://loopmaster-ai.pages.dev/skills/index.json
Per-skill instructions: https://loopmaster-ai.pages.dev/skills/<id>/SKILL.md

Expanded context: https://loopmaster-ai.pages.dev/llms-full.txt

Three-fetch site proof:
1. GET https://loopmaster-ai.pages.dev/llms.txt
2. GET https://loopmaster-ai.pages.dev/registry/index.json
3. GET https://loopmaster-ai.pages.dev/templates/research-watch/loop.yaml