1
0
Fork 0
mirror of https://github.com/jimeh/agentic.git synced 2026-04-20 19:14:15 +00:00
Shared configuration and rules for AI coding agents (Claude Code, Codex, etc.)
Find a file
Jim Myhrberg f1ececa5fb
feat(skills): make vuln scan outputs actionable and durable
The vuln scan skill needed a clearer separation between scan indexing and
fix handoff so follow-up investigation would not depend on cross-referencing
multiple reports or ephemeral run artifacts.

Rename the final scan artifacts to findings-summary.md and
verified-results.md, make the summary a concise status index, and make the
verified results file the self-contained handoff for confirmed actionable
findings. Also update skip guidance so skip files can live in git as
human-authored Markdown that future scans match heuristically instead of via
run-local IDs or strict metadata.
2026-04-20 16:48:15 +01:00
.claude chore(claude): add mise format and lint permissions 2026-03-26 23:02:44 +00:00
.claude-plugin feat(git-commands): forbid staging gitignored files by default 2026-04-16 22:40:20 +01:00
.github/workflows feat: add oxfmt and markdownlint for Markdown formatting 2026-02-25 23:57:18 +00:00
.vscode chore: add package.json, bun lockfile, and vscode settings 2026-04-01 13:15:35 +01:00
claude chore(claude): enable thinking summaries 2026-04-07 19:40:06 +01:00
codex feat(codex): improve local config ergonomics 2026-04-01 13:27:30 +01:00
docs/references feat: add phased-work plugin for research-plan-implement workflow 2026-02-23 12:05:49 +00:00
plugins feat(git-commands): forbid staging gitignored files by default 2026-04-16 22:40:20 +01:00
skills feat(skills): make vuln scan outputs actionable and durable 2026-04-20 16:48:15 +01:00
.editorconfig feat: add oxfmt and markdownlint for Markdown formatting 2026-02-25 23:57:18 +00:00
.gitignore feat: add oxfmt and markdownlint for Markdown formatting 2026-02-25 23:57:18 +00:00
.markdownlint-cli2.jsonc chore: add package.json, bun lockfile, and vscode settings 2026-04-01 13:15:35 +01:00
.oxfmtrc.json chore: add package.json, bun lockfile, and vscode settings 2026-04-01 13:15:35 +01:00
AGENTS.md feat(codex): improve local config ergonomics 2026-04-01 13:27:30 +01:00
bun.lock chore: add package.json, bun lockfile, and vscode settings 2026-04-01 13:15:35 +01:00
CLAUDE.md docs: add AGENTS.md with CLAUDE.md as thin reference 2026-02-15 14:33:36 +00:00
mise.toml refactor(mise): switch from npx to mise-managed tools 2026-04-01 13:03:00 +01:00
package.json chore: add package.json, bun lockfile, and vscode settings 2026-04-01 13:15:35 +01:00
README.md feat: add fd plugin for Feature Design tracking 2026-03-04 00:07:15 +00:00
RULES.md feat(git-commands): forbid staging gitignored files by default 2026-04-16 22:40:20 +01:00
setup.sh feat(edd): add Eval-Driven Development plugin 2026-03-26 22:30:15 +00:00

agentic

My personal AI coding agent configuration, with any quirks, oddities, opinionated rules, and hallucination-inducing prompt fragments I live with on a daily basis.

One repo, one set of rules, symlinked into every agent's config directory. Supports Claude Code, Codex, and any tool that reads AGENTS.md.

Warning

This is my personal config. It is not a starter kit, a framework, or a best-practices guide. If you use it as-is, things will probably work — but they'll work my way, which may not be your way. Browse for ideas, steal what's useful, but don't say I didn't warn you.

Quick Start

git clone https://github.com/jimeh/agentic.git ~/.config/agentic
cd ~/.config/agentic
./setup.sh            # create symlinks (skips existing)
./setup.sh --force    # replace existing (backs up to .bak)

