A central repository for reusable configuration, rules, and workflows for AI-powered tools and agents. Everything needed to standardize how AI assistants and automation behave across projects lives here.

• Claude Rules — CLAUDE.md files and conventions for Claude Code / Claude CLI
• Codex Rules — Configuration and instructions for OpenAI Codex agents
• Cursor Rules — .cursorrules and settings for Cursor IDE
• GitHub Agentic Workflows — Reusable gh aw workflow definitions
• GitHub Actions Workflows — CI/CD workflows that leverage AI agents
• Claude Commands — Custom slash commands for Claude Code (/review, /refine, /suggest, /design)

• .github/workflows/ — Agentic workflow definitions, compiled lock files, and maintenance jobs
• precommit-agentic-check/ — Isolated Python subproject for an LLM-backed pre-commit hook
• claude-commands/ — Claude Code custom slash commands and shared reference files

• Purpose: Run an agentic check in pre-commit using staged diff + nearby context.
• Runtime: Python package (agentic-check CLI).
• Config surface: model/provider/prompt in .pre-commit-config.yaml, credentials via env vars.
• Docs: precommit-agentic-check/README.md

Custom slash commands for Claude Code that automate code review, refinement, design, and suggestion workflows.

claude-commands/
├── commands/           # Slash commands (deployed to ~/.claude/commands/)
│   ├── review.md
│   ├── refine.md
│   ├── suggest.md
│   └── design.md
└── shared/             # Shared reference files (deployed to ~/.claude/shared/)
    ├── pr-commands.md
    └── design-templates.md

cd claude-commands
make deploy

This copies commands to ~/.claude/commands/ and shared files to ~/.claude/shared/, where Claude Code picks them up at runtime.

After deploying, the commands are available as slash commands inside any Claude Code session:

/review 42              # Review PR #42
/refine                 # Fix issues on the current branch and update the PR
/suggest 1,3            # Post findings #1 and #3 from a review as PR comments
/design "Add patient export API"   # Generate a design doc and tickets

Important: This repo is the source of truth. Never edit files directly in ~/.claude/commands/ or ~/.claude/shared/ — edit here, then make deploy.

1. Install and authenticate GitHub CLI (gh).
2. Install the gh aw extension:

gh extension install github/gh-aw

If already installed, upgrade to the latest version:

gh extension upgrade gh-aw

3. Initialize your target repository for agentic workflows:

gh aw init

• Source file: .github/workflows/agents-doc-sync.md
• Mission: Detect divergence between CLAUDE.md and AGENTS.md, update the file missing information, and create a PR only when edits are made.
• Triggers:
  • schedule (daily)
  • workflow_dispatch (manual)
• Permissions: contents: read, issues: read, pull-requests: read
• Engine / timeout: codex, 15 minutes
• Tools: edit, bash, github (default toolset)
• Required configuration:
  • Required: none
  • Optional repository variables: GH_AW_MODEL_AGENT_CODEX, GH_AW_MODEL_DETECTION_CODEX
• Safe output behavior: PR titles are prefixed with [docs] , labels include documentation and automation, and PR expiry is 3d.

Install:

gh aw add-wizard aaronspindler/agentic_workflows/agents-doc-sync