{"id":50622560,"url":"https://github.com/gh-xj/agent-repo-kit","last_synced_at":"2026-06-06T13:30:23.936Z","repository":{"id":351244339,"uuid":"1210172450","full_name":"gh-xj/agent-repo-kit","owner":"gh-xj","description":"Harness-agnostic repo conventions for AI-agent-assisted development: tickets, wiki, audit/bootstrap workflows. Works with Claude Code, Codex, Cursor, or no harness.","archived":false,"fork":false,"pushed_at":"2026-05-17T07:30:55.000Z","size":685,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-17T09:33:14.768Z","etag":null,"topics":["agent-tooling","ai-agents","claude-code","codex","cursor","go-task","knowledge-base","repo-conventions","ticket-tracker"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gh-xj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-14T06:44:30.000Z","updated_at":"2026-05-17T07:30:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gh-xj/agent-repo-kit","commit_stats":null,"previous_names":["gh-xj/agent-repo-kit"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gh-xj/agent-repo-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gh-xj%2Fagent-repo-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gh-xj%2Fagent-repo-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gh-xj%2Fagent-repo-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gh-xj%2Fagent-repo-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gh-xj","download_url":"https://codeload.github.com/gh-xj/agent-repo-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gh-xj%2Fagent-repo-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33984824,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-tooling","ai-agents","claude-code","codex","cursor","go-task","knowledge-base","repo-conventions","ticket-tracker"],"created_at":"2026-06-06T13:30:22.606Z","updated_at":"2026-06-06T13:30:23.926Z","avatar_url":"https://github.com/gh-xj.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# agent-repo-kit\n\n[![CI](https://github.com/gh-xj/agent-repo-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/gh-xj/agent-repo-kit/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/gh-xj/agent-repo-kit/pulls)\n\n## TL;DR\n\n`agent-repo-kit` is a drop-in set of repo conventions and tooling for\nAI-agent-assisted development. The convention surfaces are\n**harness-agnostic** and can be adopted from any editor or agent runtime.\nThis repo ships canonical open-skill surfaces plus thin compatibility\nadapters for `claude-code` and `codex`; `cursor/` remains placeholder\nadapter docs. The kit gives any repo a small default core:\n\n1. A repo-root `.conventions.yaml` descriptor that an agent reads to scaffold\n   and audit the rest.\n2. A local-first **work tracker** (`.work/`) — inbox, triage, views, driven\n   by the JSON-native `work` CLI from\n   [`gh-xj/work-cli`](https://github.com/gh-xj/work-cli) (separate repo).\n\nOptional packs, such as `.wiki/`, are available when a repo has source-backed\nknowledge that earns the extra surface area.\n\n## Install\n\nInstall the skills:\n\n```bash\nnpx skills add gh-xj/agent-repo-kit -g -a claude-code -a codex --skill '*' -y\n```\n\nThis step requires Node.js so `npx` is available.\n\nInstall the `work` CLI (separate repo):\n\n```bash\ngo install github.com/gh-xj/work-cli/cmd/work@latest\n```\n\nRequires Go ≥ 1.25, or grab a release tarball from\nhttps://github.com/gh-xj/work-cli/releases. The resulting `work` binary\nlives in `$(go env GOBIN)` or `$GOPATH/bin`; ensure that directory is on\nyour `PATH`.\n\n### Supported harnesses\n\n- **claude-code** — install with\n  `npx skills add gh-xj/agent-repo-kit -g -a claude-code --skill '*' -y`\n- **codex** — install with\n  `npx skills add gh-xj/agent-repo-kit -g -a codex --skill '*' -y`\n\n### Maintainer Setup\n\nIf you are actively editing this repo's `skills/` sources, prefer the local\nsymlink workflow over `npx skills add /path/to/repo ...`.\n\nWhy: installing from a local filesystem path with `npx skills add` copies the\nskill directories into the managed runtime roots. That is useful for smoke\ntests and release verification, but edits in your checkout do not live-update\nthe installed skills.\n\nFor day-to-day maintenance from a local clone, run:\n\n```bash\ntask skills:link-dev\n```\n\nThat helper:\n\n- symlinks every `skills/*/SKILL.md` repo skill into `~/.agents/skills/`\n- symlinks Claude entries from `~/.claude/skills/` to `~/.agents/skills/`\n- does not modify `~/.codex/skills/`, which can keep runtime-owned entries\n  such as `.system`\n\nAfter linking, restart Codex and Claude Code so they rescan the skill roots.\nManual maintainer symlinks may not appear in `npx skills ls`; validate them\nby checking the filesystem directly (for example\n`~/.agents/skills/\u003cname\u003e/SKILL.md`).\n\n## Bootstrap A Repo\n\nUse the `convention-engineering` skill (loaded via the supported harness) to\nscaffold the kit-owned repo surface. The agent reads or creates a\n`.conventions.yaml` at your repo root and writes the artifacts it declares —\nagent contract files (`CLAUDE.md` / `AGENTS.md`), docs taxonomy, Taskfile,\npre-commit hook — following\n`skills/convention-engineering/references/operations/bootstrap-workflow.md`.\n\nThe generated repo then supports:\n\n```bash\ntask verify\n```\n\nPrerequisites:\n\n- `work` on `PATH` (see [Install](#install)) for the work tracker.\n- `task`, `bash`, `yq`, and standard Unix tools for `task verify`.\n\n## What you get\n\n- **`skills/`** — canonical, harness-free skill sources:\n  - `skills/convention-engineering/` — repo conventions: `.conventions.yaml`,\n    agent docs, docs taxonomy, verification gates, repo-local skill placement,\n    and optional work / wiki scaffolds. Includes the evaluation rubric for\n    skeptical scoring (in `references/meta/`).\n  - `skills/skill-builder/` — skill for creating, refactoring, and auditing\n    agent skills.\n  - `skills/skill-cli-authoring/` — skill for designing skill-local CLIs with\n    agent-friendly command, output, safety, and verification contracts.\n  - `skills/taskfile-authoring/` — skill for writing canonical Taskfiles.\n  - `skills/attack-architecture/` — adversarial architecture-review skill.\n  - `skills/harness-router/` — proposal-only router for deciding where\n    session learnings and harness improvements should persist.\n  - `skills/work-cli/` — operating the `.work/` tracker.\n  - `skills/slock-epic-protocol/` — maintaining Slock agent ↔ epic repo ↔\n    leaf repo protocols: registry mapping, pointer-only memory, generated\n    symlinks, per-leaf work, skill mirrors, and handoffs.\n  - `skills/paper-vetting/` — three-lens credibility vetting for research\n    papers before reading them.\n- **`adapters/`** — thin wrappers that expose `skills/` to a specific\n  harness. `claude-code/` and `codex/` are shipped as compatibility targets;\n  `cursor/` is placeholder docs today.\n- **External: [`gh-xj/work-cli`](https://github.com/gh-xj/work-cli)** — the\n  `work` CLI (Go) that powers `.work/`. Released independently; ARK pins a\n  minimum version via `min_work_version` in `.conventions.yaml`.\n\n## Quick example\n\n```bash\ncd /path/to/your-repo\n# Use the convention-engineering skill via your harness to bootstrap, then:\ntask verify             # runs whatever .conventions.yaml declares\ntask work -- view ready # inspect ready work\n```\n\n## Architecture\n\n```\n     +---------+\n     | skills/ |\n     +----+----+\n          ^\n   +------+-------+\n   |  adapters/   |\n   | claude-code  |\n   | codex        |\n   | cursor*      |\n   +--------------+\n```\n\n`*` placeholder adapter docs only; not an installable target today.\n\nContent lives under `skills/`. Adapters don't own content; they re-export\nvia `adapters/manifest.json`.\n\n## Contributing\n\nPRs welcome. Keep everything under `skills/` harness-free; put harness\nspecifics under `adapters/\u003cname\u003e/`.\n\n## License\n\nMIT — see `LICENSE`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgh-xj%2Fagent-repo-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgh-xj%2Fagent-repo-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgh-xj%2Fagent-repo-kit/lists"}