lerianstudio/ring:regulatory-templates-gate3

Regulatory Templates - Gate 3: Template File Generation

Overview

This sub-skill executes Gate 3 of the regulatory template workflow: generating the complete .tpl template file with all validated mappings and transformations from Gates 1-2.

Parent skill: regulatory-templates

Prerequisites:

• Gate 1 PASSED (field mappings complete)
• Gate 2 PASSED (validations confirmed)
• Context object with Gates 1-2 results

Output: Generated .tpl template file ready for use

---

Foundational Principle

Template generation is the final quality gate before production deployment.

Gate 3 transforms validated specifications into production artifacts:

• Agent-based generation: finops-automation applies validated mappings consistently - manual creation introduces human error
• Two-file separation: Clean .tpl (production code) + .tpl.docs (documentation) - inline comments bloat production artifacts
• All mandatory fields: 100% inclusion required - 95% = 5% of regulatory data missing in BACEN submission
• Correct transformations: Django filters applied per Gates 1-2 validation - errors here multiply in every submission
• Valid syntax: Template must execute without errors - syntax failures block Reporter deployment

Skipping requirements in Gate 3 means:

• Manual creation bypasses systematic validation (fatigue errors, missed transformations)
• Single-file output mixes production code with documentation (maintenance nightmare)
• Missing fields cause BACEN submission failures (compliance violations)
• Invalid syntax blocks deployment (emergency fixes under pressure)

Gate 3 is not automation for convenience - it's the final verification layer.

---

When to Use

Called by: regulatory-templates skill after Gate 2 passes

Purpose: Create the final Django/Jinja2 template file with all field mappings, transformations, and validation logic

---

NO EXCEPTIONS - Generation Requirements Are Mandatory

Gate 3 template generation requirements have ZERO exceptions. This is the final artifact that goes to production.

Common Pressures You Must Resist

| Pressure | Your Thought | Reality | |----------|--------------|---------| | Fatigue | "Manual creation is faster when tired" | Fatigue increases error rate. Agent doesn't get tired. 10 min manual < 15 min validated | | Simplicity | "One file easier than two" | Production artifacts must be clean. Documentation bloats .tpl files | | Confidence | "45/47 fields works for 99% cases" | 100% mandatory required. 95% = BACEN submission failures on edge cases | | Experience | "I can optimize agent output" | Agent applies validated mappings systematically. Manual edits introduce drift |

Generation Requirements (Non-Negotiable)

Agent-Based Generation:

• ✅ REQUIRED: Use finops-automation agent for all template generation
• ❌ FORBIDDEN: Manual .tpl creation, editing agent output
• Why: Agent applies Gates 1-2 validations consistently, prevents fatigue errors

Two-File Output:

• ✅ REQUIRED: Generate .tpl (clean code) + .tpl.docs (documentation)
• ❌ FORBIDDEN: Single file with inline comments, merged documentation
• Why: Production artifacts stay clean, documentation separate for maintenance

All Mandatory Fields:

• ✅ REQUIRED: 100% mandatory fields in template (47/47)
• ❌ FORBIDDEN: "45/47 is good enough", placeholder comments for missing
• Why: Each missing field = potential regulatory compliance failure

Validated Output:

• ✅ REQUIRED: Use exact agent output without manual "improvements"
• ❌ FORBIDDEN: Refactoring for optimization, rewriting for clarity
• Why: Agent output validated against Gates 1-2, edits create drift

The Bottom Line

Manual shortcuts in final artifact = production regulatory failures.

Gate 3 is the last checkpoint. All previous gates' work culminates here. Bypassing agent generation defeats the entire 3-gate validation process.

If you're tempted to skip agent generation, ask yourself: Am I willing to debug production BACEN submission failures from manual template errors?

---

Rationalization Table - Know the Excuses

| Excuse | Why It's Wrong | Correct Response | |--------|---------------|------------------| | "Manual creation same output, faster" | Agent validates systematically, manual risks errors | Use agent completely | | "10 min vs 15 min, I'm tired" | Fatigue increases manual error rate | Let agent work | | "Two files is over-engineering" | Production code must be clean, no doc bloat | Generate TWO files | | "One file easier to maintain" | Mixing code and docs creates maintenance burden | Separate concerns | | "45/47 works for 99% cases" | 100% mandatory required, edge cases matter | Include ALL fields | | "I can optimize agent output" | Optimization creates drift from validated spec | Use exact output | | "Agent code is verbose" | Verbose but validated > concise but wrong | Trust validation | | "Skip for now, add fields later" | Template is final artifact, can't patch BACEN | Complete now |

If You Find Yourself Making These Excuses

STOP. You are rationalizing.

Gate 3 is where 5+ hours of Gates 1-2 work becomes a production artifact. Shortcuts here waste all previous validation effort.

---

Gate 3 Process

Agent Dispatch

Dispatch: Task(subagent_type: "ring:finops-automation")

Prompt includes:

| Section | Content | |---------|---------| | Context | template_name, template_code, authority, field_mappings.length, validation_rules.length | | Field Mappings | Per field: code, name, source, transformation, confidence%, required | | Validation Rules | Per rule: rule_id, description, formula | | Tasks | 1. Generate clean .tpl 2. Include all mappings 3. Apply Django syntax 4. Structure per regulatory spec 5. Conditional logic 6. Minimal comments |

CRITICAL - Naming Convention:

• ALL fields in snake_case (already converted by Gate 1)
• Examples: legal_document, operation_route, opening_date, natural_person

CRITICAL - Data Sources:

