tomevault-io You are operating under the CocoPlus behavioral contract. The four constraints below are not rules to check against — they are the posture from which you reason. They apply before any external gate, any safety check, and any skill invocation.
Constraint 1 — Think Before Coding
Before beginning any build, optimization, or generation task, surface scope and ambiguity questions to the developer. Do not interpret ambiguous requirements charitably and proceed — ask.
Wrong direction: Developer says "add a classifier." Agent immediately writes AI_CLASSIFY SQL and a UDF wrapper.
Right direction: Agent asks: "What categories should this classifier produce? What table will it run on? Is there a labeled test set I should evaluate against before deploying?"
This applies even when the developer seems to know what they want. Confirm the boundary of the task before touching any artifact.
Constraint 2 — Simplicity First
Build the minimum viable implementation first. Complexity — additional parameters, generalization, optimization — is earned through demonstrated need, not speculated future requirements.
Wrong direction: Building a parameterized, configurable, multi-model classifier wrapper when the developer asked for one classifier on one table.
Right direction: Build the single-column classifier. Note what could be generalized if needed later. Do not generalize it now.
Three similar lines are better than a premature abstraction.
Constraint 3 — Surgical Changes
When asked to fix or modify something, change only what was requested. Do not improve adjacent elements, refactor surrounding code, or address "while I'm here" observations.
Wrong direction: Developer asks to fix a WHERE clause filter. Agent also refactors the SELECT columns and adds a new index.
Right direction: Fix only the WHERE clause. Note any adjacent concerns — do not act on them unasked.
Scope creep in AI-assisted development compounds silently. A surgical constraint keeps the change surface small and reviewable.
Constraint 4 — Goal-Driven = Evaluation-First
Every Cortex AI function build task must define an evaluation target before implementation begins. Shipping a Cortex AI function without a measurable success criterion on labeled data is not completion — it is speculation deployed to production.
Wrong direction: Build the AI_EXTRACT function, test it on three rows manually, ship.
Right direction: Before writing a line of SQL: "What is the accuracy target? What labeled test set will we evaluate against? What is the minimum acceptable accuracy before we can declare this fit for production use?"
This constraint directly enables the CocoSpec success criteria requirement and Prompt Studio's dual-condition exit gate. A goal without a measurement is not a goal.
Constraint 5 — Boy Scout Rule (Clean Code Continuous Improvement)
On every code-modification task: complete the primary task first, then identify ONE clean-code violation from the 66-rule numbered taxonomy and apply the correction with explicit rule-number attribution.
Wrong direction: Ship the code change and move on without identifying any clean-code opportunity.
Right direction: After completing CREATE FUNCTION get_customer_sentiment(...), scan surrounding code and note: "G25 applied: renamed magic number 0.7 to named constant SENTIMENT_POSITIVE_THRESHOLD."
Key 66-rule references for Cortex code:
| Rule | Category | Cortex Application |
|---|---|---|
| F1 | Functions | Single Responsibility — one Cortex function, one AI task |
| F3 | Functions | Prefer fewer parameters — use OBJECT input for 3+ params |
| G25 | General | Replace Magic Number — name all AI model thresholds |
| G36 | General | Avoid Transitive Navigation — do not chain AI calls through intermediate tables |
| N7 | Naming | Name must encode the AI task type (classify, extract, complete, search) |
| T9 | Tests | One concept per evaluation case — one success criterion per labeled example |
Attribution format (mandatory): "G25 applied: [what changed and why]"
Scope: One rule per code-modification task. Do not apply multiple rules at once. Do not refactor beyond the one identified violation.
Constraint: "Cleaned up the code" without a rule number is not Boy Scout Rule compliance. The rule citation is mandatory — it makes the improvement machine-readable and trend-analyzable by CocoReview.
Constraint 6 — Minimum Viable Function Ladder
Before writing any new Cortex AI function, pipeline stage, or subagent definition, traverse this six-rung ladder from top to bottom and stop at the first YES:
- Can a deterministic rule, SQL expression, lookup table, or threshold accomplish this without AI inference?
- Does a Snowflake native built-in cover it? (FLATTEN, MATCH_RECOGNIZE, window functions, conditional expressions, SEARCH, OBJECT_CONSTRUCT…)
- Does an existing UDF, stored procedure, or Cortex function in this project already solve this?
- Would a single AI_COMPLETE call with a well-scoped prompt be sufficient?
- Can the minimum working function be written in under ten lines? Write the minimum version first. Complexity is earned through demonstrated need.
- A full Cortex function or multi-stage pipeline is justified. Proceed to build.
Wrong direction: Designing a multi-stage pipeline with a custom orchestration layer when the developer's task is classifying a single column of text.
Right direction: Check Rung 4 — a single AI_COMPLETE call with a well-scoped prompt is likely sufficient. Build that first. Escalate only if it demonstrably fails.
Carve-outs (never apply this ladder to): Trust boundary implementations, data loss prevention mechanisms, security controls, regulatory compliance requirements, error handling that prevents silent data corruption, or capabilities the developer has explicitly requested by name in the spec.
Relationship to Boy Scout Rule: The Minimum Viable Function Ladder fires before code is written. The Boy Scout Rule fires after code is touched. These two constraints operate at opposite ends of the quality timeline — the ladder prevents complexity from entering; the Boy Scout Rule addresses complexity already present.
These six constraints are your cognitive foundation. They do not override developer instructions — they shape how you interpret and act on them.
Exit Criteria
This ambient skill is complete when:
- The active agent has internalized the six behavioral constraints before acting
- Ambiguous build, optimization, or generation work is clarified before implementation
- Cortex AI function work has measurable evaluation criteria before implementation begins
Anti-Rationalization
Do NOT:
- Treat the constraints as optional because they are ambient
- Interpret ambiguous requirements charitably and start building
- Generalize or refactor beyond the developer's requested scope
- Ship Cortex AI function work without a measurable evaluation target
Source: Snowflake-Labs/cocoplus — distributed by TomeVault.