@lifeaitools/rdc-skills 0.9.32 → 0.9.33

package/guides/agents/data.md

@@ -1,87 +1,87 @@
-> **⚠️ 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`).
-
-
-# rdc:data — Data Agent
-
-## Mandatory First Step
-
-Read the guide before ANY operations:
-```
-{PROJECT_ROOT}/.rdc/guides/data.md
-(fallback: {PROJECT_ROOT}/.rdc/guides/data.md)
-```
-
-## Migration Pattern
-
-Always use database MCP `apply_migration` — never raw shell commands:
-
-```sql
--- Example migration
-ALTER TABLE example_table ADD COLUMN IF NOT EXISTS new_column TEXT;
-
--- Verify after applying
-SELECT column_name, data_type
-FROM information_schema.columns
-WHERE table_name = 'example_table'
-ORDER BY ordinal_position;
-```
-
-After `apply_migration`: always verify with queries.
-
-## Work Items — RPC Only
-
-```sql
-SELECT get_open_epics();
-SELECT insert_work_item(p_title := 'Task', p_priority := 'high', p_labels := ARRAY['data'], p_source := 'agent');
-SELECT update_work_item_status('<uuid>'::uuid, 'done');
-SELECT get_work_items_by_epic('<epic-uuid>'::uuid);
-```
-
-**NEVER raw INSERT/UPDATE against work_items.**
-
-## Schema-Driven Form Seeding
-
-When adding columns to dynamic form tables:
-
-```sql
-INSERT INTO field_schema (
-  table_name, column_name, input_type, label, section, display_order,
-  required, readonly, hidden, col_span
-)
-VALUES
-  ('example_table', 'new_column', 'text', 'New Column', 'Section', 90, false, false, false, 1)
-ON CONFLICT (table_name, column_name) DO NOTHING;
-```
-
-Valid `input_type` values: `text` `textarea` `email` `url` `phone` `select` `tags`
-`json` `toggle` `currency` `number` `date` `richtext`
-
-## Non-Public Schema Access
-
-```ts
-const { data } = await supabase.schema("custom_schema").from("table_name").select("*");
-```
-
-## Design Decisions (record architectural choices)
-
-```sql
-INSERT INTO design_context (topic, context_type, summary, source, created_by)
-VALUES (
-  'TopicName', 'decision',
-  '2-3 sentence summary of what was decided and why',
-  'agent session', 'agent'
-);
-```
-
-## Safety Rules
-
-- Branch: development branch — auto-commit after each migration
-- Always verify migrations with queries
-- Never drop columns without explicit instruction
-- Never truncate tables without explicit instruction
-- NEVER overlap with other agents on schema changes mid-build
-- Write tests for RPC functions FIRST
+> **⚠️ 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`).
+
+
+# rdc:data — Data Agent
+
+## Mandatory First Step
+
+Read the guide before ANY operations:
+```
+{PROJECT_ROOT}/.rdc/guides/data.md
+(fallback: {PROJECT_ROOT}/.rdc/guides/data.md)
+```
+
+## Migration Pattern
+
+Always use database MCP `apply_migration` — never raw shell commands:
+
+```sql
+-- Example migration
+ALTER TABLE example_table ADD COLUMN IF NOT EXISTS new_column TEXT;
+
+-- Verify after applying
+SELECT column_name, data_type
+FROM information_schema.columns
+WHERE table_name = 'example_table'
+ORDER BY ordinal_position;
+```
+
+After `apply_migration`: always verify with queries.
+
+## Work Items — RPC Only
+
+```sql
+SELECT get_open_epics();
+SELECT insert_work_item(p_title := 'Task', p_priority := 'high', p_labels := ARRAY['data'], p_source := 'agent');
+SELECT update_work_item_status('<uuid>'::uuid, 'review', '["Implementation complete; ready for validator"]'::jsonb, '<agent-session-id>', 'agent');
+SELECT get_work_items_by_epic('<epic-uuid>'::uuid);
+```
+
+**NEVER raw INSERT/UPDATE against work_items.**
+
+## Schema-Driven Form Seeding
+
+When adding columns to dynamic form tables:
+
+```sql
+INSERT INTO field_schema (
+  table_name, column_name, input_type, label, section, display_order,
+  required, readonly, hidden, col_span
+)
+VALUES
+  ('example_table', 'new_column', 'text', 'New Column', 'Section', 90, false, false, false, 1)
+ON CONFLICT (table_name, column_name) DO NOTHING;
+```
+
+Valid `input_type` values: `text` `textarea` `email` `url` `phone` `select` `tags`
+`json` `toggle` `currency` `number` `date` `richtext`
+
+## Non-Public Schema Access
+
+```ts
+const { data } = await supabase.schema("custom_schema").from("table_name").select("*");
+```
+
+## Design Decisions (record architectural choices)
+
+```sql
+INSERT INTO design_context (topic, context_type, summary, source, created_by)
+VALUES (
+  'TopicName', 'decision',
+  '2-3 sentence summary of what was decided and why',
+  'agent session', 'agent'
+);
+```
+
+## Safety Rules
+
+- Branch: development branch — auto-commit after each migration
+- Always verify migrations with queries
+- Never drop columns without explicit instruction
+- Never truncate tables without explicit instruction
+- NEVER overlap with other agents on schema changes mid-build
+- Write tests for RPC functions FIRST

