nurosys-agents 2.0.0 → 2.1.0

package/.agent/INSTRUCTIONS.md

@@ -49,7 +49,9 @@ If you exceed these, narrow scope or escalate to one targeted `Read`. Don't fan
 
 ## Skills shipped by this package
 
-Slash commands (Claude Code, Cursor) or natural-language triggers:
+Slash commands (Claude Code, Cursor) or natural-language triggers. The skill set differs slightly by stack — `setup.js` wires the right set during install.
+
+### Backend stack (NestJS / Express / Fastify / Koa)
 
 | Skill | Purpose |
 |---|---|
@@ -65,10 +67,27 @@ Slash commands (Claude Code, Cursor) or natural-language triggers:
 | `/refactor-safely` | Symbol-level refactors with bounded blast radius |
 | `/debug-issue` | Systematically trace a bug from its stack trace |
 
+### Frontend stack (React / Next.js / Vite)
+
+Same as backend **plus** two frontend-specific skills, and a frontend-flavored journey:
+
+| Skill | Purpose |
+|---|---|
+| `/ux-architect` | **Frontend only.** Plan UX/layout/composition for a feature using `/vuexy-component-guide` as a read-only sub-agent for component reuse. Produces `<feature>_UX_PLAN.md`. NEVER writes code. |
+| `/vuexy-component-guide` | **Frontend only.** MUI v7 + Vuexy component reference. Standalone mode = conversational guidance. Sub-agent mode (called by `/ux-architect`) = JSON reuse-candidates + gaps. |
+
+Frontend `/code-reviewer` additionally enforces the 23 React-specific rules (Rules of React, rerender optimization, rendering performance, advanced patterns) — files under `<package>/.agent/frontend/skills/code-reviewer/rules/`.
+
+Frontend `/security-assessment` covers client-side concerns: XSS, CSP, `NEXT_PUBLIC_` leakage, client-only auth bypass, third-party scripts, cookies/storage.
+
+Frontend `/auth-and-permissions` audits client-side gating (private routes, useAuth, permission keys) — backend auth is enforced server-side; the UI just reflects it.
+
 ---
 
 ## The end-to-end developer journey
 
+### Backend
+
 ```
 1. /create-blueprint all          → seeds project-memory/
 2. /brainstorm <problem>          → explore approaches
@@ -76,6 +95,17 @@ Slash commands (Claude Code, Cursor) or natural-language triggers:
 4. /module-runner <feature-folder>→ autonomous build, review, security, commit per module
 ```
 
+### Frontend (one extra step — UX planning)
+
+```
+1. /create-blueprint all          → seeds project-memory/ (incl. design-system.md)
+2. /brainstorm <problem>          → explore approaches
+3. /ux-architect <feature>        → UX/layout plan using /vuexy-component-guide
+                                    sub-agent for reuse; produces UX_PLAN.md
+4. /architect <feature>           → technical module plan referencing UX_PLAN
+5. /module-runner <feature-folder>→ autonomous build, review, security, commit per module
+```
+
 Quick utilities usable anywhere:
 - `/quick-execute <small task>` for one-off fixes
 - `/code-reviewer` to manually review the current branch