This creates symlinks from the repo into ~/.claude/, ~/.agents/, and ~/.codex/, and registers plugin marketplaces and installs plugins via the Claude CLI. Run ./setup.sh --help for details.

What's Inside

  • RULES.md — Single source of truth for all agent behavior rules. Symlinked as the global rules file for each supported agent. Edit this file directly — never edit the symlink targets.
  • claude/ — Claude Code settings and statusline script.
  • codex/ — OpenAI Codex config.
  • skills/ — Custom skills (auto-discovered by setup.sh).
  • plugins/ — Claude Code plugins, published via a local marketplace.
  • docs/references/ — External articles and guides.

Skills are auto-discovered — drop a directory in the right place, re-run setup.sh, done. Commands live in plugins. Plugins are registered and installed via the Claude CLI (claude plugin marketplace add / claude plugin install).

Plugins

strip-git-cwd

A PreToolUse hook that strips redundant git -C <cwd> flags from Bash commands when the path matches the current working directory. Claude Code tends to add these unnecessarily, and the -C flag changes the command string enough that pre-approved git commands no longer match the allowlist — causing repeated permission prompts.

Handles all -C syntax variants (space, =, bare, quoted) and compound commands (&&, ;).

git-commands

Slash commands for common git workflows:

  • /commit — Stage changes, create a well-formed commit.
  • /commit-push-pr — Commit, push, and open a PR.
  • /rebase — Rebase onto upstream main/master.
  • /clean-gone-branches — Clean up branches deleted on remote.

Derived from the official commit-commands plugin, heavily modified.

agents-md

Slash commands for managing AGENTS.md files:

  • /claude-md-to-agents-md — Convert CLAUDE.md to AGENTS.md.
  • /generate-agents-md — Generate AGENTS.md from codebase analysis.
  • /refactor-agents-md — Refactor AGENTS.md for progressive disclosure.

phased-work

A disciplined research-plan-implement workflow. Instead of jumping straight to code, you move through distinct phases so every decision is reviewed before implementation begins.

  • /research — Deep-read a codebase area, write findings to research.md.
  • /plan — Create a detailed implementation plan in plan.md.
  • /refine — Address inline notes you've added to the plan.
  • /todo — Add a granular task breakdown to the plan.
  • /implement — Execute the plan mechanically, marking progress.
  • /review — Optional post-implementation sanity check.

Also includes agent-agnostic prompt snippets for use with any AI coding assistant.

fd

Initializes a lightweight Feature Design (FD) tracking system in any project. Scaffolds directory structure, templates, index, project-local slash commands, and CLAUDE.md conventions for the full FD lifecycle.

  • /fd-init — Set up the FD system in the current project.

Based on the Feature Design system by manuelschipper.

Standalone Installation

You can install individual plugins directly without cloning the repo. First add the marketplace, then install whichever plugins you want:

# CLI
claude plugin marketplace add jimeh/agentic

# Or from within Claude Code
/plugin marketplace add jimeh/agentic

Then install plugins:

# CLI
claude plugin install git-commands@jimeh-agentic

# Or from within Claude Code
/plugin install git-commands@jimeh-agentic

Installation via setup.sh

setup.sh ensures both the official claude-plugins-official marketplace and this repo's local marketplace are registered, then installs plugins listed in the CLAUDE_PLUGINS array at the top of the script. To add or remove auto-installed plugins, edit that array.

Requires the claude CLI and jq. Skipped gracefully if either is missing.

Requirements

  • Bash 3.2+ (macOS default works)
  • For symlink resolution, setup.sh tries realpath first, then platform-specific fallbacks:
    • macOS: python3, python, perl, or readlink
    • Linux: readlink -f (part of coreutils)

License

This is a personal configuration repository. Feel free to use it as inspiration for your own setup, but there are no guarantees it won't teach your agents some questionable habits.