Copy# Add a new block from source
/block github:tanstack/table
/block shadcn:sidebar-07
/block magicui:shimmer-button
 
# Manage existing blocks
/block list              # List all blocks
/block refactor table    # Refactor block
/block audit table       # Quality audit (100-point)
/block update table      # Update from source

Copy# Add block from GitHub
/block github:example/invoice-generator
 
# The block-processor will:
# 1. Fetch block files
# 2. Transform imports
# 3. Adapt to Auth.js + Prisma
# 4. Create mirror-pattern structure
# 5. Add i18n support
# 6. Run initial audit

Copy// src/app/[lang]/(root)/blocks/my-block/page.tsx
import { getDictionary } from "@/components/local/dictionaries"
import type { Locale } from "@/components/local/config"
import MyBlockContent from "@/components/root/block/my-block/content"
 
interface PageProps {
  params: Promise<{ lang: Locale }>
}
 
export default async function MyBlockPage({ params }: PageProps) {
  const { lang } = await params
  const dictionary = await getDictionary(lang)
 
  return <MyBlockContent dictionary={dictionary} lang={lang} />
}

Copy// src/components/root/block/my-block/content.tsx
import type { getDictionary } from "@/components/local/dictionaries"
import type { Locale } from "@/components/local/config"
 
interface MyBlockContentProps {
  dictionary: Awaited<ReturnType<typeof getDictionary>>
  lang: Locale
}
 
export default function MyBlockContent({ dictionary, lang }: MyBlockContentProps) {
  return (
    <div dir={lang === 'ar' ? 'rtl' : 'ltr'}>
      {/* Block content */}
    </div>
  )
}

Copy// src/components/root/block/my-block/config.ts
export const myBlockConfig = {
  id: "my-block",
  name: "My Block",
  description: "Description of what this block does",
  category: "forms",
  version: "1.0.0",
}

Copy// ~/.claude/memory/block.json
{
  "blocks": [
    {
      "id": "my-block",
      "name": "My Block",
      "source": "internal",
      "route": "/blocks/my-block",
      "component": "src/components/root/block/my-block",
      "category": "forms",
      "status": "active"
    }
  ]
}

Copy/block refactor table

Copy// Use existing Auth.js integration
import { currentUser } from "@/lib/auth"
import { useCurrentUser } from "@/components/auth/use-current-user"

Copy// Use existing Prisma client
import { db } from "@/lib/db"
 
// Follow multi-file schema pattern
// prisma/models/invoice.prisma

Copy// Use existing shadcn/ui components
import { Button } from "@/components/ui/button"
import { Card } from "@/components/ui/card"
 
// Use existing atoms
import { StatCard } from "@/components/atom/stat-card"

Copy// Use existing templates for layouts
import Sidebar01 from "@/components/template/sidebar-01"
import Header01 from "@/components/template/header-01"

Copy// Good
<h1>{dictionary.blocks.invoice.title}</h1>
 
// Bad
<h1>Invoice Generator</h1>

Copy// Good
className="ms-4 me-2 text-start"
 
// Bad
className="ml-4 mr-2 text-left"

Copy// Good
interface InvoiceItem {
  id: string
  description: string
  quantity: number
  price: number
}
 
// Bad
const items: any[] = []

Copy// src/components/root/block/invoice/actions.ts
"use server"
 
import { db } from "@/lib/db"
import { currentUser } from "@/lib/auth"
 
export async function createInvoice(data: InvoiceFormData) {
  const user = await currentUser()
  if (!user) throw new Error("Unauthorized")
 
  return db.invoice.create({ data: { ...data, userId: user.id } })
}

Copy{
  "blocks": [
    {
      "id": "table",
      "name": "Data Table",
      "source": "internal:tablecn",
      "route": "/blocks/table",
      "component": "src/components/tablecn",
      "category": "data",
      "status": "active",
      "auditScore": 85,
      "stack": { "auth": false, "prisma": true, "i18n": true }
    }
  ],
  "categories": { "data": { "icon": "Table", "count": 1 } },
  "preferences": { "defaultAuth": "authjs", "defaultDB": "prisma-neon" }
}