@pugi/cli 1.0.0-alpha.19 → 1.0.0-alpha.191

package/skills/market-research/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: market-research
+description: "Runs search over a topic, summarises findings with citations using research methods frameworks."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Market Research
+
+Runs search over a topic, summarises findings with citations using research methods frameworks.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `marketing_frameworks`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `researcher` (THE_TEN Agent×Skill×RAG matrix).

package/skills/metrics-dashboard/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: metrics-dashboard
+description: "Designs KPI dashboards — DAU, MRR, retention, funnel cohorts — grounded in dashboard/chart block templates."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Metrics Dashboard
+
+Designs KPI dashboards — DAU, MRR, retention, funnel cohorts — grounded in dashboard/chart block templates.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `landing_templates`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `analyst` (THE_TEN Agent×Skill×RAG matrix).

package/skills/monitoring-setup/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: monitoring-setup
+description: "Wires Prometheus / Grafana / Langfuse instrumentation into a service."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Monitoring Setup
+
+Wires Prometheus / Grafana / Langfuse instrumentation into a service.
+
+
+## Owner
+
+Owner persona: `devops` (THE_TEN Agent×Skill×RAG matrix).

package/skills/motion/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: motion
+description: "Motion patterns — springs, transitions, staggering, reduced-motion compliance."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Motion & Animation
+
+Motion patterns — springs, transitions, staggering, reduced-motion compliance.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `motion_assets`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `designer` (THE_TEN Agent×Skill×RAG matrix).

package/skills/nestjs-api/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: nestjs-api
+description: "Generates idiomatic NestJS modules, controllers, services, DTOs."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# NestJS API Builder
+
+Generates idiomatic NestJS modules, controllers, services, DTOs.
+
+## Rules
+
+- Every dependency you import must be in package.json before you import it. A test file is code: importing `@nestjs/testing` without adding it fails the build for the whole project, not just the test.
+- Run the project's own build once before reporting done. `tsc` is the cheapest reviewer you have and it reads the tsconfig the customer will ship with, not the one you assumed.
+- Any `@nestjs/*` package you add must carry the SAME major as the `@nestjs/common` already in package.json. Read it; never write a version from memory. A mismatched major makes `npm install` refuse the whole tree with ERESOLVE, and then nothing installs at all — which surfaces as a missing runtime module, not as a version problem.
+
+
+## Known failure modes
+
+Read `quirks.md` in this directory BEFORE writing code in this domain. It records 3 failures that reached a customer build, each with the symptom, the cause, and the check that tells them apart.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `framework_nestjs`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `dev` (THE_TEN Agent×Skill×RAG matrix).

package/skills/nestjs-api/quirks.md

