btwld

Rockets SDK Skills

A Claude Code plugin that supercharges Rockets SDK development with AI-powered code generation, review, diagnostics, and orchestration for NestJS + TypeORM + Concepta projects.

Also works with Cursor and OpenAI Codex (manual setup).

Table of Contents

• What It Does
• Installation
  • Claude Code (Plugin)
  • Auto-install for Teams
  • Cursor
  • OpenAI Codex
  • Manual (Any Agent)
• Tutorial: Your First Project
  • Step 1 — Bootstrap a Project
  • Step 2 — Generate Your First Module
  • Step 3 — Add Access Control
  • Step 4 — Add Business Logic
  • Step 5 — Review and Test
• Commands Reference
• Full Project from a Spec Document
• Diagnosing Issues
• What's Included
• Architecture
• Agent Teams (Parallel Generation)
• Mandatory Engineering Rules
• License

What It Does

Instead of manually writing boilerplate for every NestJS module, this plugin gives your AI coding agent a complete toolkit:

• Generate full CRUD modules (entity, DTOs, service, controller, access control — 12+ files) from a simple JSON config
• Orchestrate entire projects from a requirements document, with dependency-aware wave-based generation
• Review code against 9 mandatory engineering rules automatically
• Diagnose runtime, build, and ACL errors with executable scripts
• Bootstrap new projects from the rockets-starter template

Installation

Claude Code (Plugin)

Requires Claude Code CLI.

1. Add the marketplace:

/plugin marketplace add btwld/skills

2. Install the plugin:

/plugin install rockets-sdk-config@btwld

This registers all agents, commands, skills, and hooks in your Claude Code session.

3. Verify it's installed:

/plugin list

You should see rockets-sdk-config@btwld with 8 commands, 9 agents, and 7 skills listed.

Uninstall:

/plugin uninstall rockets-sdk-config@btwld

Remove marketplace:

/plugin marketplace remove btwld

The plugin auto-updates when you start a new session. To force a reinstall:

/plugin uninstall rockets-sdk-config@btwld
/plugin install rockets-sdk-config@btwld

Auto-install for Team Projects

Add this to your project's .claude/settings.json so teammates are prompted to install automatically when they open the project:

{
  "extraKnownMarketplaces": {
    "btwld": {
      "source": {
        "source": "github",
        "repo": "btwld/skills"
      }
    }
  },
  "enabledPlugins": {
    "rockets-sdk-config@btwld": true
  }
}

Cursor

1. Clone the repo into your project (or a shared location):

git clone https://github.com/btwld/skills.git .rockets-skills

2. Add a .cursorrules file in your project root:

You are working on a Rockets SDK project (NestJS + TypeORM + Concepta).

Follow `.rockets-skills/CLAUDE.md` as the primary project contract.

Priority workflow:
1) Read the relevant file in `.rockets-skills/commands/`
2) Execute implementation using the matching `.rockets-skills/skills/`
3) Verify against `.rockets-skills/development-guides/`
4) Run diagnostics/tests when available

Hard rules:
- `@InjectRepository(...)` only in `*-typeorm-crud.adapter.ts`
- `@InjectDynamicRepository(...)` only in `*-model.service.ts` and `*-access-query.service.ts`
- Services outside model services must not inject repositories
- Access control defaults to deny
- New entity/module → ALWAYS use `rockets-crud-generator` skill, never copy-paste from guides

3. In Cursor Settings > Features, add the development guides as documentation context:

.rockets-skills/development-guides/ROCKETS_AI_INDEX.md
.rockets-skills/CLAUDE.md

4. Use the commands by referencing them in chat:

@.rockets-skills/commands/rockets-module.md generate a Category entity

OpenAI Codex

1. Clone the repo into your project:

git clone https://github.com/btwld/skills.git .rockets-skills

2. Create or update your AGENTS.md (Codex reads this automatically):

# Multi-Agent Workspace Guide

Follow `.rockets-skills/CLAUDE.md` as the canonical project contract.

## Workflow

1. Read `.rockets-skills/CLAUDE.md`
2. Route by `.rockets-skills/development-guides/ROCKETS_AI_INDEX.md`
3. Execute via `.rockets-skills/commands/` + `.rockets-skills/skills/`
4. Validate with diagnostics/tests

## Hard Rules