Defame1297/holocron
0
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases 3 Wiki Activity

feat(core): add AGENTS.md authoring/review tooling #80

Merged
Defame1297 merged 9 commits from feat/79-agentsmd-tooling into main 2026-07-23 17:46:09 +00:00
Conversation 1 Commits 9 Files Changed 31 +1497 -4
Claude commented 2026-07-23 17:33:14 +00:00
Collaborator
Copy Link

Summary

  • Adds three new skills to the core plugin — its first active skill content:
    • agentsmd-author — creates/updates a target repo's AGENTS.md, including nested monorepo placement; closes out by invoking agentsmd-audit inline; composes into provider-adapter-author when it detects an existing provider file to reconcile
    • agentsmd-audit — single combined pass checking secrets/credentials, structural completeness, and accuracy/drift against a target repo's AGENTS.md, backed by three deterministic bats-tested scripts
    • provider-adapter-author — converts a provider-specific instruction file (CLAUDE.md, .cursor/rules/*.mdc, copilot-instructions.md) into a thin adapter importing AGENTS.md; self-validates via its own bundled scripts/validate-adapter.sh
  • Bumps core plugin version 1.0.0 → 1.1.0 (both Claude Code and Copilot manifests)
  • Adds docs/adr/0012-agentsmd-tooling-in-core-plugin.md documenting why this tooling lives in core rather than kyberforge (kyberforge is scoped to marketplace-factory meta-tooling, not generic target-repo documentation), and the 3-skill split rationale
  • Fixes 3 stale "ADR-0012" cross-references in CONTEXT.md (introduced earlier in this same work, before ADR-0012 existed) — now correctly point to ADR-0002/ADR-0003
  • Adds plugins/core/README.md (core had none before)
  • Moves research from plugins/kyberforge/docs/research/docs/agentsmd/ to plugins/core/docs/research/docs/agentsmd/ to keep the provenance chain consistent with the plugin the skills live in

Closes #79

Test plan

  • skill-audit clean (zero findings) on agentsmd-author, independently rechecked in a clean-context subagent
  • skill-audit clean (zero findings) on agentsmd-audit, independently rechecked twice (one round-trip fix for a README file-table gap)
  • skill-audit clean (zero findings) on provider-adapter-author, independently rechecked twice (forward-reference to agentsmd-author resolved once that skill was authored)
  • claude plugin validate --strict plugins/core passed
  • bats test suites green: agentsmd-audit (14 tests across validate-secrets.sh/validate-structure.sh/validate-drift.sh), provider-adapter-author (10 tests for validate-adapter.sh)
  • tests/bats submodule pointer verified unchanged (restored after an incidental drift during test runs)

🤖 Generated with Claude Code

## Summary - Adds three new skills to the `core` plugin — its first active skill content: - `agentsmd-author` — creates/updates a target repo's `AGENTS.md`, including nested monorepo placement; closes out by invoking `agentsmd-audit` inline; composes into `provider-adapter-author` when it detects an existing provider file to reconcile - `agentsmd-audit` — single combined pass checking secrets/credentials, structural completeness, and accuracy/drift against a target repo's `AGENTS.md`, backed by three deterministic bats-tested scripts - `provider-adapter-author` — converts a provider-specific instruction file (`CLAUDE.md`, `.cursor/rules/*.mdc`, `copilot-instructions.md`) into a thin adapter importing `AGENTS.md`; self-validates via its own bundled `scripts/validate-adapter.sh` - Bumps `core` plugin version `1.0.0` → `1.1.0` (both Claude Code and Copilot manifests) - Adds `docs/adr/0012-agentsmd-tooling-in-core-plugin.md` documenting why this tooling lives in `core` rather than `kyberforge` (kyberforge is scoped to marketplace-factory meta-tooling, not generic target-repo documentation), and the 3-skill split rationale - Fixes 3 stale "ADR-0012" cross-references in `CONTEXT.md` (introduced earlier in this same work, before ADR-0012 existed) — now correctly point to ADR-0002/ADR-0003 - Adds `plugins/core/README.md` (core had none before) - Moves research from `plugins/kyberforge/docs/research/docs/agentsmd/` to `plugins/core/docs/research/docs/agentsmd/` to keep the provenance chain consistent with the plugin the skills live in Closes #79 ## Test plan - [x] `skill-audit` clean (zero findings) on `agentsmd-author`, independently rechecked in a clean-context subagent - [x] `skill-audit` clean (zero findings) on `agentsmd-audit`, independently rechecked twice (one round-trip fix for a README file-table gap) - [x] `skill-audit` clean (zero findings) on `provider-adapter-author`, independently rechecked twice (forward-reference to `agentsmd-author` resolved once that skill was authored) - [x] `claude plugin validate --strict plugins/core` passed - [x] bats test suites green: `agentsmd-audit` (14 tests across `validate-secrets.sh`/`validate-structure.sh`/`validate-drift.sh`), `provider-adapter-author` (10 tests for `validate-adapter.sh`) - [x] `tests/bats` submodule pointer verified unchanged (restored after an incidental drift during test runs) 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Claude added 8 commits 2026-07-23 17:33:14 +00:00
feat(core): add agentsmd-audit skill 40a045958f 
Audits a target repo's AGENTS.md file(s) for embedded secrets, structural
completeness against the agents.md common-sections checklist, and drift
(referenced commands/paths that no longer resolve). First active skill in
the core plugin — kyberforge is scoped to marketplace-factory meta-tooling,
not generic target-repo documentation (see ADR-0012). Moves the agentsmd
research corpus from plugins/kyberforge to plugins/core to match.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
feat(core): add agentsmd-audit skill files 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>
fix(core): list scripts/ and tests/ READMEs in agentsmd-audit file table 04e7006f76 
Independent clean-context audit recheck flagged that README.md's file
table omitted scripts/README.md and tests/README.md despite both
existing on disk, inconsistent with sibling kyberforge skills.
feat(core): add provider-adapter-author skill 6fd6876264 
Converts a target repo's provider-specific instruction file (CLAUDE.md,
.cursor/rules, copilot-instructions.md, etc.) into a thin adapter over
AGENTS.md, mirroring this repo's own two-tier CLAUDE.md pattern
(ADR-0002/0003). Self-validates via a bundled deterministic script
(scripts/validate-adapter.sh) rather than a separate paired audit skill.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
feat(core): add agentsmd-author skill 956ff7a54a 
Creates/updates a target repo's AGENTS.md by exploring real repo
conventions, supports nested monorepo placement, closes out via
agentsmd-audit, and composes into provider-adapter-author for
provider-file reconciliation. Completes the three-skill trio from
ADR-0012.
chore(core): bump version to 1.1.0 for new skill content d6b0292da7 
core gained three skills for the first time (agentsmd-author,
agentsmd-audit, provider-adapter-author). Minor bump reflects new
capability rather than a fix. Also declares the missing `skills`
path in the Copilot manifest so Copilot CLI discovers them
(CC auto-discovers from the plugin root; Copilot requires explicit
declaration per ADR-0016 convention).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
docs(context): fix stale ADR-0012 references to correct ADR-0002/0003 1fcee54c1e
docs(core): add plugin README 250c486ce1
Defame1297 added 1 commit 2026-07-23 17:42:41 +00:00
feat(core): add content-guide.md to agentsmd-author bb34aa0eb5 
PR review feedback: Step 3 gave no concrete guidance on what good
AGENTS.md content looks like, and the skill had no substantive
references file (only provenance bookkeeping in sources.md), unlike
sibling kyberforge skills. Adds section-by-section content guidance,
the worked example, and monorepo precedence rules synthesized from
the agentsmd research corpus.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Defame1297 approved these changes 2026-07-23 17:45:45 +00:00
Defame1297 merged commit 8abb311cf4 into main 2026-07-23 17:46:09 +00:00
Defame1297 deleted branch feat/79-agentsmd-tooling 2026-07-23 17:46:09 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Defame1297
Labels
Clear labels
Compat/Breaking
Breaking change that won't be backward compatible
 Kind/Bug
Something is not working
 Kind/Documentation
Documentation changes
 Kind/Enhancement
Improve existing functionality
 Kind/Feature
New functionality
 Kind/Security
This is security issue
 Kind/Testing
Issue or pull request related to testing
Priority
Critical
1
The priority is critical
Priority
High
2
The priority is high
Priority
Low
4
The priority is low
Priority
Medium
3
The priority is medium
Reviewed
Confirmed
1
Issue has been confirmed
Reviewed
Duplicate
2
This issue or pull request already exists
Reviewed
Invalid
3
Invalid issue
Reviewed
Won't Fix
3
This issue won't be fixed
Status
Abandoned
3
Somebody has started to work on this but abandoned work
Status
Blocked
1
Something is blocking this issue or pull request
Status
Need More Info
2
Feedback is required to reproduce issue or to continue work
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Claude renovate-bot Defame1297
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Defame1297/holocron#80
Delete Branch "feat/79-agentsmd-tooling"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?