dryvist/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.
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
Or just browse the documentation and cherry-pick what you need.
Slash commands and skills
This repository ships configuration only — no slash commands, skills, agents, or
hooks. Those are delivered as a separate, installable Claude Code plugin
marketplace. Once the marketplace is added and the plugins are enabled, commands
referenced by the workflow (for example /refresh-repo, /finalize-pr, /ship)
become available alongside the configuration in this repo.
Usage
Once installed, the AI assistants read CLAUDE.md / AGENTS.md / GEMINI.md
automatically at session start, and the auto-loaded rules in agentsmd/rules/
are pulled in for every session.
See the default workflow below for the expected
development loop, and AGENTS.md for the full set of rules, routing
decisions, and on-demand standards.
Directory Structure
Supported AI Assistants
| Assistant | Integration | Notes |
| --------- | ----------- | ----- |
| **Claude** | .claude/ directory | Full command support via Claude Code |
| **GitHub Copilot** | .github/copilot-instructions.md + prompts | Works in VS Code, GitHub.com, Visual Studio |
| **Gemini** | .gemini/ directory | Style guide and config support |
The Default Workflow
This repo centers on a lightweight autonomous loop:
1. **Research & Explore** - Gather enough context to act correctly
2. **Plan** - Pick the simplest verifiable path
3. **Define Success** - Choose the narrowest useful evidence
4. **Implement & Verify** - Make the smallest correct change and prove it
5. **Finalize** - Report changed files and verification results
Full PRD/test-first discipline remains available on demand for high-risk,
multi-session, compliance-sensitive, cross-owner, or explicitly gated work.