AGENTS.md@.agents/skills/percolate-reading · git:20260813.2b114ab · 2026-08-13 · sha256 097a60eb24671e77

AGENTS.md@.agents/skills/percolate-reading git:20260813.2b114abA

Immutable. This exact content never changes and is served at /api/v1/blob/097a60eb24671e77.

# Contents

- `SKILL.md` defines the reviewed capture-to-public-reading workflow.
- `references/entry-format.md` defines the only accepted digest and complete-note schemas.
- `scripts/reading.ts` validates vault evidence and renders the public registry.
- `scripts/sync-reading.ts` exposes generation, drift checking, and inbox reporting.
- `scripts/reading.test.ts` proves validation, privacy, provenance, and atomic-write behavior.
- `agents/openai.yaml` describes the skill in Codex interfaces.

# Guidelines

- Keep the projection deterministic and network-silent. The website must import only the generated module and must never read `kb/` at runtime.
- Treat `reading.status: published` as the sole publication opt-in. Draft notes and unreviewed captures remain private.
- Reject unsupported metadata, unverified quotations, duplicate provenance, tracking URLs, private vault links, and capture state that is unsafe to publish.
- Preserve both supported forms: concise public-article digests and complete reviewed notes with explicit republication basis.
- Run `bun test ./.agents/skills/percolate-reading/scripts` and `bun run reading:check` after changing this workflow.