"instruction": "1. Read the user's request carefully. 2. Identify all required props and their types. 3. Define the TypeScript interface. 4. Add JSDoc comments. 5. Export the interface."

"steps": [
  {
    "id": "step-1",
    "inputs": ["user_request"],        // Always available
    "outputs": ["component_spec"]      // Produced by this step
  },
  {
    "id": "step-2",
    "inputs": ["component_spec"],      // Consumed from step-1
    "outputs": ["implementation"]
  }
]

{
  "name": "react-component-generator",
  "description": "Generates production-ready React functional components with TypeScript props interfaces, ARIA accessibility attributes, and comprehensive unit tests.",
  "license": "MIT",
  "metadata": {
    "author": "Acme Corp",
    "version": "1.0.0"
  },
  "triggers": [
    "create a React component",
    "build a React component",
    "generate a React component with TypeScript"
  ],
  "negativeTriggers": [
    "explain React concepts",
    "debug an existing React component"
  ],
  "steps": [
    {
      "id": "analyze-requirements",
      "title": "Analyze Component Requirements",
      "instruction": "1. Read the user's component request carefully. 2. Identify the component name, purpose, and visual behavior. 3. List all required props and their types. 4. Identify any state management needs. 5. Note accessibility requirements.",
      "inputs": ["user_request"],
      "outputs": ["component_spec"],
      "validationCriteria": "Component spec includes: name, props interface, state requirements, and accessibility notes."
    },
    {
      "id": "implement-component",
      "title": "Implement Component",
      "instruction": "1. Create the functional component using React.FC with the props interface. 2. Destructure props with default values. 3. Implement hooks for state and side effects. 4. Add all necessary ARIA attributes.",
      "inputs": ["component_spec"],
      "outputs": ["component_code"],
      "validationCriteria": "Component compiles without errors, uses proper hooks, has all ARIA attributes."
    },
    {
      "id": "write-tests",
      "title": "Write Unit Tests",
      "instruction": "1. Import React Testing Library and the component. 2. Write a test for default rendering. 3. Write tests for each prop variation. 4. Write tests for user interactions. 5. Verify all ARIA attributes.",
      "inputs": ["component_code"],
      "outputs": ["test_code"],
      "validationCriteria": "All branches covered. Tests verify rendering, interactions, and accessibility."
    }
  ],
  "language": "typescript",
  "maker": {
    "agentCount": 3,
    "kThreshold": 2,
    "maxOutputLength": 10000,
    "maxRetries": 3,
    "globalRedFlagRules": [
      {
        "id": "no_class_components",
        "name": "No Class Components",
        "description": "Must use functional components, not class components",
        "type": "regex",
        "pattern": "class\\s+\\w+\\s+extends\\s+(React\\.)?Component",
        "severity": "warning"
      }
    ]
  }
}

{
  "name": "api-docs-generator",
  "description": "Generates comprehensive API documentation from source code with function signatures, parameter tables, and code examples.",
  "triggers": ["generate API documentation", "document this API"],
  "negativeTriggers": ["write a README", "create a tutorial"],
  "steps": [
    {
      "id": "parse-source",
      "title": "Parse Source Code",
      "instruction": "1. Read all provided source files. 2. Extract every exported function, class, and type. 3. Capture: name, parameters with types, return type, docstrings.",
      "inputs": ["user_request"],
      "outputs": ["parsed_exports"],
      "validationCriteria": "Every public export is captured with full type information."
    },
    {
      "id": "generate-docs",
      "title": "Generate Documentation",
      "instruction": "1. Create a markdown file with title and overview. 2. For each function, generate: signature, description, parameter table, return type, and code example. 3. Add a table of contents.",
      "inputs": ["parsed_exports"],
      "outputs": ["documentation"],
      "validationCriteria": "Every export has a complete documentation section."
    }
  ],
  "language": "typescript",
  "maker": {
    "agentCount": 3,
    "kThreshold": 2,
    "maxOutputLength": 20000,
    "maxRetries": 3,
    "globalRedFlagRules": [
      {
        "id": "no_placeholder_docs",
        "name": "No Placeholder Documentation",
        "description": "Must not contain TBD or placeholder text",
        "type": "regex",
        "pattern": "(TBD|TODO|PLACEHOLDER|\\[description here\\])",
        "severity": "error"
      }
    ]
  }
}