@@ -0,0 +1,36 @@
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# NestJS API Builder — known failure modes
+
+Each entry below reached a customer build. The symptom is what you will
+actually observe; the build succeeds in every one of these cases.
+
+## strict-property-initialization
+
+**Symptom.** The build fails with `TS2564: Property 'x' has no initializer and is not definitely assigned in the constructor` on every DTO field.
+
+**Cause.** The NestJS starter enables `strictPropertyInitialization`. A DTO declares fields the framework fills at runtime from the request body, which the compiler cannot see.
+
+**Check.** Read `strict` and `strictPropertyInitialization` in tsconfig.json before writing the first DTO.
+
+**Fix.** Declare DTO fields with the definite-assignment marker — `image!: string` — or give them a default. Do not disable the compiler flag to make the error go away: it protects the rest of the code.
+
+## test-imports-uninstalled-package
+
+**Symptom.** The build fails with `TS2307: Cannot find module '@nestjs/testing'` even though the application code is fine.
+
+**Cause.** A spec file was written importing the testing utilities, but the package was never added to devDependencies. `tsc -p tsconfig.json` compiles spec files too, so one unbuildable test fails the whole project.
+
+**Check.** Before writing a `.test.ts`/`.spec.ts`, check that every module it imports appears in package.json. `@nestjs/testing` is NOT part of the default starter.
+
+**Fix.** Add the package to devDependencies and install it, or do not write the test. A test that cannot compile is worse than no test — it takes the build down with it. Pick the version by the rule in the next entry — a wrong one is worse than the missing package.
+
+## nest-package-version-must-match-the-installed-major
+
+**Symptom.** `npm install` ends with `npm error code ERESOLVE` and a "could not resolve dependency" block naming a peer. node_modules is NOT created, so the next command fails on something unrelated-looking — typically `Cannot find module '@nestjs/core'`, which is NOT the problem.
+
+**Cause.** A `@nestjs/*` package was added at a version from a different major than the Nest already in the project. Measured on a live customer preview 2026-09-10: `@nestjs/common@10.4.22` was installed and a generated `@nestjs/testing@4.6.6` demanded `@nestjs/common@"^4.*"`, so npm refused the WHOLE tree. `--omit=dev` does not save you — npm resolves everything before omitting, so one bad dev pin blocks the production install too.
+
+**Check.** Before adding any `@nestjs/*` package, read the version of `@nestjs/common` (or `@nestjs/core`) already in package.json and use the SAME major. Never write a version from memory. When an install fails, read the INSTALL output — the crash you see is several steps downstream.
+
+**Fix.** Match the major — with `@nestjs/common@^10`, write `"@nestjs/testing": "^10"`. If unsure, install without a version (`npm install -D @nestjs/testing`) and let npm pick a compatible one, then confirm the install exited 0.

package/skills/nextjs-page/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: nextjs-page
+description: "Builds Next.js App Router pages with shadcn/ui + Tailwind."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Next.js Page Builder
+
+Builds Next.js App Router pages with shadcn/ui + Tailwind.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `framework_nextjs`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `frontend` (THE_TEN Agent×Skill×RAG matrix).

package/skills/orchestrating-multi-agent-systems/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: orchestrating-multi-agent-systems
+description: "Designs and coordinates multi-agent topologies (planner / workers / critics) grounded in the AI SDK cookbook patterns."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Orchestrating Multi Agent Systems
+
+Designs and coordinates multi-agent topologies (planner / workers / critics) grounded in the AI SDK cookbook patterns.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `ai_sdk_cookbook`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `pugi` (THE_TEN Agent×Skill×RAG matrix).

package/skills/preprocessing-data/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: preprocessing-data
+description: "Cleans, transforms, and feature-engineers datasets for analysis or ML."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Preprocessing Data
+
+Cleans, transforms, and feature-engineers datasets for analysis or ML.
+
+
+## Owner
+
+Owner persona: `analyst` (THE_TEN Agent×Skill×RAG matrix).

package/skills/project-memory-keeper/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: project-memory-keeper
+description: "Maintains shared project state — name, stack, goals, decisions log — grounded in the Pugi corpus."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Project Memory Keeper
+
+Maintains shared project state — name, stack, goals, decisions log — grounded in the Pugi corpus.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `mira_knowledge`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `pugi` (THE_TEN Agent×Skill×RAG matrix).

package/skills/public-apis/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: public-apis
+description: "Finds and evaluates public/third-party APIs from the daily-ingested catalog (ADR-0041)."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Public APIs Catalog
+
+Finds and evaluates public/third-party APIs from the daily-ingested catalog (ADR-0041).
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `public_apis_catalog`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `researcher` (THE_TEN Agent×Skill×RAG matrix).

package/skills/pugi-patterns/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: pugi-patterns
+description: "Retrieves canonical Pugi implementation patterns (module shapes, proxy routes, migrations, RLS) before any build decision."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Pugi Patterns
+
+Retrieves canonical Pugi implementation patterns (module shapes, proxy routes, migrations, RLS) before any build decision.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `pugi_patterns`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `pugi` (THE_TEN Agent×Skill×RAG matrix).

package/skills/react-component/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: react-component
+description: "Builds composable React + TypeScript components with proper typing."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# React Component Library
+
+Builds composable React + TypeScript components with proper typing.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `ui_registry`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `frontend` (THE_TEN Agent×Skill×RAG matrix).

