A GitHub template for repositories that LLM agents build and maintain, for maintainers and teams who want reliable, reviewable agent work. It provides no application code; it provides portable agent instructions, a documentation structure with templates, a verify gate, and a starting point for skills.
Status: in production. New repositories copy it from main; it has no versioned releases.
Documentation: docs/README.md
| Path | What it is |
|---|---|
AGENTS.md, CLAUDE.md, GEMINI.md, .cursorrules, .github/copilot-instructions.md |
Canonical agent instructions and tool-facing symlinks |
.agents/skills/, .claude/skills |
Canonical shared skills and the Claude skills symlink |
docs/ |
ADRs, designs, specs, plans and documentation indexes |
Makefile |
The verify, check and CI gate |
mise.toml, mise.lock |
Pinned tool versions |
scripts/ |
Template and corrections validation scripts |
test/ |
Node.js fixtures and gate tests |
.memory/ |
The corrections inbox: 1 file per record in .memory/corrections/ |
.github/ |
Risk paths, dependabot settings, pull request guidance and workflows |
LICENSE, SECURITY.md |
License text and private vulnerability reporting |
- Click Use this template on GitHub, or run
gh repo create myproject --template bketelsen/agentic-template. - In
AGENTS.md, replace the title and intro, then fill in the commented placeholder sections as the project takes shape. Put project checks behindmake verifyin theMakefile; CI runs the gate. - Set the dates in
docs/adr/0001,0002and0003to today; these ADRs are pre-accepted because this template implements them. - Set the copyright holder and year in
LICENSE. Keep MIT unless the project inherits GPL-3.0. - Replace the repository URL and supported-versions section in
SECURITY.mdwith your own values. - Add a
.github/dependabot.ymlentry for each package ecosystem that the project adds:gomod,npm,cargo,docker. Give each entry 1 group withpatterns: ["*"]and noapplies-to, like thegithub-actionsentry (core ADR-0075). - For a released Go project, add
.svu.ymland abumptarget that runssvu next; use the Go and golangci-lint versions of core'sfrostyard-go-reposkill. - For a user-facing tool, add a
site/documentation site (core ADR-0070). - Write the first real ADR,
0004, for the first significant choice — language, framework or storage — and continue for later choices. - Write
README.mdfor the new project from core's frostyard-readme skill and core ADR-0072. Run its checker,check-readme.mjs, until it printsok. Update docs/design/agent-ready-repository.md when the project changes its structure. - Complete the repository admin steps for the labels, ruleset, private vulnerability reporting and risk paths in docs/new-repository.md.
The full checklist is core's repository baseline spec.
The template makes agents use one canonical instruction surface, category-based documentation, reusable templates and skills, two-way cross-links, live conventions and a verify gate. It keeps the mechanism in AGENTS.md, docs and code, so each agent sees the same repository. For the full design, read agent-ready repository.
mise install
make cimake verify needs only Node.js 22 or later and make; it uses no package manager and no third-party dependency. Clone with core.symlinks=true on Windows.
- AGENTS.md: the rules for agents and contributors.
- docs/README.md: the index of decisions, designs, specs and plans.
- SECURITY.md: report a vulnerability privately.
- LICENSE: MIT.