ai-setup-automation
A Claude Code plugin marketplace that ships the ai-setup-automation plugin for creating and maintaining AI-ready project configurations.
What It Does
- Detects your tech stack and scaffolds a
.claude/ directory with CLAUDE.md, skills, agents, and settings
- Provides 11 skills in three categories — Essentials, Analysis, and Utilities — covering the full lifecycle: setup, review, sync, checks, and post-incident learning
- Manages a cache layer to reduce token consumption by 60–80% on repeated audits
- Keeps your AI configuration in sync with your codebase as it evolves
Technical Requirements
| Requirement | Version | Notes |
|---|
| Claude Code | — | This is a Claude Code plugin marketplace |
| Node.js | >= 16 | For cache-snapshot.js and verify-setup.js scripts. Uses built-in modules, no npm install needed |
| git | — | Assumed for most features |
Installation
Via Claude Code UI (recommended)
- Open Claude Code and run
/plugin
- Go to Marketplaces → Add marketplace → enter
rnagrodzki/ai-setup-automation
- Go to Discover → select
aisa → Install
Via CLI
/plugin marketplace add rnagrodzki/ai-setup-automation
/plugin install aisa@ai-setup-automation
See docs/getting-started.md for a full first-use walkthrough.
Updating
Update via Claude Code UI (recommended)
Open /plugin, go to the Marketplaces tab, and toggle auto-update for ai-setup-automation.
Update via CLI
/plugin marketplace update ai-setup-automation
/plugin update aisa@ai-setup-automation
Migrating from older installs
If you installed the plugin before this naming fix, uninstall the old entry and reinstall:
/plugin uninstall ai-setup-automation@ai-setup-automation
/plugin install aisa@ai-setup-automation
Quick Start
- Navigate to your project directory
- Start Claude Code
- Run
/aisa-init
- Follow the interactive prompts
The skill detects your tech stack, presents a setup plan for your approval, and scaffolds the full .claude/ directory.
Skills
Essentials
| Skill | Description |
|---|
/aisa-init | Scaffold a new .claude/ directory — detects tech stack, generates CLAUDE.md, skills, agents, learnings journal, and cache. One-time setup for new projects |
/aisa-sync | Full maintenance cycle — runs drift detection, harvests learnings, identifies expansion needs, applies prioritized updates to .claude/ skills and agents |
/aisa-postmortem | Incident-to-prevention pipeline — gathers context from conversation or git history, maps root causes to skill gaps, encodes lessons into .claude/ skills and learnings log |
Analysis
| Skill | Description |
|---|
/aisa-audit | Deep read-only review of .claude/ content accuracy — mechanical validation, outdated code example detection, skill specificity check, coverage gap analysis. Reports HEALTHY / NEEDS_ATTENTION / CRITICAL |
/aisa-inspect | Quick read-only drift scan — compares .claude/ skills and agents against current codebase state, reports CURRENT / OUTDATED / STALE / CRITICAL per file. Run weekly |
/aisa-lint | Validate skill and agent structure against architectural principles (P1-P3, A1-A6) — checks frontmatter, self-learning directives, PCIDCI pattern. Does not verify codebase accuracy |
/aisa-update | Targeted skill/agent update after a specific code change — uses git diff to scope impact, updates only affected .claude/ files, flags out-of-scope drift without fixing it |
Utilities
| Skill | Description |
|---|
/aisa-harvest | Promote ACTIVE entries from .claude/learnings/log.md into skill gotchas, new skills, and documentation. Run when log has 10+ entries or oldest entry exceeds 2 weeks |
/aisa-cache | Manage the .claude/cache/ snapshot used by inspect and sync — sub-commands: rebuild (default), status, invalidate. Reduces token use by 60-80% |
/aisa-spec-check | Check openspec CLI availability, project initialization status, and version currency — suggests install/init/update with user confirmation |
Testing
Behavioral regression tests use promptfoo to validate plugin skills against expected outputs. Tests require Task and gum for interactive selection.
