# AmigaIA

or ami for friends

A centralized repository for declarative JSON skills, agent profiles, and their Universal Adapter. 100% cross-compatible with Antigravity (Gemini) and Claude Code.

Explore Tools
Quick Start
GitHub Repo
NPM Package

### Modular Skills

Shared capabilities stored in `skills/` using Markdown with YAML frontmatter. Acts as a portable action engine for any AI.

### Dynamic Subagents

Declarative agent profiles stored as Markdown in `agents/`. Free of proprietary tools, they use natural language descriptions mapped by the adapter.

### Persistent Memory

Long-term project knowledge and Architectural Decision Records (ADRs) are stored in `docs/`, giving agents continuous context.

### NPM & CLI Wizard

Distributed as an NPM package with a built-in `amiga-ia-setup` CLI wizard for easy, one-click environment configuration.

### XML Lazy Loading

Dynamic scanning that generates an XML catalog, loading full Markdown files only when requested by the AI.

### Safe Namespacing

All tools strictly enforce the `ami-` prefix to prevent namespace collisions with external AI ecosystems.

## Available Tools

###
Specialized Agents

#### ami-next-step-assistant

Analyzes repo health to recommend the most critical next step.

#### ami-commit-assistant

Analyzes diffs to generate semantic commit messages.

#### ami-push-assistant

Orchestrates pre-push checks and validations.

#### ami-pr-publisher

Automates the creation and formatting of Pull Requests.

#### ami-release-manager

Coordinates version bumping and release notes.

###
Lifecycle Skills

###
Architecture & Setup Skills

#### ami-project-architect

Designs and structures the foundational architecture for new projects.

#### ami-doc-architect

Scans and generates tailored project documentation structure.

###
Development & Testing Skills

#### ami-quick-review

Deep architectural and security code review.

#### ami-test-creator

Automatically generates missing unit tests for PR changes.

#### ami-test-runner

Executes tests and reports coverage directly on PRs.

###
PR & Release Skills

#### ami-pr-conflict-detector

Detects and warns about potential merge conflicts.

#### ami-pr-comment-analyzer

Analyzes and addresses PR review comments.

#### ami-pr-peer-reviewer

Assists in peer reviewing Pull Requests with strict code analysis.

#### ami-release-drafter

Drafts release notes based on merged PRs.

#### ami-release-tagger

Creates and pushes Git tags for new versions.

###
Code Quality & Maintenance Skills

#### ami-data-validator

Validates data payloads and schema integrity.

#### ami-quality-auditor

Performs static analysis and code quality checks.

#### ami-tech-debt-scanner

Analyzes repo for technical debt and provides a classified report.

#### ami-learnings-extractor

Extracts and logs technical learnings from code.

#### ami-docs-updater

Syncs documentation with the latest codebase changes.

###
Quick Start

1

Ensure you have Node.js installed on your machine.

2

Install the package globally via NPM: `npm install -g @anacatavc/amiga-ia`

3

Run the interactive wizard by typing `amiga-ia-setup` in your terminal to automatically copy the files to your AI configuration folders.