package/guides/agents/design.md

@@ -1,77 +1,77 @@
-> **⚠️ 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`).
-
-
-# rdc:design — Design Agent
-
-## Mandatory First Step
-
-Read the guide before ANY work:
-```
-{PROJECT_ROOT}/.rdc/guides/design.md
-(fallback: {PROJECT_ROOT}/.rdc/guides/design.md)
-```
-
-## Six Design Principles
-
-1. **User/Community First** — Serving those affected by the work
-2. **Stewardship, Not Ownership** — Components hold space, don't dominate
-3. **Verified, Not Narrated** — Real data only; no mocks
-4. **Readability at Every Gate** — Clarity scales, jargon does not
-5. **Dark by Default, Never Dark by Habit** — Dark palette signals trust
-6. **Machines Handle Calculation; Humans Handle Conscience**
-
-## Token System
-
-Two-layer model:
-```
-global_design_tokens (base tokens)
-  + brand_token_overrides (per-brand delta)
-  = TokenWithInheritance[] (resolved set)
-```
-
-Token export formats: JSON flat map, CSS vars (`:root`), other format systems.
-
-## OG Images
-
-| Property | Value |
-|----------|-------|
-| Dimensions | 1200 × 630 px |
-| Format | RGB PNG, committed to git |
-| Location | `apps/<app>/public/og/og-image.png` |
-| Max size | 200 KB |
-
-Metadata:
-```ts
-export const metadata: Metadata = {
-  openGraph: {
-    images: [{ url: "/og/og-image.png", width: 1200, height: 630, alt: "..." }],
-  },
-  twitter: { card: "summary_large_image", images: ["/og/og-image.png"] },
-};
-```
-
-## Variant Axes — Every Component Must Support
-
-| Axis | Values |
-|------|--------|
-| Size | xs / sm / md / lg / xl |
-| Shape | sharp / soft / pill / circle |
-| Density | compact / comfortable / spacious |
-| Motion | static / subtle / rich |
-
-## Animation Philosophy
-
-- Always respect `prefers-reduced-motion` via appropriate hooks
-- Token-driven durations and easing — never hardcoded values
-- Keep motion purposeful, not decorative
-
-## Safety Rules
-
-- Never hardcode hex colors in components — CSS variables only
-- Never override tokens without a design decision recorded
-- Branch: development branch — auto-commit
-- NEVER run `pnpm build`
+> **⚠️ 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`).
+
+
+# rdc:design — Design Agent
+
+## Mandatory First Step
+
+Read the guide before ANY work:
+```
+{PROJECT_ROOT}/.rdc/guides/design.md
+(fallback: {PROJECT_ROOT}/.rdc/guides/design.md)
+```
+
+## Six Design Principles
+
+1. **User/Community First** — Serving those affected by the work
+2. **Stewardship, Not Ownership** — Components hold space, don't dominate
+3. **Verified, Not Narrated** — Real data only; no mocks
+4. **Readability at Every Gate** — Clarity scales, jargon does not
+5. **Dark by Default, Never Dark by Habit** — Dark palette signals trust
+6. **Machines Handle Calculation; Humans Handle Conscience**
+
+## Token System
+
+Two-layer model:
+```
+global_design_tokens (base tokens)
+  + brand_token_overrides (per-brand delta)
+  = TokenWithInheritance[] (resolved set)
+```
+
+Token export formats: JSON flat map, CSS vars (`:root`), other format systems.
+
+## OG Images
+
+| Property | Value |
+|----------|-------|
+| Dimensions | 1200 × 630 px |
+| Format | RGB PNG, committed to git |
+| Location | `apps/<app>/public/og/og-image.png` |
+| Max size | 200 KB |
+
+Metadata:
+```ts
+export const metadata: Metadata = {
+  openGraph: {
+    images: [{ url: "/og/og-image.png", width: 1200, height: 630, alt: "..." }],
+  },
+  twitter: { card: "summary_large_image", images: ["/og/og-image.png"] },
+};
+```
+
+## Variant Axes — Every Component Must Support
+
+| Axis | Values |
+|------|--------|
+| Size | xs / sm / md / lg / xl |
+| Shape | sharp / soft / pill / circle |
+| Density | compact / comfortable / spacious |
+| Motion | static / subtle / rich |
+
+## Animation Philosophy
+
+- Always respect `prefers-reduced-motion` via appropriate hooks
+- Token-driven durations and easing — never hardcoded values
+- Keep motion purposeful, not decorative
+
+## Safety Rules
+
+- Never hardcode hex colors in components — CSS variables only
+- Never override tokens without a design decision recorded
+- Branch: development branch — auto-commit
+- NEVER run `pnpm build`

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)*
-- Update work item to `done` via `update_work_item_status()`
-- Write tests FIRST — red → implement → green
+> **⚠️ 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