Skip to content

feat(skills): add frostyard-acmm-conformance skill - #48

Merged
bketelsen merged 1 commit into
mainfrom
skill/acmm-conformance
Aug 12, 2026
Merged

feat(skills): add frostyard-acmm-conformance skill#48
bketelsen merged 1 commit into
mainfrom
skill/acmm-conformance

Conversation

@bketelsen

Copy link
Copy Markdown
Contributor

Summary

Generalizes the ACMM-conformance procedure into a synced agent skill, now that the pattern has been proven twice: core's own conformance (ADR-0029, core#22–#40) and repogen's (repogen ADR-0012, closing repogen#37–#55 via frostyard/repogen#56).

.agents/skills/frostyard-acmm-conformance/SKILL.md covers: inventorying the Hive issues, classifying each criterion (relative symlink to canonical content / real git tree for directory criteria / new artifact doing real work), unifying divergent instruction files into one canonical AGENTS.md, the standard criterion→solution mapping table, porting scripts/check-docs.mjs + .coverage-thresholds.json as the guarding CI gate, registering the alias table in a repo-local ADR (with the stub-swap contingency clause), and verifying through the contents API the way the evaluator does. Pitfalls section records the failure modes hit in practice (symlinked directory criteria, linter config surfacing pre-existing failures, one settings.json satisfying three governance criteria, over-closing mixed issue ranges, fork --repo targeting).

Also:

  • Registers the skill bullet in AGENTS.md's Skills section.
  • Adds it to skills-sync.json defaults so all consuming repos receive it on the next sync (ADR-0026) — ACMM issues land per-repo, so the procedure should already be on hand there.

Risk tier

Risk tier: 1 — documentation/skills only, no code or workflow changes.

Docs housekeeping

  • Conformance aliases (ADR-0029) untouched — canonical targets edited instead (AGENTS.md is the canonical file)
  • No docs/ files touched; skills are not indexed docs.

Verification

  • node scripts/check-docs.mjs green — 33 docs, 204 links, 10 symlinks, all thresholds 1.0 (the new AGENTS.md skill-bullet links resolve)

🤖 Generated with Claude Code

Generalizes the ACMM-conformance procedure proven twice — core's own
conformance (ADR-0029, core#22-#40) and repogen's (repogen ADR-0012,
repogen#37-#55, frostyard/repogen#56) — into a synced skill: inventory
the Hive issues, classify each criterion (symlink to canonical content /
real tree for directory criteria / new artifact doing real work), unify
the instruction surface into AGENTS.md, apply the standard criterion
mapping, wire the docs-integrity gate, register the alias table in a
repo-local ADR, and verify through the contents API the way the
evaluator does. Added to sync defaults so every consuming repo has the
procedure on hand when ACMM issues land (ADR-0026).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@bketelsen
bketelsen merged commit 7283fdd into main Aug 12, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant