@lifeaitools/rdc-skills 0.25.1 → 0.25.2

package/guides/agents/frontend.md

@@ -1,92 +1,92 @@
-> **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
-> Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
-> One checklist upfront, updated in place, shown again at end with a 1-line verdict.
-
-> If dispatching subagents or running as a subagent: read `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md` first (fallback: `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md`).
-
-> **Sandbox contract:** This guide honors `RDC_TEST=1` per `guides/agent-bootstrap.md` § RDC_TEST Sandbox Contract. Destructive external calls short-circuit under the flag.
-
-
-# rdc:frontend — Frontend Agent
-
-## Mandatory First Step
-
-Read the guide before ANY code:
-```
-{PROJECT_ROOT}/.rdc/guides/frontend.md
-(fallback: {PROJECT_ROOT}/.rdc/guides/frontend.md)
-```
-
-## Before Writing Any Code
-
-1. **Check for existing prototypes:**
-   ```sql
-   SELECT name, component, source_path, status, notes
-   FROM prototype_registry
-   WHERE status IN ('prototype', 'converting')
-   ORDER BY created_at DESC;
-   ```
-   If a prototype exists: **ADAPT IT. Do not build from scratch.**
-
-2. **Check design decisions:**
-   ```sql
-   SELECT topic, summary FROM design_context
-   WHERE topic ILIKE '%<task-topic>%'
-   ORDER BY created_at DESC;
-   ```
-
-3. **Read the app CLAUDE.md** for the target app.
-
-## New Component Contract
-
-All new components follow the standard pattern:
-
-```tsx
-"use client"; // only if uses hooks/browser APIs
-import * as React from "react";
-import { cva, type VariantProps } from "class-variance-authority";
-import { cn } from "../lib/utils";
-
-const myComponentVariants = cva("base-classes", {
-  variants: {
-    variant: { default: "", outline: "" },
-    size: { sm: "", md: "", lg: "" },
-  },
-  defaultVariants: { variant: "default", size: "md" },
-});
-
-interface MyComponentProps
-  extends React.HTMLAttributes<HTMLDivElement>,
-    VariantProps<typeof myComponentVariants> {}
-
-const MyComponent = React.forwardRef<HTMLDivElement, MyComponentProps>(
-  ({ className, variant, size, ...props }, ref) => (
-    <div ref={ref} className={cn(myComponentVariants({ variant, size }), className)} {...props} />
-  )
-);
-MyComponent.displayName = "MyComponent";
-export { MyComponent, myComponentVariants };
-```
-
-Then re-export from the package's index.
-
-## Next.js Patterns
-
-- App Router (modern) — use `src/app/`
-- Dynamic imports for browser-only libs
-- `transpilePackages` in next.config must list all monorepo packages used
-- Auth: use the auth helpers for protected apps; pass-through for public
-
-## Colors — CSS Variables ONLY
-
-Never hardcode hex values in components. Always use CSS variables from the app's globals.css.
-
-## Safety Rules
-
-- Branch: development branch — auto-commit after logical blocks
-- NEVER run `pnpm build` — crashes the system; code only
-- NEVER overlap with other agents on the same files
-- NEVER modify files outside your assigned scope
-- After completing: commit with descriptive message, push *(skip push if `$RDC_TEST=1` — echo `[RDC_TEST] skipping git push` instead)*
+> **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
+> Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
+> One checklist upfront, updated in place, shown again at end with a 1-line verdict.
+
+> If dispatching subagents or running as a subagent: read `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md` first (fallback: `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md`).
+
+> **Sandbox contract:** This guide honors `RDC_TEST=1` per `guides/agent-bootstrap.md` § RDC_TEST Sandbox Contract. Destructive external calls short-circuit under the flag.
+
+
+# rdc:frontend — Frontend Agent
+
+## Mandatory First Step
+
+Read the guide before ANY code:
+```
+{PROJECT_ROOT}/.rdc/guides/frontend.md
+(fallback: {PROJECT_ROOT}/.rdc/guides/frontend.md)
+```
+
+## Before Writing Any Code
+
+1. **Check for existing prototypes:**
+   ```sql
+   SELECT name, component, source_path, status, notes
+   FROM prototype_registry
+   WHERE status IN ('prototype', 'converting')
+   ORDER BY created_at DESC;
+   ```
+   If a prototype exists: **ADAPT IT. Do not build from scratch.**
+
+2. **Check design decisions:**
+   ```sql
+   SELECT topic, summary FROM design_context
+   WHERE topic ILIKE '%<task-topic>%'
+   ORDER BY created_at DESC;
+   ```
+
+3. **Read the app CLAUDE.md** for the target app.
+
+## New Component Contract
+
+All new components follow the standard pattern:
+
+```tsx
+"use client"; // only if uses hooks/browser APIs
+import * as React from "react";
+import { cva, type VariantProps } from "class-variance-authority";
+import { cn } from "../lib/utils";
+
+const myComponentVariants = cva("base-classes", {
+  variants: {
+    variant: { default: "", outline: "" },
+    size: { sm: "", md: "", lg: "" },
+  },
+  defaultVariants: { variant: "default", size: "md" },
+});
+
+interface MyComponentProps
+  extends React.HTMLAttributes<HTMLDivElement>,
+    VariantProps<typeof myComponentVariants> {}
+
+const MyComponent = React.forwardRef<HTMLDivElement, MyComponentProps>(
+  ({ className, variant, size, ...props }, ref) => (
+    <div ref={ref} className={cn(myComponentVariants({ variant, size }), className)} {...props} />
+  )
+);
+MyComponent.displayName = "MyComponent";
+export { MyComponent, myComponentVariants };
+```
+
+Then re-export from the package's index.
+
+## Next.js Patterns
+
+- App Router (modern) — use `src/app/`
+- Dynamic imports for browser-only libs
+- `transpilePackages` in next.config must list all monorepo packages used
+- Auth: use the auth helpers for protected apps; pass-through for public
+
+## Colors — CSS Variables ONLY
+
+Never hardcode hex values in components. Always use CSS variables from the app's globals.css.
+
+## Safety Rules
+
+- Branch: development branch — auto-commit after logical blocks
+- NEVER run `pnpm build` — crashes the system; code only
+- NEVER overlap with other agents on the same files
+- NEVER modify files outside your assigned scope
+- After completing: commit with descriptive message, push *(skip push if `$RDC_TEST=1` — echo `[RDC_TEST] skipping git push` instead)*
 - Submit `implementation_report.codeflow_post`, then update work item to `review` via `update_work_item_status(..., p_actor_role := 'agent')`; validators close `done`
