chore(repo): move agent assets under agents/ and add repo AGENTS.md #12

Merged

w33ble merged 4 commits from chore/move-agent-assets into main

2026-09-17 21:53:15 -06:00

hijynx commented

2026-09-17 21:34:15 -06:00

Collaborator

Summary

Moves AGENTS.md, commands/, and skills/ into agents/, so the repo root holds only tooling and CI config. Pure renames — 107 files at 100% similarity, no content changes.
Updates every path that referenced them: mise.toml tasks, .forgejo/workflows/skills-scan.yaml, and scripts/check_skill_versions.py.
Adds a root AGENTS.md for agents working in this repo: layout, the mise check/validate/scan tasks, and the SkillSpector/Aguara baseline-refresh procedure — relocated out of agents/skills/README.md.
Rewrites README.md as a short human-facing intro with a layout table.

Why

The repo root mixed the consumable assets with the tooling that checks them, and there was no repo-level guide for agents — the scanning procedure lived inside the skills README, where only agents that opened that file would find it.

Notes

agents/AGENTS.md (personal global agent instructions, deployed to ~/.agents/AGENTS.md) is a different document from the new root AGENTS.md; both files say so to avoid confusion.
The .skillspector-baseline.yaml and .aguara-baseline.json baselines are scan-root relative, so they needed no changes — only the task and CI paths did.
Local symlinks into this repo (~/.agents/skills/*, ~/.config/opencode/commands/state-update.md) were relinked; they are outside version control.

Verification

mise run check-skill-versions — PASS (30 skills have metadata.version)
mise run validate-skills — PASS
mise run scan-skills — PASS (skillspector: 0 unbaselined; aguara: 27 findings, 0 new)

## Summary - Moves `AGENTS.md`, `commands/`, and `skills/` into `agents/`, so the repo root holds only tooling and CI config. Pure renames — 107 files at 100% similarity, no content changes. - Updates every path that referenced them: `mise.toml` tasks, `.forgejo/workflows/skills-scan.yaml`, and `scripts/check_skill_versions.py`. - Adds a root `AGENTS.md` for agents working in this repo: layout, the mise check/validate/scan tasks, and the SkillSpector/Aguara baseline-refresh procedure — relocated out of `agents/skills/README.md`. - Rewrites `README.md` as a short human-facing intro with a layout table. ## Why The repo root mixed the consumable assets with the tooling that checks them, and there was no repo-level guide for agents — the scanning procedure lived inside the skills README, where only agents that opened that file would find it. ## Notes - `agents/AGENTS.md` (personal global agent instructions, deployed to `~/.agents/AGENTS.md`) is a different document from the new root `AGENTS.md`; both files say so to avoid confusion. - The `.skillspector-baseline.yaml` and `.aguara-baseline.json` baselines are scan-root relative, so they needed no changes — only the task and CI paths did. - Local symlinks into this repo (`~/.agents/skills/*`, `~/.config/opencode/commands/state-update.md`) were relinked; they are outside version control. ## Verification - `mise run check-skill-versions` — PASS (30 skills have `metadata.version`) - `mise run validate-skills` — PASS - `mise run scan-skills` — PASS (skillspector: 0 unbaselined; aguara: 27 findings, 0 new)

hijynx added 2 commits

2026-09-17 21:34:15 -06:00

chore(repo): move agent assets under agents/ 4fa483a31c

Relocate AGENTS.md, commands/, and skills/ into agents/ so the repo root
holds only tooling and CI config. Update the paths that reference them:
mise tasks, the skills-scan workflow, and scripts/check_skill_versions.py.

Baselines are scan-root relative, so they need no changes.

docs: add root AGENTS.md covering repo layout and skill scanning

skills-scan / validate (pull_request) Successful in 45s

Details

skills-scan / scan (pull_request) Has been cancelled

Details

7e5ffdbd47

Root AGENTS.md is the repo guide for agents working here: layout, the
mise check/validate/scan tasks, and the SkillSpector/Aguara baseline
refresh procedure. That procedure moves out of agents/skills/README.md,
which now points at it; root README.md becomes a short human intro.

Note: agents/AGENTS.md (personal global instructions) is a different
document from this one.

hijynx added 1 commit

2026-09-17 21:36:20 -06:00

docs(agents): sync root AGENTS.md and README with the version-check gate

skills-scan / validate (pull_request) Successful in 41s

Details

skills-scan / scan (pull_request) Has been cancelled

Details

2ab981fad2

main added scripts/check_skill_versions.py, the check-skill-versions mise
task, and a CI validate step. Reflect that: CI is two jobs (validate +
scan), uv/PyYAML and system python3 are used alongside uvx, aguara
v0.27.0 is not mise-managed and must be on PATH, and validate-skills
enforces metadata.version before agentskills runs.

hijynx added 1 commit

2026-09-17 21:39:23 -06:00

chore(repo): move MEMORY-BANK.md into playbooks/

skills-scan / validate (pull_request) Successful in 44s

Details

skills-scan / scan (pull_request) Successful in 2m18s

Details

20642088b2

playbooks/ holds standalone instruction docs you splice into an agent
file rather than install as a skill. Move MEMORY-BANK.md in as the first
one, and list the directory in the AGENTS.md and README layout tables.