PQL: Add specific instructions for connectors

[robertjdominguez]

Description

Enhanced the DocsQL system instructions with stricter validation protocols and better error prevention mechanisms.

Key Changes

• Mandatory validation triggers - Added hard stops before providing any technical content
• Connector validation protocol - Never assume connector names, always validate against docs
• Self-monitoring prompts - Built-in checks before each technical response
• Stricter enforcement - Made all validation protocols mandatory rather than optional

Previously...

The bot had loose validation requirements that only applied "when providing specific commands/examples":

<validation_protocols description="Only apply when providing specific commands/examples">
- CLI Validation: Required ONLY when providing actual CLI commands to users
- Metadata Validation: Required ONLY when providing actual YAML/JSON examples to users

Now...

Every technical reference requires validation with explicit stop mechanisms:

<mandatory_validation_triggers>
STOP IMMEDIATELY when about to mention ANY:
- CLI commands (ddn, hasura, etc.)
- Connector names (hasura/*, any hub connector)
- Configuration syntax (YAML, JSON, environment variables)

<validation_protocols description="MANDATORY for all technical content">
- CLI Validation: REQUIRED for ANY CLI commands, flags, or connector names
- Metadata Validation: REQUIRED for ANY YAML/JSON examples or configuration syntax
- NO EXCEPTIONS: Technical content requires validation regardless of confidence level

This prevents the bot from hallucinating technical details by forcing documentation validation at every step. The self-monitoring prompts create a mental checklist that catches potential violations before they happen, while the connector validation protocol specifically addresses the common issue of assuming connector names based on database types.

The changes also clarify that PromptQL is NOT GraphQL and should never reference GraphQL APIs or query syntax.

[github-actions]

🚀 PromptQL Build Complete

Build Version: f29195e75a
Project: pql-docs
PromptQL Playground: Open Playground

Description: PR #36: PQL: Add specific instructions for connectors

[github-actions]

✅ PromptQL Build Applied

Build Version: f29195e75a
Status: Successfully applied to production
Applied at: 2025-08-07T15:41:00.858Z