class-ai-agent 1.2.0 → 1.2.2

package/README.md

@@ -1,41 +1,113 @@
-# AI Agent Project — Production-Grade Configuration
+# AI Agent Project
+
+**Production-grade configuration for [Claude Code](https://code.claude.com/docs) and [Cursor](https://cursor.com)** — shared rules, specialized agents, workflow prompts, and checklists you can drop into any repository.
 
 <div align="center">
-  <img src="https://res.cloudinary.com/ecommerce2021/image/upload/v1768626951/dev_efjbzw.jpg" alt="Code Web Khong Kho" width="120" style="border-radius: 50%"/>
 
-  <h3>Production-ready AI Agent configuration for Claude Code &amp; Cursor</h3>
-  <p>Structured workflows, specialized agents, mandatory rules, and best practices</p>
+<p>
+  <img src="royal-solution-logo-v2.svg" alt="Royal Solution" width="280" />
+</p>
+
+### Royal Solution
+
+Open-source AI agent scaffolding by **Royal Solution** — use it in your own projects and teams.
+
+<sub>Adapted from <a href="https://github.com/fdhhhdjd/Class-AI-Agent">fdhhhdjd/Class-AI-Agent</a> · Community &amp; docs · <a href="https://codewebkhongkho.com/portfolios">Code Web Khong Kho</a></sub>
 
-  ![Version](https://img.shields.io/badge/version-1.2.0-blue?style=flat-square)
-  [![Facebook](https://img.shields.io/badge/Facebook-Code%20Web%20Khong%20Kho-1877F2?logo=facebook)](https://www.facebook.com/codewebkhongkho)
-  [![TikTok](https://img.shields.io/badge/TikTok-@code.web.khng.kh-000000?logo=tiktok)](https://www.tiktok.com/@code.web.khng.kh)
-  [![Website](https://img.shields.io/badge/Website-codewebkhongkho.com-FF6B35?logo=google-chrome)](https://codewebkhongkho.com/portfolios)
+<p>
+  <a href="https://www.npmjs.com/package/class-ai-agent"><img src="https://img.shields.io/npm/v/class-ai-agent?label=npm&logo=npm&style=flat-square" alt="npm version" /></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D16.7-339933?logo=node.js&logoColor=white&style=flat-square" alt="Node.js 16.7+" />
+  <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License MIT" />
+  <img src="https://img.shields.io/badge/version-1.2.2-blue?style=flat-square" alt="Version" />
+</p>
 
-  <sub>Inspired by <a href="https://github.com/addyosmani/agent-skills">addyosmani/agent-skills</a></sub>
 </div>
 
 ---
 
-## Overview
+## Contents
+
+- [Why use this](#why-use-this)
+- [Install (quick)](#install-quick)
+- [Overview](#overview)
+- [Development workflow](#development-workflow)
+- [Project structure](#project-structure)
+- [Specialized agents](#specialized-agents)
+- [Approved tech stack](#approved-tech-stack)
+- [Mandatory rules](#mandatory-rules)
+- [Using commands & agents](#using-commands--agents)
+- [Key concepts](#key-concepts)
+- [Security](#security)
+- [Contributing](#contributing)
+- [Publishing to npm (maintainers)](#publishing-to-npm-maintainers)
+- [Credits](#credits)
+
+---
+
+## Why use this
+
+| You get | Details |
+|--------|---------|
+| **Two layouts** | **`.claude/`** for Claude Code (`.md` rules) and **`.cursor/`** for Cursor (`.mdc` rules + `CURSOR.md`) |
+| **One workflow** | Spec → Plan → Build → Test → Review → Ship |
+| **10 agent personas** | Frontend, backend, architect, review, QA, security, PM, UX, SEO, test engineer |
+| **13 topic rules** | Code style, security, API, DB, testing, git, and more (same ideas in both trees) |
+| **`npx` installer** | Copies the folders into your project in one command |
+
+Root **`AGENTS.md`** points Cursor at **`.cursor/CURSOR.md`**.
+
+---
+
+## Install (quick)
+
+Requires **Node.js [16.7+](https://nodejs.org/)**.
+
+```bash
+npx class-ai-agent
+```
+
+Install into another directory, or only Claude / only Cursor:
+
+```bash
+npx class-ai-agent --dir /path/to/your/project
+npx class-ai-agent --claude
+npx class-ai-agent --cursor
+npx class-ai-agent --force    # overwrite existing
+npx class-ai-agent --help
+```
+
+**From a clone** (local dev):
+
+```bash
+git clone https://github.com/khoantd/class-ai-agent.git
+cd class-ai-agent
+npm exec -- class-ai-agent --dir /path/to/your/project
+# or: node bin/class-ai-agent.cjs --dir /path/to/your/project
+```
+
+**Manual copy:** copy **`.claude/`**, **`.cursor/`**, and **`AGENTS.md`** into your project root.
 
-This repository provides a **production-grade configuration** for AI-assisted development. It includes **two parallel layouts**:
+---
+
+## Overview
 
-| Layout | Tool | Purpose |
-|--------|------|---------|
-| **`.claude/`** | [Claude Code](https://code.claude.com/docs) | Slash commands, `CLAUDE.md`, rules as `.md` |
-| **`.cursor/`** | [Cursor](https://cursor.com) | Same workflows; rules as **`.mdc`** (Cursor project rules); hub doc **`CURSOR.md`** |
+This repo ships **two parallel trees** so you can use the same habits in Claude Code and Cursor:
 
-Shared contents:
+| Layout | Tool | What you use |
+|--------|------|----------------|
+| **`.claude/`** | Claude Code | Slash commands, **`CLAUDE.md`**, rules as **`.md`** |
+| **`.cursor/`** | Cursor | Project rules as **`.mdc`**, hub **`CURSOR.md`**, **`@`** file mentions |
 
-- **Structured development workflow** (Spec → Plan → Build → Test → Review → Ship)
-- **10 specialized agents** for different development roles
-- **13 mandatory topic rules** (same content in `.claude/rules/` and `.cursor/rules/`), plus **`cursor-overview.mdc`** in `.cursor/rules/` for Cursor workflow entry
-- **9 workflow prompts** (slash-style command markdown files)
-- **4 reference checklists** for security, testing, performance, and accessibility
+What is inside:
 
-Root **`AGENTS.md`** points agents at **`.cursor/CURSOR.md`** for Cursor-oriented entry.
+- **Structured workflow** (Spec → Plan → Build → Test → Review → Ship)
+- **10 specialized agents** (markdown personas under `agents/`)
+- **13 mandatory topic rules** (plus **`cursor-overview.mdc`** under `.cursor/rules/`)
+- **9 workflow prompts** under `commands/`
+- **5 skills** (TDD, code review, incremental implementation, deploy, security review)
+- **4 reference checklists** (security, testing, performance, accessibility)
 
-The same files can be installed with **`npx`** (see [Quick Start](#quick-start)).
+Keep **`.claude/`** and **`.cursor/`** in sync when you change standards.
 
 ---
 
@@ -43,255 +115,114 @@ The same files can be installed with **`npx`** (see [Quick Start](#quick-start))
 
 ```
 ┌──────────────────────────────────────────────────────────────────┐
-│                                                                  │
-│   /spec  →  /plan  →  /build  →  /test  →  /review  →  /deploy  │
-│                                                                  │
-│   Define    Plan     Build     Verify    Review      Ship        │
-│                                                                  │
+│   /spec  →  /plan  →  /build  →  /test  →  /review  →  /deploy   │
+│   Define     Plan     Build      Verify    Review      Ship      │
 └──────────────────────────────────────────────────────────────────┘
 ```
 
-| Phase | Command | Description |
-|-------|---------|-------------|
-| **Define** | `/spec` | Create PRD with objectives, scope, and boundaries |
-| **Plan** | `/plan` | Decompose into vertical slices with acceptance criteria |
-| **Build** | `/build` | Implement incrementally using TDD |
-| **Verify** | `/test` | Write tests with RED-GREEN-REFACTOR |
+| Phase | Command | Purpose |
+|-------|---------|---------|
+| **Define** | `/spec` | PRD: objectives, scope, boundaries |
+| **Plan** | `/plan` | Vertical slices, acceptance criteria |
+| **Build** | `/build` | Incremental implementation, TDD |
+| **Verify** | `/test` | Tests (RED → GREEN → REFACTOR) |
 | **Review** | `/review` | Five-axis code review |
-| **Ship** | `/deploy` | Build, test, and deploy |
-
-### Supporting Commands
+| **Ship** | `/deploy` | Build, test, deploy |
 
-| Command | Description |
-|---------|-------------|
-| `/debug` | Systematic error diagnosis |
-| `/simplify` | Reduce code complexity |
-| `/fix-issue` | Analyze and fix issues |
+**Supporting:** `/debug`, `/simplify`, `/fix-issue` (see `commands/`).
 
 ---
 
 ## Project Structure
 
-### Claude Code — `.claude/`
+### `.claude/` (Claude Code)
 
 ```
 .claude/
-├── CLAUDE.md                    # Main AI configuration
-│
-├── commands/                    # Workflow prompts (9 files)
-│   ├── spec.md                  # /spec — PRD creation
-│   ├── plan.md                  # /plan — Task breakdown
-│   ├── build.md                 # /build — Incremental implementation
-│   ├── test.md                  # /test — TDD workflow
-│   ├── review.md                # /review — Code review
-│   ├── deploy.md                # /deploy — Deployment
-│   ├── debug.md                 # /debug — Error diagnosis
-│   ├── simplify.md              # /simplify — Code simplification
-│   └── fix-issue.md             # /fix-issue — Issue resolution
-│
-├── agents/                      # Specialized agents (10 total)
-│   ├── frontend.md              # Frontend Developer
-│   ├── backend.md               # Backend Developer
-│   ├── systems-architect.md     # Systems Architect
-│   ├── code-reviewer.md         # Code Reviewer
-│   ├── test-engineer.md         # Test Engineer
-│   ├── security-auditor.md      # Security Auditor
-│   ├── qa.md                    # QA Engineer
-│   ├── project-manager.md       # Project Manager
-│   ├── ui-ux-designer.md        # UI/UX Designer
-│   └── copywriter-seo.md        # Copywriter/SEO
-│
-├── rules/                       # Mandatory rules (13 total)
-│   ├── clean-code.md            # Clean Code principles
-│   ├── code-style.md            # Formatting & naming
-│   ├── error-handling.md        # Error patterns
-│   ├── tech-stack.md            # Approved technologies
-│   ├── system-design.md         # System design patterns
-│   ├── project-structure.md     # Folder organization
-│   ├── api-conventions.md       # REST API standards
-│   ├── naming-conventions.md    # Naming patterns
-│   ├── database.md              # Database patterns
-│   ├── security.md              # Security requirements
-│   ├── monitoring.md            # Observability
-│   ├── testing.md               # Test standards
-│   └── git-workflow.md          # Git conventions
-│
-├── skills/                      # Advanced skills
-│   ├── tdd/SKILL.md             # Test-Driven Development
-│   ├── code-review/SKILL.md     # Five-axis review
-│   ├── incremental-implementation/SKILL.md
-│   ├── deploy/SKILL.md
-│   └── security-review/SKILL.md
-│
-├── references/                  # Quick checklists
-│   ├── security-checklist.md
-│   ├── testing-patterns.md
-│   ├── performance-checklist.md
-│   └── accessibility-checklist.md
-│
-└── settings.json                # Project settings (paths & dirs)
+├── CLAUDE.md                 # Main configuration
+├── commands/                 # 9 workflow prompts (spec, plan, build, …)
+├── agents/                   # 10 personas
+├── rules/                    # 13 mandatory topic rules (.md)
+├── skills/                   # TDD, review, deploy, …
+├── references/               # Checklists
+└── settings.json
 ```
 
-### Cursor — `.cursor/`
+### `.cursor/` (Cursor)
 
-Mirrors `.claude/` for agents, commands, skills, and references. Differences:
+Same ideas as `.claude/` for `commands/`, `agents/`, `skills/`, `references/`. Differences:
 
-| Item | Notes |
-|------|--------|
-| **`CURSOR.md`** | Hub doc (same workflow story as `CLAUDE.md`, Cursor-specific usage) |
-| **`rules/*.mdc`** | Cursor project rules with YAML frontmatter; **`security.mdc`** is always applied; **`cursor-overview.mdc`** explains workflow and paths |
-| **`settings.json`** | Directory map (parallel to `.claude/settings.json`) |
-| **`AGENTS.md` (repo root)** | Short pointer to `.cursor/CURSOR.md` for Cursor |
+| Item | Role |
+|------|------|
+| **`CURSOR.md`** | Hub (like `CLAUDE.md`, Cursor-focused) |
+| **`rules/*.mdc`** | Project rules + YAML; **`security.mdc`** and **`cursor-overview.mdc`** are central |
+| **`settings.json`** | Path hints (mirrors Claude layout) |
+| **`AGENTS.md`** (repo root) | Entry pointer for Cursor |
 
 ```
 .cursor/
 ├── CURSOR.md
 ├── settings.json
-├── commands/                    # Same 9 prompts — open or @-include in Chat/Composer
-├── agents/                      # Same 10 personas — @-mention files when needed
-├── rules/                       # 14 × .mdc (13 topics + cursor-overview)
+├── commands/
+├── agents/
+├── rules/                    # 14 × .mdc (13 topics + cursor-overview)
 ├── skills/
-├── references/
+└── references/
 ```
 
-Keep **`.claude/`** and **`.cursor/`** aligned when you change standards or workflows.
-
 ---
 
 ## Specialized Agents
 
-### Development Agents
-
-| Agent | Role | Invoke When |
-|-------|------|-------------|
-| **Frontend Developer** | Next.js, React, TypeScript, UI | Components, pages, state |
-| **Backend Developer** | Express, Prisma, Redis, BullMQ | APIs, services, jobs |
-| **Systems Architect** | Architecture, ADRs, scaling | System design decisions |
-
-### Quality Agents
-
-| Agent | Role | Invoke When |
-|-------|------|-------------|
-| **Code Reviewer** | Five-axis code review | PR reviews, quality checks |
-| **Test Engineer** | TDD, coverage, test strategy | Writing and reviewing tests |
-| **Security Auditor** | Vulnerability, threat modeling | Security reviews |
-| **QA Engineer** | Test plans, E2E, bug reports | Quality assurance |
-
-### Product Agents
+| Area | Agents |
+|------|--------|
+| **Development** | Frontend, Backend, Systems Architect |
+| **Quality** | Code Reviewer, Test Engineer, Security Auditor, QA |
+| **Product** | Project Manager, UI/UX Designer, Copywriter/SEO |
 
-| Agent | Role | Invoke When |
-|-------|------|-------------|
-| **Project Manager** | Stories, sprints, planning | Project planning |
-| **UI/UX Designer** | Design system, accessibility | UX decisions |
-| **Copywriter/SEO** | Copy, meta tags, SEO | Content creation |
+Full definitions live in **`agents/*.md`**. In Cursor, **`@`**-include a file when you want that role.
 
 ---
 
-## Approved Tech Stack
+## Approved tech stack
 
 | Layer | Technology |
-|-------|-----------|
+|-------|------------|
 | **Frontend (SEO)** | Next.js 14 (App Router) |
-| **Frontend (Admin)** | React + Vite |
+| **Frontend (admin)** | React + Vite |
 | **Styling** | Tailwind CSS + shadcn/ui |
 | **State** | Zustand + TanStack Query |
 | **Backend** | Express.js + TypeScript |
 | **ORM** | Prisma |
 | **Database** | PostgreSQL |
 | **Cache** | Redis (ioredis) |
-| **Queue** | BullMQ (simple) / RabbitMQ (enterprise) |
+| **Queue** | BullMQ / RabbitMQ |
 | **Auth** | NextAuth.js / JWT + bcrypt |
 | **Testing** | Vitest + Playwright |
 | **Monitoring** | Prometheus + Grafana + Pino |
 | **CI/CD** | GitHub Actions |
 | **Deploy** | Vercel + Railway/Fly.io |
 
----
-
-## Mandatory Rules
-
-Follow the rules in **`.claude/rules/`** (Markdown) when using Claude Code, and **`.cursor/rules/`** (`.mdc`) when using Cursor. Content matches; Cursor loads `.mdc` frontmatter automatically.
-
-### Code Quality
-- **clean-code.md** — Variables, functions, SOLID, async/await
-- **code-style.md** — 2-space indent, single quotes, semicolons
-- **error-handling.md** — AppError class, centralized handler
-
-### Architecture
-- **tech-stack.md** — Approved technologies only
-- **system-design.md** — CAP, caching, scaling patterns
-- **project-structure.md** — Layered architecture
-- **api-conventions.md** — REST standards, response envelopes
-
-### Data & Naming
-- **naming-conventions.md** — Cache keys, DB, queues, env vars
-- **database.md** — Prisma patterns, N+1 prevention
-
-### Operations
-- **security.md** — **CRITICAL** — Never violate
-- **monitoring.md** — Prometheus, Grafana, alerting
-- **testing.md** — 80% coverage minimum
-- **git-workflow.md** — Conventional commits
+Details and alternatives are in **`rules/tech-stack.md`** (or **`.mdc`** in Cursor).
 
 ---
 
-## Quick Start
-
-### Install with `npx` (recommended)
-
-Requires [Node.js](https://nodejs.org/) **16.7+**. After you publish this repository to the npm registry (`npm publish`; package name **`class-ai-agent`** in `package.json`):
+## Mandatory rules
 
-```bash
-# Install into the current directory (.claude/, .cursor/, AGENTS.md)
-npx class-ai-agent
-
-# Install into another folder
-npx class-ai-agent --dir /path/to/your/project
-
-# Only Claude Code files
-npx class-ai-agent --claude
-
-# Only Cursor files + AGENTS.md
-npx class-ai-agent --cursor
-
-# Overwrite an existing install
-npx class-ai-agent --force
-```
-
-Run **`npx class-ai-agent --help`** for all options.
-
-#### Publishing to npm (fix `E403` / 2FA)
-
-If **`npm publish`** fails with **`403 Forbidden`** and a message about **two-factor authentication**, npm is blocking the upload until your account meets its publish policy:
-
-1. Sign in at [npmjs.com](https://www.npmjs.com/) → **Account** → enable **Two-Factor Authentication** (use **Auth and writes** so publishing is covered).
-2. In the terminal, refresh the session if needed: **`npm logout`** then **`npm login`**.
-3. Run **`npm publish --access public`** again and enter your **one-time password** when npm asks for it.
+Use **`.claude/rules/*.md`** or **`.cursor/rules/*.mdc`** (paired content; Cursor applies `.mdc` frontmatter).
 
-For **CI or tokens only**: create a [granular access token](https://docs.npmjs.com/about-access-tokens) with permission to publish this package, using type **Automation** (or a token that can bypass 2FA where npm allows it), set **`NPM_TOKEN`** in the environment, and use an **`.npmrc`** that references `${NPM_TOKEN}` per npm’s docs.
+| Theme | Files |
+|-------|--------|
+| **Code quality** | `clean-code`, `code-style`, `error-handling` |
+| **Architecture** | `tech-stack`, `system-design`, `project-structure`, `api-conventions` |
+| **Data** | `naming-conventions`, `database` |
+| **Operations** | **`security`** (critical), `monitoring`, `testing`, `git-workflow` |
 
-**From a git clone** (before publishing, or for development):
-
-```bash
-cd class-ai-agent
-npm exec -- class-ai-agent --dir /path/to/your/project
-# or: node bin/class-ai-agent.cjs --dir /path/to/your/project
-```
-
-### Manual copy
-
-```bash
-git clone https://github.com/khoantd/class-ai-agent.git
-cd class-ai-agent
-
-cp -r .claude/ /path/to/your/project/
-cp -r .cursor/ /path/to/your/project/
-cp AGENTS.md /path/to/your/project/
-```
+---
 
-### Using workflow prompts (commands)
+## Using commands & agents
 
-**Claude Code** — use slash commands in the CLI:
+**Claude Code** — run slash commands in the tool, e.g.:
 
 ```text
 /spec "User authentication feature"
@@ -302,104 +233,84 @@ cp AGENTS.md /path/to/your/project/
 /deploy
 ```
 
-**Cursor** — the same prompts live as markdown under **`.cursor/commands/`**. Open the file, copy the section you need, or **@ mention** it (e.g. `@.cursor/commands/spec.md`) in Chat or Composer.
-
-### Using Agents
+**Cursor** — prompts live under **`.cursor/commands/`**. Open the file, copy the section you need, or **`@`** it (e.g. `@.cursor/commands/spec.md`).
 
-Natural-language instructions still work. In **Cursor**, you can also **@ mention** an agent file (e.g. `@.cursor/agents/frontend.md`) to load that persona.
-
-```text
-"Act as the Frontend Developer and build the login page"
-"As Systems Architect, design the notification system"
-"Code Reviewer: review this PR for security issues"
-"Test Engineer: write tests for the payment flow"
-```
+**Agents** — describe the role in natural language, or in Cursor **`@`** an agent file, e.g. `@.cursor/agents/code-reviewer.md`.
 
 ---
 
-## Key Concepts
-
-### Five-Axis Code Review
-
-Every code review evaluates:
+## Key concepts
 
-1. **Correctness** — Does it work? Edge cases?
-2. **Readability** — Can others understand it?
-3. **Architecture** — Follows patterns? Appropriate abstractions?
-4. **Security** — Input validation? Auth? No secrets?
-5. **Performance** — N+1? Pagination? Async?
+### Five-axis review
 
-### Test-Driven Development
+1. **Correctness** — Behavior, edge cases, tests  
+2. **Readability** — Names, structure  
+3. **Architecture** — Patterns, boundaries  
+4. **Security** — Validation, auth, secrets  
+5. **Performance** — Queries, async, pagination  
 
-```
-RED    → Write failing test
-GREEN  → Write minimal code to pass
-REFACTOR → Improve while green
-```
+### TDD
 
-### Vertical Slicing
+`RED` (failing test) → `GREEN` (minimal pass) → `REFACTOR`.
 
-Build features end-to-end, not layer-by-layer:
+### Vertical slices
 
-```
-✅ Task 1: User can create task (DB + API + UI)
-✅ Task 2: User can view tasks (DB + API + UI)
-
-❌ Task 1: Create all DB models
-❌ Task 2: Create all API routes
-```
+Ship thin end-to-end slices (DB + API + UI), not “all models first, then all routes.”
 
 ---
 
 ## Security
 
-**Never commit:**
-- `.env` files
-- API keys, secrets, passwords
-- `.claude/settings.local.json` (and any local-only Cursor overrides if you add them)
+**Do not commit:** `.env`, secrets, API keys, **`.claude/settings.local.json`**, or local-only Cursor overrides with secrets.
 
-**Always:**
-- Use environment variables
-- Validate all inputs
-- Hash passwords (bcrypt >= 12 rounds)
-- Parameterize queries
+**Do:** environment variables, input validation, strong password hashing, parameterized queries.
 
 ---
 
 ## Contributing
 
-1. Follow the development workflow (`/spec` → `/plan` → `/build`, or the same prompts under `.cursor/commands/`)
-2. Ensure all tests pass
-3. Run `/review` before submitting PR
-4. Follow conventional commit format
-5. When changing rules or workflows, update **both** `.claude/` and `.cursor/` so they stay aligned
+1. Follow the workflow (`/spec` → `/plan` → `/build`, or the same prompts under `.cursor/commands/`).
+2. Keep tests green.
+3. Run **`/review`** before opening a PR.
+4. Use [conventional commits](https://www.conventionalcommits.org/).
+5. Update **both** `.claude/` and `.cursor/` when rules or workflows change.
 
 ---
 
-## Credits
+## Publishing to npm (maintainers)
 
-- Workflow inspired by [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills)
-- Best practices from *Software Engineering at Google*
-- Clean Code principles from Robert C. Martin
+`package.json` name: **`class-ai-agent`**. Use **`npm publish --access public`** after `npm login`.
 
----
+<details>
+<summary><strong>403 / two-factor authentication</strong></summary>
 
-## Author
+If publish fails with **two-factor authentication** required:
 
-<div align="center">
-  <img src="https://res.cloudinary.com/ecommerce2021/image/upload/v1768626951/dev_efjbzw.jpg" alt="Code Web Khong Kho" width="80" style="border-radius: 50%"/>
+1. On [npmjs.com](https://www.npmjs.com/) → **Account** → enable **Two-Factor Authentication** (include **writes** for publishing).
+2. Run **`npm logout`** then **`npm login`**.
+3. Run **`npm publish --access public`** again and enter the OTP when prompted.
 
-  **Code Web Khong Kho**
+For CI, use an [npm access token](https://docs.npmjs.com/about-access-tokens) with publish permission and set **`NPM_TOKEN`** as documented by npm.
 
-  | Platform | Link |
-  |----------|------|
-  | Facebook | [facebook.com/codewebkhongkho](https://www.facebook.com/codewebkhongkho) |
-  | TikTok | [@code.web.khng.kh](https://www.tiktok.com/@code.web.khng.kh) |
-  | Website | [codewebkhongkho.com](https://codewebkhongkho.com/portfolios) |
-</div>
+</details>
+
+<details>
+<summary><strong>403 / “cannot publish over the previously published versions”</strong></summary>
+
+Each version number can only be published **once**. After **`1.2.0`** is on the registry, you must bump before the next upload, for example:
+
+```bash
+npm version patch --no-git-tag-version
+npm publish --access public
+```
+
+That advances **`patch`** (e.g. `1.2.0` → `1.2.1`). Use **`npm version minor`** or **`major`** when the change warrants it.
+
+</details>
 
 ---
 
-<div align="center">
-  <sub>Made with care by <a href="https://www.facebook.com/codewebkhongkho">Code Web Khong Kho</a></sub>
-</div>
+## Credits
+
+- **[Royal Solution](https://codewebkhongkho.com/portfolios)** — project and scaffolding.
+- Upstream inspiration: [fdhhhdjd/Class-AI-Agent](https://github.com/fdhhhdjd/Class-AI-Agent), [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "class-ai-agent",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Production-grade AI agent configuration for Claude Code & Cursor",
   "license": "MIT",
   "repository": {
@@ -29,7 +29,8 @@
     "bin",
     ".claude",
     ".cursor",
-    "AGENTS.md"
+    "AGENTS.md",
+    "royal-solution-logo-v2.svg"
   ],
   "scripts": {
     "prepack": "node -e \"const fs=require('fs');['.claude','.cursor','AGENTS.md'].forEach(p=>{if(!fs.existsSync(p))process.exit(1)})\"",

package/royal-solution-logo-v2.svg

@@ -0,0 +1,58 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 520 200" width="520" height="200">
+  <defs>
+    <linearGradient id="nodeGrad1" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#4a9be8"/>
+      <stop offset="100%" stop-color="#2d6fd4"/>
+    </linearGradient>
+    <linearGradient id="nodeGrad2" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#2d6fd4"/>
+      <stop offset="100%" stop-color="#1a4fa0"/>
+    </linearGradient>
+    <linearGradient id="nodeGrad3" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#1a3a7a"/>
+      <stop offset="100%" stop-color="#0f2654"/>
+    </linearGradient>
+    <linearGradient id="goldAccent" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#d4a843"/>
+      <stop offset="100%" stop-color="#f0c75e"/>
+    </linearGradient>
+  </defs>
+
+  <!-- === ASCENDING NODES ICON === -->
+  <g transform="translate(55, 100)">
+    <!-- Dashed connection lines -->
+    <line x1="-20" y1="30" x2="5" y2="8" stroke="#a3c8ee" stroke-width="1.8" stroke-dasharray="4,3" opacity="0.7"/>
+    <line x1="5" y1="8" x2="35" y2="-22" stroke="#7baee5" stroke-width="1.8" stroke-dasharray="4,3" opacity="0.7"/>
+    <line x1="-20" y1="30" x2="35" y2="-22" stroke="#5a94d8" stroke-width="1.5" stroke-dasharray="4,3" opacity="0.5"/>
+
+    <!-- Node 1 (smallest, bottom-left) -->
+    <circle cx="-20" cy="30" r="10" fill="url(#nodeGrad1)" opacity="0.85"/>
+    <circle cx="-20" cy="30" r="5.5" fill="none" stroke="#fff" stroke-width="1.5" opacity="0.5"/>
+
+    <!-- Node 2 (medium, middle) -->
+    <circle cx="5" cy="8" r="14" fill="url(#nodeGrad2)" opacity="0.9"/>
+    <circle cx="5" cy="8" r="8" fill="none" stroke="#fff" stroke-width="1.5" opacity="0.5"/>
+
+    <!-- Node 3 (largest, top-right) -->
+    <circle cx="35" cy="-22" r="20" fill="url(#nodeGrad3)"/>
+    <circle cx="35" cy="-22" r="12" fill="none" stroke="#fff" stroke-width="2" opacity="0.4"/>
+    <circle cx="35" cy="-22" r="6" fill="#2d6fd4" opacity="0.6"/>
+
+    <!-- Crown accent on top node -->
+    <polygon points="27,-46 31,-38 35,-42 39,-38 43,-46" fill="url(#goldAccent)" opacity="0.95"/>
+    <!-- Three crown dots -->
+    <circle cx="27" cy="-47.5" r="1.5" fill="#f0c75e"/>
+    <circle cx="35" cy="-43.5" r="1.5" fill="#f0c75e"/>
+    <circle cx="43" cy="-47.5" r="1.5" fill="#f0c75e"/>
+  </g>
+
+  <!-- === COMPANY NAME === -->
+  <text x="135" y="88" font-family="'Segoe UI', 'Helvetica Neue', Arial, sans-serif" font-size="42" font-weight="700" fill="#1a3a7a" letter-spacing="2">ROYAL</text>
+  <text x="135" y="128" font-family="'Segoe UI', 'Helvetica Neue', Arial, sans-serif" font-size="40" font-weight="300" fill="#2d6fd4" letter-spacing="6">SOLUTION</text>
+
+  <!-- Gold accent line -->
+  <rect x="135" y="140" width="90" height="2.5" rx="1.25" fill="url(#goldAccent)"/>
+
+  <!-- Tagline -->
+  <text x="135" y="163" font-family="'Segoe UI', 'Helvetica Neue', Arial, sans-serif" font-size="10.5" fill="#7a8aaa" letter-spacing="3.5" font-weight="400">TECHNOLOGY SOLUTIONS</text>
+</svg>