stijnvanhulle template

Template

A modern TypeScript monorepo template (pnpm workspaces, Turborepo, oxlint, oxfmt, tsdown, Vitest, and Changesets).

About

A drop-in monorepo starter. Fork it, rename a few fields, and you have a production-ready repository with build, test, lint, format, release and CI already wired up.

AI assistant configuration

This template is set up for AI coding agents. It builds on two open formats, AGENTS.md and Agent Skills, and uses symlinks so every tool reads from one source instead of drifting copies.

AGENTS.md is the canonical instruction file. The shared toolset (skills, commands, code-reviewer agent, output styles, and conventions) lives in tools/claude/, which doubles as a Claude Code plugin (installable as toolkit@stijnvanhulle). The workspace paths under .claude/ and .agents/ symlink into that folder, so the template repo and any project that installs the plugin run the same content from a single source of truth. See tools/claude/README.md for install steps.

Folder structure

AGENTS.md                                     # canonical instructions every agent reads
CLAUDE.md → AGENTS.md                         # Claude Code
GEMINI.md → AGENTS.md                         # Gemini CLI
.github/copilot-instructions.md → AGENTS.md   # GitHub Copilot in VS Code
tools/claude/                                 # distributable Claude Code plugin (single source of truth)
├── .claude-plugin/plugin.json                # plugin manifest
├── README.md                                 # install + usage
├── skills/                                   # cross-provider Agent Skills, one SKILL.md folder each
│   ├── changelog, documentation, humanizer, jsdoc, pr, spec-driven
│   └── conventions/                          # always-on rules: code-style, jsdoc, markdown, security, testing
├── commands/                                 # slash commands: /changeset, /spec, /plan, /implement, /verify
├── agents/                                   # subagents: code-reviewer
└── output-styles/                            # system-prompt modes: house (default), plan, diagrams-first
.agents/
└── skills → ../tools/claude/skills           # lets cross-provider runtimes find the shared skills
.claude/                                      # Claude-specific workspace config
├── settings.json                             # permissions and hook registration
├── hooks/                                    # shell hooks: session-start, format-lint, guard-edit
├── skills → ../tools/claude/skills           # all seven skills, including conventions
├── commands → ../tools/claude/commands
├── agents → ../tools/claude/agents
├── output-styles → ../tools/claude/output-styles
└── rules → ../tools/claude/skills/conventions # the conventions skill files, exposed as rules
plans/                                        # spec-driven workflow
├── README.md                                 # workflow guide
├── templates/                                # blank docs, copied per feature
│   ├── spec.md                               # requirements and acceptance criteria
│   ├── research.md                           # decisions, open questions, constraints
│   ├── plan.md                               # architecture and numbered slices
│   ├── verification.md                       # end-to-end scenarios, one per AC
│   └── slice.md                              # one implementation slice
└── <feature>/                                # one folder per plan
    ├── spec.md  research.md  plan.md  verification.md
    └── NNN-<slug>.md                         # slices, copied from templates/slice.md

Supported agents:

• Claude Code reads CLAUDE.md (symlink to AGENTS.md) and .claude/skills (symlink to tools/claude/skills), plus the Claude-specific extensions below. Other projects can install the same toolset as a marketplace plugin (see tools/claude/README.md).
• OpenAI Codex / ChatGPT reads AGENTS.md and Agent Skills natively.
• GitHub Copilot reads AGENTS.md natively, and .github/copilot-instructions.md (symlink to AGENTS.md) in VS Code.
• Cursor reads AGENTS.md natively. It does not follow symlinks into .cursor/rules/, so rules are not duplicated there. The rule files under .claude/rules/ are referenced from AGENTS.md instead.
• OpenCode reads AGENTS.md and Agent Skills natively.
• Gemini CLI reads GEMINI.md (symlink to AGENTS.md).
• Windsurf and other AGENTS.md runtimes read AGENTS.md natively.