package/skills/sprint-planning/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: sprint-planning
+description: "Decomposes goals into sprint backlogs with capacity-aware estimates — grounded in agile/service-design methods."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Sprint Planning
+
+Decomposes goals into sprint backlogs with capacity-aware estimates — grounded in agile/service-design methods.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `marketing_frameworks`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `pm` (THE_TEN Agent×Skill×RAG matrix).

package/skills/stack-selection/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: stack-selection
+description: "Helps pick framework / DB / deployment stack based on project constraints."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Tech Stack Selection
+
+Helps pick framework / DB / deployment stack based on project constraints.
+
+
+## Owner
+
+Owner persona: `architect` (THE_TEN Agent×Skill×RAG matrix).

package/skills/standup-summary/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: standup-summary
+description: "Daily summary of what each teammate did, blockers, next steps."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Standup Summary
+
+Daily summary of what each teammate did, blockers, next steps.
+
+
+## Owner
+
+Owner persona: `pm` (THE_TEN Agent×Skill×RAG matrix).

package/skills/task-decomposition/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: task-decomposition
+description: "Breaks vague requests into concrete sub-tasks with dependencies, aligned to how Pugi actually builds."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Task Decomposition
+
+Breaks vague requests into concrete sub-tasks with dependencies, aligned to how Pugi actually builds.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `pugi_patterns`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `pm` (THE_TEN Agent×Skill×RAG matrix).

package/skills/team-routing/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: team-routing
+description: "Routes incoming requests to the right teammate by role / expertise."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Team Routing
+
+Routes incoming requests to the right teammate by role / expertise.
+
+
+## Owner
+
+Owner persona: `pugi` (THE_TEN Agent×Skill×RAG matrix).

package/skills/tech-survey/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: tech-survey
+description: "Compares 3-5 technical options against project criteria, recommends."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Tech Survey
+
+Compares 3-5 technical options against project criteria, recommends.
+
+
+## Owner
+
+Owner persona: `researcher` (THE_TEN Agent×Skill×RAG matrix).

package/skills/test-plan/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: test-plan
+description: "Drafts test plans covering happy path, edge cases, regression scope."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Test Plan Author
+
+Drafts test plans covering happy path, edge cases, regression scope.
+
+
+## Owner
+
+Owner persona: `pm` (THE_TEN Agent×Skill×RAG matrix).

package/skills/typescript-refactor/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: typescript-refactor
+description: "Refactors TS code for readability, type-safety, and conventions."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# TypeScript Refactor
+
+Refactors TS code for readability, type-safety, and conventions.
+
+
+## Owner
+
+Owner persona: `dev` (THE_TEN Agent×Skill×RAG matrix).

package/skills/ui-components/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: ui-components
+description: "shadcn/ui v4 registry knowledge — component anatomy, variants, composition."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# UI Components
+
+shadcn/ui v4 registry knowledge — component anatomy, variants, composition.
+
+## Rules
+
+- A card is for an object the person can SELECT, COMPARE or OPEN. Anything else — a heading with text under it, a stat, a paragraph — is not a card. A page of cards is a page of grey boxes and the eye cannot find the one thing that matters.
+- Before shipping a screen, count its containers and delete half. If removing a border changes nothing but the border, remove it.
+- Reuse the component the project already has before writing markup. Two definitions of the same control on one screen is how a design system stops being one.
+- Every interactive element needs hover, focus-visible and disabled. A control that only reacts to hover does not exist on a phone.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `ui_registry`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `designer` (THE_TEN Agent×Skill×RAG matrix).