{
  "name": "data-pipeline-builder",
  "description": "Creates data transformation pipelines: clean, validate, transform, and report.",
  "triggers": ["build a data pipeline", "process this dataset"],
  "negativeTriggers": ["visualize data", "create a chart"],
  "steps": [
    {
      "id": "ingest",
      "title": "Ingest Raw Data",
      "instruction": "1. Read the input file (CSV or JSON). 2. Parse into structured records. 3. Log total record count and column names.",
      "inputs": ["user_request"],
      "outputs": ["raw_records", "schema_info"],
      "validationCriteria": "All records parsed. Column names detected."
    },
    {
      "id": "transform",
      "title": "Transform Data",
      "instruction": "1. Apply user-requested transformations. 2. Calculate summary statistics for numeric columns.",
      "inputs": ["raw_records", "schema_info"],
      "outputs": ["transformed_data"],
      "validationCriteria": "All transformations applied. Statistics are correct."
    },
    {
      "id": "report",
      "title": "Generate Report",
      "instruction": "1. Create summary with total records processed. 2. Include statistics. 3. Sample of transformed output (first 10 records).",
      "inputs": ["transformed_data"],
      "outputs": ["pipeline_report"],
      "validationCriteria": "Report includes all statistics."
    }
  ],
  "language": "python",
  "maker": {
    "agentCount": 3,
    "kThreshold": 2,
    "maxOutputLength": 15000,
    "maxRetries": 5,
    "globalRedFlagRules": [
      {
        "id": "no_hardcoded_paths",
        "name": "No Hardcoded File Paths",
        "description": "Pipeline code must not contain hardcoded paths",
        "type": "regex",
        "pattern": "(/Users/|/home/|C:\\\\|D:\\\\)",
        "severity": "error"
      }
    ]
  }
}

{
  "name": "safe-sql-migration",
  "description": "Generates safe, reversible SQL migrations with rollback scripts.",
  "triggers": ["create a database migration", "add a column to the database"],
  "negativeTriggers": ["write a SQL query", "optimize a query"],
  "steps": [
    {
      "id": "generate-up",
      "title": "Generate Forward Migration",
      "instruction": "1. Write SQL using CREATE/ALTER. 2. Wrap in transaction. 3. Use snake_case. 4. Add IF NOT EXISTS guards.",
      "inputs": ["user_request"],
      "outputs": ["up_migration"],
      "validationCriteria": "SQL is valid. Uses transactions. Snake_case identifiers."
    },
    {
      "id": "generate-down",
      "title": "Generate Rollback",
      "instruction": "1. Write SQL to reverse the forward migration. 2. Create backup tables for destructive ops. 3. Wrap in transaction.",
      "inputs": ["up_migration"],
      "outputs": ["down_migration"],
      "validationCriteria": "Rollback exactly reverses the forward migration."
    }
  ],
  "maker": {
    "agentCount": 5,
    "kThreshold": 3,
    "maxOutputLength": 8000,
    "maxRetries": 3,
    "globalRedFlagRules": [
      {
        "id": "no_drop_without_backup",
        "name": "No DROP Without Backup",
        "type": "regex",
        "pattern": "DROP\\s+TABLE(?!.*CREATE\\s+TABLE.*backup)",
        "severity": "error"
      },
      {
        "id": "no_truncate",
        "name": "No TRUNCATE",
        "type": "regex",
        "pattern": "TRUNCATE\\s+TABLE",
        "severity": "error"
      }
    ]
  }
}

{
  "name": "security-audit",
  "description": "Reviews code for security vulnerabilities and produces a structured audit report.",
  "triggers": ["audit this code for security", "find vulnerabilities"],
  "negativeTriggers": ["implement authentication", "write a security policy"],
  "steps": [
    {
      "id": "scan-surface",
      "title": "Identify Attack Surface",
      "instruction": "1. Identify user input entry points. 2. Identify database queries. 3. Identify file system operations.",
      "inputs": ["user_request"],
      "outputs": ["attack_surface"],
      "validationCriteria": "All entry points identified."
    },
    {
      "id": "check-injection",
      "title": "Check Injection Vulnerabilities",
      "instruction": "1. Check for SQL injection. 2. Check for command injection. 3. Note file, line, and severity.",
      "inputs": ["attack_surface"],
      "outputs": ["injection_findings"],
      "validationCriteria": "Every query and exec call checked."
    },
    {
      "id": "check-xss",
      "title": "Check XSS and CSRF",
      "instruction": "1. Check for unescaped user input. 2. Check for CSRF token validation. 3. Check cookie flags.",
      "inputs": ["attack_surface"],
      "outputs": ["xss_findings"],
      "validationCriteria": "All rendering paths checked."
    },
    {
      "id": "generate-report",
      "title": "Generate Audit Report",
      "instruction": "1. Combine findings. 2. Sort by severity. 3. Add recommended fixes. 4. Add executive summary.",
      "inputs": ["injection_findings", "xss_findings"],
      "outputs": ["audit_report"],
      "validationCriteria": "All findings included. Sorted by severity."
    }
  ],
  "maker": {
    "agentCount": 3,
    "kThreshold": 2,
    "maxOutputLength": 15000,
    "maxRetries": 3,
    "globalRedFlagRules": [
      {
        "id": "no_blanket_approval",
        "name": "No Blanket Safe Approval",
        "description": "Must not claim 'no vulnerabilities found' without analysis",
        "type": "regex",
        "pattern": "(no (security )?issues found|code is secure|no vulnerabilities)",
        "severity": "warning"
      }
    ]
  }
}

{
  "id": "my_custom_rule",
  "name": "Human-Readable Name",
  "description": "What this rule catches and why",
  "type": "regex",
  "pattern": "your_regex_pattern_here",
  "severity": "warning"
}