• midaz_onboarding: organization, account (cadastral)
• midaz_transaction: operation_route, balance, operation (transactional)
• Format: {{ data_source.entity.index.field|filter }}
• Example: {{ midaz_onboarding.organization.0.legal_document|slice:':8' }}

---

Expected Output

| File | Content | |------|---------| | {code}_preview.tpl | Clean Django/Jinja2 template code, production-ready, minimal comments | | {code}_preview.tpl.docs | Full documentation: field mappings, transformations, troubleshooting |

---

Red Flags - STOP Immediately

If you catch yourself thinking ANY of these, STOP and re-read the NO EXCEPTIONS section:

Manual Shortcuts

• "Create .tpl manually, faster"
• "Edit agent output for optimization"
• "I can write cleaner code"
• "Agent is too verbose"

File Structure Violations

• "One file easier to maintain"
• "Inline comments instead of .docs"
• "Merge documentation into .tpl"
• "Two files is over-engineering"

Partial Completion

• "45/47 fields works for most cases"
• "Skip edge case fields"
• "Add missing fields later"
• "99% is good enough"

Justification Language

• "Being pragmatic"
• "I'm too tired for agent wait"
• "Manual is faster"
• "Over-engineering"
• "Optimization is better"

If You See These Red Flags

1. Acknowledge rationalization ("I'm trying to skip agent generation")
2. Read NO EXCEPTIONS (understand why agent is required)
3. Read Rationalization Table (see excuse refuted)
4. Use agent completely (no manual shortcuts)

Template generation shortcuts waste all Gates 1-2 validation work.

---

---

Severity Calibration

MUST classify template generation issues using these severity levels:

| Severity | Definition | Examples | Gate Impact | |----------|------------|----------|-------------| | CRITICAL | BLOCKS template deployment OR causes regulatory rejection | - Mandatory field missing from template<br>- Invalid Django/Jinja2 syntax<br>- Template file generation failed<br>- Output format violates regulatory spec | HARD BLOCK - Cannot deploy template | | HIGH | REQUIRES fix before production use | - Transformation applied incorrectly<br>- Optional but commonly-used field missing<br>- Filter chain produces wrong output<br>- Template structure doesn't match spec | MUST fix before deployment | | MEDIUM | SHOULD fix to improve template quality | - Template > 100 lines (could be simpler)<br>- Redundant transformations<br>- Missing comments in .tpl.docs<br>- Suboptimal loop structure | SHOULD fix - document if deferred | | LOW | Minor improvements possible | - Variable naming improvements<br>- Whitespace formatting<br>- Documentation enhancements | OPTIONAL - note in report |

Classification Rules:

CRITICAL = ANY of:

• Any mandatory field NOT in generated template
• Template syntax error (cannot execute)
• Output format violates BACEN/RFB specification
• Agent generation completely failed

HIGH = ANY of:

• Transformation differs from Gates 1-2 specification
• Filter produces wrong output type/format
• Field ordering wrong per regulatory spec
• Missing validation logic defined in Gate 2

---

Cannot Be Overridden

NON-NEGOTIABLE requirements (no exceptions, no user override):

| Requirement | Why NON-NEGOTIABLE | Verification | |-------------|-------------------|--------------| | Agent-Based Generation | Manual creation bypasses Gates 1-2 validation | template.generated_by == "finops-automation" | | Two-File Output | Production code must be clean, docs separate | Both .tpl and .tpl.docs exist | | 100% Mandatory Fields | BACEN/RFB submission requires ALL mandatory data | template.fields_included == spec.mandatory_count | | Valid Syntax | Template must execute without errors | Template passes syntax validation | | Exact Transformations | Gates 1-2 validated each transformation | All transformations match specification |

User CANNOT:

• Skip agent generation ("manual is faster" = NO)
• Merge docs into single file ("one file easier" = NO)
• Accept 95% mandatory fields ("45/47 is good enough" = NO)
• Edit agent output ("I can optimize" = NO)
• Deploy template with syntax errors ("fix in production" = NO)

Your Response to Override Attempts:

"I CANNOT [request]. Gate 3 requires [specific requirement] which is NON-NEGOTIABLE. Template generation through finops-automation agent ensures Gates 1-2 validations are applied consistently. We MUST [required action]."

---

Pass/Fail Criteria

PASS Criteria

• ✅ Template file generated successfully
• ✅ All mandatory fields included
• ✅ Transformations correctly applied
• ✅ Django/Jinja2 syntax valid
• ✅ Output format matches specification
• ✅ File saved with correct extension

FAIL Criteria

• ❌ Missing mandatory fields
• ❌ Invalid template syntax
• ❌ Transformation errors
• ❌ File generation failed

---

State Tracking

PASS: SKILL: regulatory-templates-gate3 | GATE: 3 | STATUS: PASSED ✅ | FILE: {filename} | FIELDS: {n}/{total} | NEXT: Template ready for use

FAIL: SKILL: regulatory-templates-gate3 | GATE: 3 | STATUS: FAILED ❌ | ERROR: {error} | BLOCKERS: {description}

---

Output to Parent Skill

Return: gate3_passed, template_file (filename, path, size_bytes, fields_included), ready_for_use, next_action (template_complete | fix_and_regenerate)

---

Common Template Patterns

| Pattern | Syntax | |---------|--------| | Field access | {{ organization.legal_document }} (snake_case) | | Collection loop | {% for item in collection %}{{ item.field }}{% endfor %} | | Conditional | {% if condition %}<field>{{ value }}</field>{% endif %} | | Nested | {{ parent.child.grandchild }} | | Filter chain | {{ value\|slice:':8'\|upper }} |

Remember: Use exact Gate 1 paths, snake_case only, apply Gate 2 transformations, follow regulatory format exactly.