rseng-ai-declarationlisted
Install: claude install-skill fdiblen/rseng-agent-skills
# AI usage declaration (aidecl.yaml)
Declaring AI involvement in a machine-readable form is the practice worth
holding to; the AI Declaration Format is one implementation of it, and the
one this skill works through. Any equivalent machine-readable declaration
serves the same purpose. The declaration lives in `aidecl.yaml` at the
project root and follows a published JSON Schema (Draft 2020-12,
schema_version 1.0.0).
Keep it current rather than writing it once: when you - an AI agent -
create or change a project's code, docs, data or configuration, the
declaration should reflect it.
The guiding principle is MAXIMUM HONEST DETAIL. A good declaration lets
a reviewer reconstruct the provenance without asking anyone: which tools
and models touched the work, when, on which parts, for which activities,
in what proportion, under whose review. Prefer the detailed entry to the
terse one, and the honest one to the detailed one. Never fabricate:
declare what happened, and mark estimates as estimates.
## When to act
- No aidecl.yaml in a project you are modifying: create one, add the
README footnote (below), and mention both in your summary.
- COMMIT it. aidecl.yaml is project content: it goes in the same commit as
the work it describes and is never gitignored - a declaration is only
provenance if it ships with the code. If a project must defer that,
record why in .rseng-check-waivers so the gap reads as a decision.
- You made AI-assisted changes: update the declaration in the