setup

A setup process that initializes AIAgentMinder governance in a project, including a codebase review and starter project documents.

In plain words
What is it for?
Use it in the target project's repository to install or refresh governance files, identify the project setup, and create or update starter planning documents.
Why use it?
It gives a new project a consistent planning and decision-making foundation while preserving user-owned documents during upgrades.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/lwalden/aiagentminder/setup
Any agent
npx skills add lwalden/AIAgentMinder --skill setup
Clone the repo
git clone --depth 1 https://github.com/lwalden/AIAgentMinder

Made for: Claude Code, Codex.

Per session 27 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,988 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00027 $0.01988
Opus 5 $0.00014 $0.00994
Sonnet 5 $0.00005 $0.00398
Haiku 4.5 $0.00003 $0.00199

Measured 2d ago against content hash 469733ce1ea5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

setup scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

- Modify `~/.claude/settings.json` — plugin hooks register themselves.
skills/setup/SKILL.md · 140 lines

How it starts

The opening of the file, as written. The whole thing — 140 lines — stays where its author put it; the contents beside it link to each section on GitHub.

/aiagentminder:setup

One-time initialization of AIAgentMinder in the current project. Run this in the target project's repo root, NOT in the AIAgentMinder repo itself.

Inputs

  • Current working directory (= target project root)
  • User interaction for project identity questions

Process

1. Detect existing install

Read .claude/aiagentminder-version if it exists.

  • If present: Tell the user "AIAgentMinder is already installed (version X)." This skill is also the re-sync / upgrade path — only the version stamp and plugin-managed files (e.g. .claude/rules/) are refreshed; user-owned files (CLAUDE.md, DECISIONS.md, BACKLOG.md, SPRINT.md, docs/strategy-roadmap.md) are preserved. If they want a newer plugin version on disk first, ask them to run /plugin update aiagentminder before continuing.

    v5.1+ upgrade cleanup. When upgrading from a pre-5.1 install, delete any leftover artifacts of the retired auto-cycle protocol if present in the project root: .sprint-continuation.md, .sprint-continue-signal, .sprint-tool-count, .sprint-phase-guard-count. Also remove the old .claude/rules/context-cycling.md file (replaced by context-warnings.md). Use rm -f — silent when the files don't exist.

    The bootstrap script (step 4) additionally strips any retired auto-cycle hook registrations (context-cycle-hook.sh, session-start-continuation.sh, session-end-cycle.sh) from the project's .claude/settings.json and .claude/settings.local.json. Pre-5.0 installs wired these into the project's own settings; the plugin now registers hooks via hooks.json, and the leftover PreToolUse cycle hook spawns bash on every tool call and can block edits on Windows. The strip is surgical (all other hooks and settings are preserved) and idempotent.

  • If absent: Continue to step 2.

2. Codebase fingerprint

Inspect the project root for stack signals (do this via Read/Glob tools, not by asking the user). Note what you find:

Signal Indicates
package.json Node.js / JavaScript
tsconfig.json + package.json TypeScript
next.config.*, app/ or pages/ dir Next.js
*.csproj, *.sln, global.json C# / .NET
pyproject.toml, requirements.txt, setup.py Python
Cargo.toml Rust
go.mod Go
pom.xml, build.gradle* Java
Gemfile Ruby
.github/workflows/*.yml GitHub Actions CI
.gitlab-ci.yml GitLab CI
pytest.ini, jest.config.*, xunit, etc. Specific test runner

Read the full file on GitHub · 140 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 140 lines · 27 tokens per session scan B 469733ce1ea5

Subscribe to this mod's changes

setup is a skill published in the GitHub repository lwalden/AIAgentMinder (4 stars, last pushed 1mo ago), licensed MIT. It adds 27 tokens to every session and 1,988 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

sdd-serve

Serve the SDD Builder's AI request queue: claim requests with sddnextrequest, draft the proposal, answer with sddrespondrequest. Never writes spec files — the user accepts each proposal in the builder. Use when the user asks to attend, serve or listen to the SDD board queue. / Atiende la cola de peticiones del SDD…

juanklagos/spec-driven-development-template · 80 tokens

sdd-workflow

Guide a project with Spec-Driven Development (SDD) discipline - idea, approved spec, consistent plan, tasks, a gate that verifies approval and consent, implementation, validation, and logbook. Bilingual EN/ES. Use when the user wants to start, spec, plan, implement, or validate work with SDD, or mentions specs, plans…

juanklagos/spec-driven-development-template · 84 tokens

predictor-hand-skill

Expert knowledge for AI forecasting — superforecasting principles, signal taxonomy, confidence calibration, reasoning chains, and accuracy tracking.

RightNow-AI/openfang · 29 tokens

getting-started

Get started with your Open SaaS project — fetches docs, checks Wasp installation, and helps you start your database and app.

wasp-lang/open-saas · 31 tokens

github

Interact with GitHub (issues, PRs, repos, releases) using the gh CLI. Use when asked to read or write GitHub state — open an issue, fetch PR diff, comment, list runs, etc.

Team-Commonly/commonly · 49 tokens

ci-cd

CI/CD pipeline expert for GitHub Actions, GitLab CI, Jenkins, and deployment automation.

RightNow-AI/openfang · 22 tokens