package/skills/ux-patterns/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: ux-patterns
+description: "Service-design and research methods — journey maps, usability tests, heuristics."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# UX Patterns
+
+Service-design and research methods — journey maps, usability tests, heuristics.
+
+## Rules
+
+- Every action has four states: loading, empty, error, success. Ship all four or the action is unfinished. A pressed button that answers with silence reads as broken.
+- Loading is a skeleton shaped like the content that is coming, not a spinner in the middle of nothing.
+- Success is visible and says what happened. Silence after a successful action is indistinguishable from failure.
+- After each state, the next step must be obvious. An error with no way forward leaves the person stuck on your screen.
+- Do not make the reader think. If a screen needs instructions, the screen is the problem.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `marketing_frameworks`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `designer` (THE_TEN Agent×Skill×RAG matrix).

package/skills/web-platform/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: web-platform
+description: "MDN-grounded web platform knowledge — CSS, layout, web APIs, HTTP semantics."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Web Platform (MDN)
+
+MDN-grounded web platform knowledge — CSS, layout, web APIs, HTTP semantics.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `web_platform`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `frontend` (THE_TEN Agent×Skill×RAG matrix).

package/skills/web-scrape/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: web-scrape
+description: "Fetches a URL, extracts clean text/markdown for reading or RAG ingestion."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Web Scrape
+
+Fetches a URL, extracts clean text/markdown for reading or RAG ingestion.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `web_platform`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `researcher` (THE_TEN Agent×Skill×RAG matrix).

package/skills/web-search/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: web-search
+description: "Searches the web and returns ranked, cited results."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Web Search
+
+Searches the web and returns ranked, cited results.
+
+
+## Owner
+
+Owner persona: `researcher` (THE_TEN Agent×Skill×RAG matrix).

package/skills/webapp-testing/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: webapp-testing
+description: "Authors and runs Playwright end-to-end tests against a running web application."
+---
+
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Webapp Testing
+
+Authors and runs Playwright end-to-end tests against a running web application.
+
+## Rules
+
+- The platform refuses to deliver an application whose `package.json` has no `test` script, and refuses one whose tests fail. Treat both as part of the definition of done, not as a final formality.
+- Test what the customer will do — open the page, click the main action, read the result. A suite that only asserts a module imports proves the bundler works, not the product.
+
+
+## Known failure modes
+
+Read `quirks.md` in this directory BEFORE writing code in this domain. It records 2 failures that reached a customer build, each with the symptom, the cause, and the check that tells them apart.
+
+
+## Grounding
+
+This skill retrieves from the Anvil RAG workspace `web_platform`. Ask grounded questions in that domain before inventing answers.
+
+## Owner
+
+Owner persona: `qa` (THE_TEN Agent×Skill×RAG matrix).

package/skills/webapp-testing/quirks.md

@@ -0,0 +1,26 @@
+<!-- Generated by Pugi. Do not hand-edit; regenerate from the persona pack. -->
+
+# Webapp Testing — known failure modes
+
+Each entry below reached a customer build. The symptom is what you will
+actually observe; the build succeeds in every one of these cases.
+
+## delivery-blocked-by-missing-test-script
+
+**Symptom.** Everything looks finished, then the push is refused with `verification failed: package.json scripts.test is required` and no application is delivered.
+
+**Cause.** The system-owned acceptance gate runs immediately before the authoritative push and requires a real `test` script. It is deliberately not something the model can supply or skip, so it is discovered at the very end.
+
+**Check.** Read `scripts.test` in package.json at the START of the work, not after the build.
+
+**Fix.** Define a `test` script that actually runs the suite, and make it pass. A placeholder that exits 0 satisfies the letter of the gate and delivers an untested app — write the tests instead.
+
+## unbuildable-test-fails-the-whole-project
+
+**Symptom.** The application code compiles when you check it, but the delivery gate reports `pugi verification: test` and the push is refused.
+
+**Cause.** The project's build compiles spec files too. A test importing a package that was never added to package.json, or a type error inside a test, fails the whole compile — the application is fine and still cannot ship.
+
+**Check.** Run the project's own build once with the tests in place, before reporting done.
+
+**Fix.** Add every package a test imports to devDependencies, or delete the test. A test that cannot compile is worse than no test: it takes the delivery down with it.