ai-agents

Agentic Development System

A collection of specialized system prompts and slash commands for AI agents to accelerate software development workflows.

Important

This is the automation for the most essential global commands and instructions ONLY.

Supported AI Agents

• Cursor
• Amp

What It Does

1. Sets up core rules and instructions that are automatically included in every chat request to guide AI assistants.
2. Automates* commands.
3. Automates* MCP servers.

Note

Some tools don't have an appropriate global configuration and require installation into a project's folder.

Installation

Run symlinks init script and follow the steps bellow for an extra manual configuration.

$HOME/dotfiles/setup/symlinks.sh

Add LLM instructions

Helps LLM powered tools like Cursor and Amp understand how to interact with our codebase. These add some base user-level instructions to define some essential standards that should work no matter the project: LLM behavior, code style, essential best practices.

How to use

1. Cursor: Paste file content in AGENTS.md file at the project root
2. Amp: Paste file content in ~/.config/AGENTS.md (automated ✔️)

Add MCP servers

How to use

1. Cursor: Paste file content in ~/.cursor/mcp.json
2. Amp: Paste file content in ~/.config/amp/settings.json as amp.mcpServers and in VS Code settings as amp.mcpServers (automated ✔️)

Available servers

• Playwright MCP Server
• Context7 MCP Server

Add slash commands

How to use

1. Cursor: Copy the command files to ~/.cursor/commands/
2. Amp: Copy the command files to ~/.config/amp/commands/ (automated ✔️)

Available commands

• /blog-fix-grammar — Fix grammatical mistakes
• /blog-fix-wording — Fix poor wording and sentence structure
• /explain — Explain how project or a particular feature works
• /review — Review a pull request
• /security-review — Complete a security review of the pending changes on the current branch

References

• AGENTS.md
• AI coding workflow: my custom prompts for AI agents
• Claude Code security review action