ai-dev-cli

Scaffold & audit tool for Claude Code projects.

One command to set up CLAUDE.md, permissions, custom commands, hooks, MCP config, and coding standards.

Quick Start

npx ai-dev-cli init

Init Levels

| Level | What you get | |-------|-------------| | 0 — Minimal | CLAUDE.md + .claude/settings.json (permissions) + docs/ full structure | | 1 — Commands | + /plan /review /commit custom commands | | 2 — Quality | + Hook scripts (bash firewall, format guard, size guard, dep guard) | | 3 — Full | + MCP config, skills (code-standards, spec) |

Each level includes all lower levels.

Usage

# Interactive (prompts for project name, database, level)
npx ai-dev-cli init

# Non-interactive
npx ai-dev-cli init --level 2 --name my-app --database prisma-sqlite

# Compliance audit
npx ai-dev-cli check
npx ai-dev-cli check --fix

# Takeover an existing project
npx ai-dev-cli takeover

Database Options

| Option | Stack | |--------|-------| | prisma-sqlite | Prisma + SQLite | | prisma-pg | Prisma + PostgreSQL | | supabase-cloud | Supabase (Cloud) | | supabase-cn | Supabase (China, self-hosted) |

What It Generates

your-project/
  CLAUDE.md              # AI assistant instructions
  .claude/
    settings.json        # Permissions + hooks config
    commands/            # Custom slash commands
      plan.md
      review.md
      commit.md
      debug.md
      doc.md
    hooks/               # Automation hooks
      pre-bash-firewall.sh
      post-edit-format.sh
      ...
    skills/              # Skills
      code-standards/
        SKILL.md
      spec/
        SKILL.md
  .mcp.json              # MCP server config
  docs/
    references/
      approved-deps.md
    architecture/
      adr/

Requirements

• Node.js >= 18
• Git

License

MIT