NgAutoPilot

NgAutoPilot is an installable catalog of micro-skills that helps AI coding agents work safely in Angular, TypeScript, JavaScript, RxJS, testing, code quality, architecture, versioning, and governance workflows.

It keeps agents on a small, repeatable loop: inspect the repo, detect stack and versions, route to the smallest skill, apply compatibility and risk gates, make the smallest reversible change, and validate the result.

Quick Start

npm exec --package=ngautopilot -- ngautopilot help
npm exec --package=ngautopilot -- ngautopilot list
npm exec --package=ngautopilot -- ngautopilot init
npm exec --package=ngautopilot -- ngautopilot doctor

After init, NgAutoPilot creates a local .ngautopilot/ workspace with skills, adapters, and catalog.json.

Naming

Concept	Value
npm package	ngautopilot
CLI command	ngautopilot
generated folder	.ngautopilot/
GitHub repo	janpereira-dev/ngAutoPilot

Why It Exists

AI coding agents often:

• over-refactor instead of making the smallest safe change
• guess Angular compatibility instead of detecting it
• mix upgrade hops with modernization work
• skip validation or release gates
• apply generic advice to version-sensitive repositories

NgAutoPilot answers that with small, reusable, public skills that can be routed deterministically.

What NgAutoPilot Is

• A public catalog of micro-skills.
• A routing layer for AI coding agents.
• A safety layer for Angular and frontend change work.
• A distribution package with a small CLI.
• A repo with validation, catalog generation, publish bundles, and marketplace manifests.

What It Is Not

• Not a framework.
• Not an Angular runtime library.
• Not an autopatcher.
• Not a replacement for tests or review.
• Not tied to a single AI vendor.

Main Use Cases

Use case	What NgAutoPilot helps with
Angular upgrades	major-by-major routing, compatibility gates, upgrade satellites
Modernization after upgrades	standalone, control flow, @defer, zoneless readiness
Performance audits	template functions, change detection, trackBy, Core Web Vitals
Testing	Angular TestBed, Jest, strategy selection, validation contracts
Quality workflows	lint cleanup, dead code, SonarQube triage, consistency checks
Agent adapters	Codex, Claude Code, Copilot, Cursor, Gemini, generic exports

How It Works

1. Inspect the repository and detect the stack.
2. Select the smallest relevant skill.
3. Apply compatibility and risk gates.
4. Make the smallest reversible change.
5. Validate the result.
6. Package docs, bundles, or review artifacts when needed.

Catalog Snapshot

Current catalog size: 287 skills

Area	Coverage
Core routing	intake, stack detection, compatibility, risk control
Angular	upgrades, modernization, architecture, forms, router, SSR, Material, security, migration
TypeScript and JavaScript	strict typing, fundamentals, safer code patterns
Quality	lint, dead code, SonarQube, governance
CSS	custom properties, :has()-driven layout patterns

Skill Families

These are the families that matter most when consuming the catalog:

Skill family	What it covers	When to use
skills/_core/	intake, stack detection, routing, compatibility, risk control	first, for every task
skills/angular/versioning/	version gates, compatibility decisions, master routing	before any Angular hop
skills/angular/upgrades/	major-hop executors and version-specific satellites	during Angular upgrades
skills/angular/modernization/	control flow, @defer, standalone-first, zoneless readiness	after the hop is stable
skills/angular/architecture/	higher-level Angular design guidance	when the task is architectural
skills/angular/microfrontends/	shell, remote, compatibility, sharing and rollback gates	when the repo needs distributed frontend boundaries
skills/angular/docs/	ADRs, upgrade reports, and review packets	when the change needs governance or packaging
skills/angular/styles/	Angular-hosted CSS custom property patterns	when Angular needs to expose style-only state
skills/css/	selector-driven layout and modern CSS patterns	when CSS can solve the problem without JS
skills/typescript/, skills/javascript/, skills/quality/	cross-cutting code quality and workflow skills	when the task is not Angular-specific

Documentation

Public usage docs:

• docs/getting-started.md
• docs/cli-reference.md
• docs/angular-roadmap-guide.md
• docs/sage-review.md
• docs/release-checklist.md

Maintainer and repository docs:

• docs/maintainer-guide.md
• CONTRIBUTING.md
• SECURITY.md
• CHANGELOG.md

Built For Agent Workflows

The repository includes adapters and marketplace manifests for multiple agent ecosystems while keeping the skills themselves public and agent-agnostic.

Project Health

Validation And Release

Use these commands before publishing:

npm run skills:validate
npm run skills:catalog
npm run plugins:sync
npm run consistency:validate
npm run marketplaces:validate
npm run skills:publish:pack
npm run publish:validate
npm run pack:dry

The CI and release-gate workflows stay focused on deterministic validation. The release workflow can build release artifacts and, when explicitly dispatched with publish enabled, publish the npm package.

Plugin Marketplaces

NgAutoPilot ships marketplace manifests for Claude Code and Codex:

• Claude manifest: .claude-plugin/marketplace.json
• Codex manifest: .agents/plugins/marketplace.json

Current plugin bundles are split by use:

Bundle	Use
ngautopilot-core	orchestration, intake, routing, compatibility, and risk gates
ngautopilot-angular	complete Angular catalog
ngautopilot-angular-microfrontends	focused Angular micro-frontends subset
ngautopilot-css	CSS and Angular style-boundary subset
ngautopilot-javascript	JavaScript fundamentals, modules, pure functions, and async error handling
ngautopilot-quality	complete quality catalog
ngautopilot-quality-lint	ESLint and lint governance subset
ngautopilot-quality-deadcode-sonar	dead-code and SonarQube subset
ngautopilot-typescript	complete TypeScript catalog

npm run plugins:sync rebuilds plugin bundles from skills/ and the consistency validator checks that every source skill is included in at least one plugin bundle.

Repository Map

ngAutoPilot/
  adapters/
  assets/
  docs/
  plugins/
  schemas/
  scripts/
  skills/

License

NgAutoPilot is released under the MIT license.