-- Write tests FIRST — red → implement → green
+- Write tests FIRST — red → implement → green

package/guides/agents/infrastructure.md

@@ -1,81 +1,81 @@
-> **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
-> Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
-> One checklist upfront, updated in place, shown again at end with a 1-line verdict.
-
-> If dispatching subagents or running as a subagent: read `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md` first (fallback: `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md`).
-
-> **Sandbox contract:** This guide honors `RDC_TEST=1` per `guides/agent-bootstrap.md` § RDC_TEST Sandbox Contract. Destructive external calls short-circuit under the flag — Coolify deploys, DNS writes, CF cache purges, container restarts, and `git push` are all skipped. Registry SELECTs, health checks, and git reads run normally.
-
-
-# rdc:infra — Infrastructure Agent
-
-## Mandatory First Step
-
-Read the guide before ANY operations:
-```
-{PROJECT_ROOT}/.rdc/guides/infrastructure.md
-(fallback: {PROJECT_ROOT}/.rdc/guides/infrastructure.md)
-```
-
-## Rule 1: Never Work Around Broken Infrastructure
-
-When a service is unavailable, STOP and report:
-```
-BLOCKED: [service] is not responding.
-Fix: [reconnect MCP / restart credential daemon]
-I cannot proceed until this is resolved.
-```
-
-## Deployment Registry — Check BEFORE Any Deploy
-
-```sql
-SELECT get_deployment('<slug>');
-SELECT slug, display_name, domain, build_type, status FROM deployment_registry ORDER BY slug;
-```
-
-**NEVER guess deployment UUIDs, domains, or build commands.**
-
-## Watch Paths — Must Set on Every Monorepo App
-
-| App Type | Watch Paths |
-|----------|-------------|
-| Monorepo app | `apps/<n>/**` and `packages/**` |
-| Static monorepo | `sites/<n>/**` |
-
-Without watch_paths, every push rebuilds all apps.
-
-## Build Types
-
-| Type | Pack | Install | Build |
-|------|------|---------|-------|
-| Monorepo | nixpacks | `pnpm install --frozen-lockfile` | `pnpm turbo run build --filter=<filter>` |
-| Static | static | — | — |
-
-## New App — Checklist
-
-1. Look up deployment registry for existing entry
-2. Check for Coolify UUID (if exists)
-3. Set watch_paths per app type *(skip if `$RDC_TEST=1` — echo `[RDC_TEST] skipping Coolify config write`)*
-4. Deploy and verify health *(skip if `$RDC_TEST=1` — echo `[RDC_TEST] skipping Coolify deploy`)*
-5. Update deployment_registry in database
-
-## Environment Tiers
-
-| Tier | Rules |
-|------|-------|
-| development | Free to experiment, no confirmation needed |
-| staging | Confirm before deploying |
-| production | ALWAYS confirm before deploy, ALWAYS verify after |
-
-## Git Workflow
-
-- Branch: development branch — NEVER touch production
-- Before push: `git fetch origin`
-- Never force-push
-
-## Safety Rules
-
-- MCP connectors first, credential daemon second
-- Never print credential keys to stdout
-- If daemon is down: report BLOCKED, do not work around it
-- Push after every logical block *(skip if `$RDC_TEST=1` — echo `[RDC_TEST] skipping git push` instead)*
+> **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
+> Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
+> One checklist upfront, updated in place, shown again at end with a 1-line verdict.
+
+> If dispatching subagents or running as a subagent: read `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md` first (fallback: `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md`).
+
+> **Sandbox contract:** This guide honors `RDC_TEST=1` per `guides/agent-bootstrap.md` § RDC_TEST Sandbox Contract. Destructive external calls short-circuit under the flag — Coolify deploys, DNS writes, CF cache purges, container restarts, and `git push` are all skipped. Registry SELECTs, health checks, and git reads run normally.
+
+
+# rdc:infra — Infrastructure Agent
+
+## Mandatory First Step
+
+Read the guide before ANY operations:
+```
+{PROJECT_ROOT}/.rdc/guides/infrastructure.md
+(fallback: {PROJECT_ROOT}/.rdc/guides/infrastructure.md)
+```
+
+## Rule 1: Never Work Around Broken Infrastructure
+
+When a service is unavailable, STOP and report:
+```
+BLOCKED: [service] is not responding.
+Fix: [reconnect MCP / restart credential daemon]
+I cannot proceed until this is resolved.
+```
+
+## Deployment Registry — Check BEFORE Any Deploy
+
+```sql
+SELECT get_deployment('<slug>');
+SELECT slug, display_name, domain, build_type, status FROM deployment_registry ORDER BY slug;
+```
+
+**NEVER guess deployment UUIDs, domains, or build commands.**
+
+## Watch Paths — Must Set on Every Monorepo App
+
+| App Type | Watch Paths |
+|----------|-------------|
+| Monorepo app | `apps/<n>/**` and `packages/**` |
+| Static monorepo | `sites/<n>/**` |
+
+Without watch_paths, every push rebuilds all apps.
+
+## Build Types
+
+| Type | Pack | Install | Build |
+|------|------|---------|-------|
+| Monorepo | nixpacks | `pnpm install --frozen-lockfile` | `pnpm turbo run build --filter=<filter>` |
+| Static | static | — | — |
+
+## New App — Checklist
+
+1. Look up deployment registry for existing entry
+2. Check for Coolify UUID (if exists)
+3. Set watch_paths per app type *(skip if `$RDC_TEST=1` — echo `[RDC_TEST] skipping Coolify config write`)*
+4. Deploy and verify health *(skip if `$RDC_TEST=1` — echo `[RDC_TEST] skipping Coolify deploy`)*
+5. Update deployment_registry in database
+
+## Environment Tiers
+
+| Tier | Rules |
+|------|-------|
+| development | Free to experiment, no confirmation needed |
+| staging | Confirm before deploying |
+| production | ALWAYS confirm before deploy, ALWAYS verify after |
+
+## Git Workflow
+
+- Branch: development branch — NEVER touch production
+- Before push: `git fetch origin`
+- Never force-push
+
+## Safety Rules
+
+- MCP connectors first, credential daemon second
+- Never print credential keys to stdout
+- If daemon is down: report BLOCKED, do not work around it
+- Push after every logical block *(skip if `$RDC_TEST=1` — echo `[RDC_TEST] skipping git push` instead)*