Ai Assistant Instructions

AI Assistant Instructions

Teaching AI assistants how to help you better. Yes, it's AI instructions written with AI assistance. We've come full circle.

[![License][license-badge]][license-url] [![Markdown Lint][markdownlint-badge]][markdownlint-url] [![pre-commit][precommit-badge]][precommit-url]

What Is This?

A centralized collection of instructions, workflows, and configurations for AI coding assistants. Drop these into your projects and get consistent, high-quality AI assistance across Claude, Copilot, and Gemini.

Think of it as a style guide, but for your AI pair programmer.

This repository maintains the generic, plugin-independent pieces:

• The canonical AGENTS.md / CLAUDE.md / GEMINI.md configuration
• The auto-loaded rules in agentsmd/rules/
• The default development workflow in agentsmd/workflows/
• The CI / validation tooling that keeps all of the above honest

Boundaries between this and the other AI-configuration layers (what lives here versus what is plugin-delivered or published to the docs site) are documented at [`docs.jacobpevans.com/ai-development/repo-boundaries`](https://docs.jacobpevans.com/ai-development/repo-boundaries).

Prerequisites

• Git 2.30+ (for worktree support)
• GitHub CLI (gh) 2.0+ (for PR/issue management)
• (Optional) Python 3.8+ for validation hooks
• (Optional) Node.js 18+ for markdown linting

Installation

# 1. Clone the repo
git clone https://github.com/JacobPEvans/ai-assistant-instructions.git

# 2. Copy AGENTS.md into your project
cp ai-assistant-instructions/AGENTS.md your-project/

#    Optional: copy the auto-loaded rules too
mkdir -p your-project/agentsmd
cp -r ai-assistant-instructions/agentsmd/rules your-project/agentsmd/

# 3. Create vendor symlinks so each AI tool reads the same source
cd your-project
ln -sf AGENTS.md CLAUDE.md
ln -sf AGENTS.md GEMINI.md

Or just browse the [documentation](docs/) and cherry-pick what you need.

Slash commands and skills