Recounted from the filesystem: 90 plugins (87 local + 3 external),
161 skills across 45 plugins. Also catches docs/usage.md and
docs/plugins.md install-note lines missed by earlier syncs.
Addresses review feedback on #576:
- convert.sh: feed the base64 payload to jq via --rawfile (temp file) instead
of --arg, so inputs larger than ~96KB no longer hit the OS per-argument
limit (MAX_ARG_STRLEN). Verified with a 164KB input (219KB base64).
- convert.sh: reject absolute and home-relative (~) user-supplied output paths
in addition to traversal, since OUT is written with curl -o. The auto-derived
default still works for absolute inputs (validation only applies to an
explicit output arg).
- docs: add file-conversion to docs/plugins.md (Utilities, now 5) and bump the
plugin count 84 -> 85 (83 local + 2 external) across README.md, AGENTS.md,
ARCHITECTURE.md, docs/architecture.md, docs/plugins.md, docs/usage.md.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Add Claude Fable 5 (model: fable) as the tier above opus across the
adapter framework - native passthrough in Claude Code, mapped to each
harness's top model elsewhere. No agents are promoted yet; tier criteria
and cost guidance are documented in docs/agents.md and docs/authoring.md.
Refresh MODEL_ALIASES against current harness catalogs (June 2026):
- Codex: gpt-5 family -> gpt-5.5 / gpt-5.4-mini (per Codex model docs)
- Copilot: GPT-5 stand-ins -> native Claude models (claude-opus-4.8,
claude-sonnet-4.6, claude-haiku-4.5) now that Copilot CLI serves them
- OpenCode: opus -> anthropic/claude-opus-4-8; haiku dated pin ->
latest-tracking anthropic/claude-haiku-4-5
- Gemini: intentionally stays on GA gemini-2.5-* (3.x is preview-gated)
- plugin-eval judge opus tier -> claude-opus-4-8
Gates: generate-all (no committed drift), validate STRICT=1, garden,
test (442 passed), smoke-test all green.
PR #558 updated the headline totals but left trailing references at
83/191/155 across README, AGENTS.md, GEMINI.md, ARCHITECTURE.md, and
docs/*. Sync them all to the true counts (82 local + 2 external = 84
plugins, 192 agents, 156 skills).
Also runs make generate-all to bring the committed harness registries in
sync — adds the social-publishing entries to .agents/ and .cursor-plugin/
(which the original PR could not regenerate) and fixes the stale count in
the generated cursor manifests.
Left round-trip-results.md (point-in-time CLI verification results) and
plugin-eval.md (grade threshold) unchanged.
Add lean, native plugin-install entry points so each harness's own plugin
manager can install this marketplace (mirroring obra/superpowers) — committing
only small JSON registries, not duplicated skill/agent content trees.
- Codex: committed marketplace registry (.agents/plugins/marketplace.json) +
per-plugin manifests (plugins/*/.codex-plugin/plugin.json). Entries point at
source ./plugins/<name>; Codex reads SKILL.md directly. Transformed
.codex/skills|agents stay gitignored.
- Cursor: commit the existing .cursor-plugin/ marketplace + .cursor/rules/
(these already point at source plugins/).
- Gemini: gemini-extension.json already committed (contextFileName: AGENTS.md);
transformed trees stay gitignored (install via clone + make generate).
- OpenCode: unchanged — install via `make install-opencode` (transformed tree
stays gitignored).
- CLAUDE.md is now a symlink to AGENTS.md; Claude-Code addenda moved to
docs/harnesses.md.
- CI: new step fails if `make generate-all` drifts from the committed registries.
Net new committed: ~720 KB of manifests (no skill/agent duplication). Adds
round-trip tests for the new registries + the symlink. Docs updated across
README, docs/harnesses.md, ARCHITECTURE.md, CONTRIBUTING.md, GEMINI.md,
docs/authoring.md, and the PR template.
* feat: AGENTS.md canonical context + OpenAI harness-engineering layout
Promote AGENTS.md to the committed cross-harness context file (per the
agents.md convention and OpenAI's harness-engineering blog). Harness-
specific files become thin redirects:
- AGENTS.md — canonical, committed (~74 lines, table-of-contents)
- CLAUDE.md — `@AGENTS.md` import + Claude-specific addenda
- GEMINI.md — Gemini-specific setup only
- .gemini/settings.json — redirects Gemini CLI's context to read AGENTS.md
- ARCHITECTURE.md — new at root, top-level architectural map
- gemini-extension.json — bumps version to 1.7.0, sets contextFileName: AGENTS.md
- .gitignore — drops the AGENTS.md entry (file is now committed)
Harness support verified:
- Codex CLI reads AGENTS.md natively (root → cwd walk, 32 KiB cap)
- Cursor 2.5+ reads AGENTS.md natively
- OpenCode reads AGENTS.md natively (wins over CLAUDE.md if both exist)
- Claude Code: `CLAUDE.md` first line is `@AGENTS.md` (Anthropic's
documented interop pattern)
- Gemini CLI: `.gemini/settings.json` context.fileName redirect
(Gemini doesn't support @-imports)
Codex adapter no longer generates AGENTS.md — `emit_global` instead
validates the committed file fits Codex's 32 KiB cap and the 150-line
table-of-contents convention. Tests updated. Clean-output target no
longer touches AGENTS.md.
## Auxiliary files updated for multi-harness reality
- `.github/ISSUE_TEMPLATE/bug_report.yml` — dropdown for harness +
component path; renames "subagent" → "plugin/agent/skill/command"
- `.github/ISSUE_TEMPLATE/feature_request.yml` — scope dropdown covers
framework / harness / tooling / docs / CI in addition to components
- `.github/ISSUE_TEMPLATE/new_subagent.yml` — relabeled "New Component
Proposal" with component-type dropdown (plugin/agent/skill/command/
harness adapter) and cross-harness portability field
- `.github/ISSUE_TEMPLATE/config.yml` — links to AGENTS.md, authoring
guide, per-harness docs; updated Contributing link to root
- `.github/CONTRIBUTING.md` — thin pointer to canonical root CONTRIBUTING.md
- `.github/PULL_REQUEST_TEMPLATE.md` — new; scope + affected-harness
checklists, test-plan checklist, portability-notes section
- CONTRIBUTING.md (root) — updated to reference AGENTS.md / ARCHITECTURE.md
- gemini-extension.json — version 1.6.0 → 1.7.0, count fixes, redirects
to AGENTS.md as contextFileName
## Code-quality CI
New `.github/workflows/code-quality.yml` with three jobs:
- `python-lint` — `ruff check`, `ruff format --check`, `ty check` on
the adapter framework + plugin-eval. yt-design-extractor.py legacy
code excluded.
- `markdown-lint` — markdownlint-cli2 against README, AGENTS, ARCHITECTURE,
CLAUDE, top-level guides, and docs/. Config in `.markdownlint.json`.
- `json-lint` — validates every JSON / TOML / YAML in the repo (excluding
generated trees).
Required ty environment config added to plugin-eval/pyproject.toml so
`tools.adapters.*` resolves from outside the package.
Fixed one ty error in `tools/adapters/base.py:HarnessAdapter.capabilities`
(return-type annotation didn't match the `Capability` dataclass returned).
Fixed two ruff SIM108 ternary suggestions in codex.py and doc_gardener.py.
ruff format applied across all in-scope files (formatting-only diffs).
## Tests + verification
- 387 pytest tests pass (1 new test for the AGENTS.md validate-don't-overwrite behavior)
- `make validate STRICT=1` clean
- `make garden` 0 errors (10 warnings — remaining oversize source skills)
- `make smoke-test` clean against locally installed OpenCode/Gemini/Codex/Claude Code
- Real-CLI round-trip: `opencode agent list` discovers 193 subagents,
`gemini extensions validate .` succeeds, all 191 Codex agent TOMLs parse
## Tag recommendations (separate task — for repo About panel)
Top 20 by reach + relevance (from `gh api search/repositories?q=topic:<tag>`):
automation mcp ai-agents developer-tools claude-code anthropic agentic-ai
agents prompt-engineering cursor multi-agent agent-skills orchestration
opencode workflows gemini-cli codex-cli claude-code-skills cursor-rules
claude-code-plugins
* fix(ci): YAML multi-doc + markdownlint scope/rules
Two CI failures on PR #542, both fixed:
## JSON/TOML/YAML syntax job (3 false-positive YAML errors)
The job's YAML validation used `yaml.safe_load` which only reads the first
document in a multi-document YAML stream. Three Kubernetes manifest
templates use the standard `---` document separator (valid YAML) and were
mis-flagged:
plugins/kubernetes-operations/skills/k8s-manifest-generator/assets/configmap-template.yaml
plugins/kubernetes-operations/skills/k8s-manifest-generator/assets/service-template.yaml
plugins/kubernetes-operations/skills/k8s-security-policies/assets/network-policy-template.yaml
Switched to `list(yaml.safe_load_all(...))` so multi-doc YAML is accepted.
## Markdown lint job (lots of pre-existing plugin-README violations)
Two changes:
1. **Narrow the lint glob** — markdownlint now runs against top-level
guides (README, AGENTS, ARCHITECTURE, CLAUDE, per-harness setup,
CONTRIBUTING) and our authored `docs/` only. Per-plugin READMEs
(`plugins/*/README.md`) are owned by their plugin authors and not
lint-gated as part of this framework PR. Lint enforcement for those
belongs at the plugin-author layer, not the framework PR layer.
2. **Tighten `.markdownlint.json`** — disable two rules that produce
noise without catching real defects:
- MD040 (fenced-code-language) — terminal output / shell command
blocks frequently omit a language by convention
- MD060 (table-column-style) — cosmetic table-pipe spacing; doesn't
affect rendering
Genuine formatting rules kept: MD029 (ol-prefix), MD031 (blanks-
around-fences), MD032 (blanks-around-lists), MD056 (table-column-
count), MD058 (blanks-around-tables).
## Real defects caught and fixed
The narrower scope still caught 5 real issues:
- `docs/agent-skills.md:397` — code fence inside an ordered list item
needed a blank line before the fence
- `docs/authoring.md:90` — bulleted list needed a blank line above
- `docs/plugin-eval.md:87` — table needed a blank line above
- `OPENCODE.md:39` — table-column-count error caused by literal `|`
inside backticks: ``mode: primary|subagent|all`` (3 cells reads as 5)
Rewrote as ``mode:` one of `primary` / `subagent` / `all``
## Verification
- `npx markdownlint-cli2 "*.md" "docs/*.md"` → 0 errors
- `yaml.safe_load_all` accepts all multi-doc YAMLs (0 errors)
- All other CI jobs already passing (Python ruff/ty, multi-harness
generate, CLI smoke test, plugin-eval pytest, tools pytest)
* fix: address PR #542 bot feedback
- Codex P2 (chatgpt-codex-connector): emit_global now reads AGENTS.md from
the repo root (WORKTREE), not output_root. Previously `--output-root <scratch>`
produced a false "missing" warning even when AGENTS.md was committed at the
real root, breaking --strict generation outside the repo. Added a constructor
arg `repo_root` so tests can stage a fake AGENTS.md without touching the
committed file, plus a regression test that proves the two paths are decoupled.
- CodeRabbit nitpick (code-quality.yml): added workflow-level `permissions:
contents: read` and `persist-credentials: false` on every checkout. Skipped
the SHA-pinning recommendation — it's a heavier blanket-policy decision and
the workflow has no write scope to abuse.
- CodeRabbit nitpick (pyproject.toml): consolidated the duplicate `dev` groups
by moving `ty` into `[project.optional-dependencies].dev` and removing the
now-empty `[dependency-groups]` block. Dropped `--group dev` from
`code-quality.yml`'s `uv sync` since `--all-extras` now covers it.
- Verified gemini-extension.json counts (82/191/155/102) against the actual
source-of-truth: 81 local plugins + 1 external = 82 in marketplace.json,
191 agent .md files, 155 SKILL.md files, 102 command .md files. Counts are
correct as-is — CodeRabbit's quick-win was a regex miscount.
Seth Hobson