AGENTS.md ยท diff
git:20260905.e0d8416 to git:20261001.ef061db
5 added, 2 removed. Audit A to A.
# 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/`.
- - `fallow/skills/fallow/` follows the pinned public product contract in
- `source-lock.json`.
+ - 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.