AGENTS.md git:20261001.ef061dbA

Immutable. This exact content never changes and is served at /api/v1/blob/5f7641c7ec9ca0f1.

# Fallow public skills

This public repository owns portable end-user skills for the released Fallow
product. It does not own Fallow maintainer workflows, private cloud knowledge,
or public user documentation.

## Start here

- Skill content lives under `fallow/skills/`.
- Each skill listed in `source-lock.json` follows the pinned public product
  contract. The lock has one entry per released Fallow skill. Each entry has a
  source root, a target root, and transforms.
- Skills that the lock does not list, such as `fallow-review`, belong to this
  repository. The source contract check ignores them.
- Agent-specific interface files may wrap a skill, but must not fork its
  authored instructions.
- Public user guidance belongs in
  [`fallow-rs/docs`](https://github.com/fallow-rs/docs).
- Open-source maintainer workflows belong in
  [`fallow-rs/fallow`](https://github.com/fallow-rs/fallow).

## Validation

Run:

```bash
node --test scripts/*.test.mjs
python3 -m unittest discover -s scripts -p 'test_*.py'
python3 scripts/validate_skill_frontmatter.py .
FALLOW_SOURCE_DIR=/path/to/pinned/fallow node scripts/check-source-contract.mjs
```

The source contract check fails closed when the pinned source is absent,
incorrect, or has drifted. Never copy private content or machine-local paths
into this repository.

Keep skills concise, use progressive disclosure through direct references, and
require a dry run before destructive Fallow operations.