Defame1297
6c8ea8e8f0
The previous commit only landed the research-folder rename — a multi-path git add silently failed and left CONTEXT.md, ADR-0012, and the actual skill files unstaged. This lands them: the agentsmd-audit skill itself (three deterministic validators for secrets, structure, and drift against a target repo's AGENTS.md), its bats test suite, provenance record, and the CONTEXT.md/ADR entries documenting why this lives in core rather than kyberforge. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2.1 KiB
2.1 KiB
AGENTS.md tooling lives in core, split into three skills
kyberforge is scoped to meta-tooling for building and maintaining the holocron marketplace itself (skills, agents, plugins, marketplace entries) — not to generic capabilities for an arbitrary target repo. Authoring and reviewing a target repo's AGENTS.md file is repo-agnostic documentation tooling, closer in kind to bin:write-docs or bin:init than to skill-author/plugin-author. Research for this topic was initially placed under plugins/kyberforge/docs/research/docs/agentsmd/ but has moved to plugins/core/docs/research/docs/agentsmd/ to keep the provenance chain consistent with the plugin the resulting skills live in.
Decision
Three skills in the core plugin (core's first active skills):
agentsmd-author— creates/updates a target repo'sAGENTS.md, including nested monorepo placement (nearest-file-wins). Closes out by invokingagentsmd-auditinline, mirroring theskill-author/skill-auditpattern. When it detects an existing provider-specific file (CLAUDE.md, etc.) with content that duplicates what AGENTS.md should own, it callsprovider-adapter-authorvia skill composition.agentsmd-audit— a single combined pass checking three mandatory baselines againstAGENTS.mdonly: secrets/credentials (governance.md hard prohibition), structural completeness (common-sections checklist from the agents.md spec), and accuracy/drift (do referenced commands/paths resolve against the repo). Never inspects provider adapter files.provider-adapter-author— detects and converts a provider-specific instruction file into a thin adapter that importsAGENTS.md(mirroring this repo's own two-tierCLAUDE.mdpattern). Self-validates via its own bundled deterministic script (scripts/validate-adapter.sh) rather than a separate paired audit skill, since the check (import present, no duplicated headings, size threshold) is mechanical.
Consequences
core's plugin.json/README will list real skills for the first time.plugins/kyberforge/docs/research/docs/agentsmd/moves toplugins/core/docs/research/docs/agentsmd/before authoring begins.