📚Methodology Digitization Handbook

A comprehensive guide to digitizing environmental methodologies on Guardian platform

Summary

The Methodology Digitization Handbook is a comprehensive guide for transforming environmental methodologies from PDF documents into fully functional, automated policies on the Guardian platform. Using VM0033 (Methodology for Tidal Wetland and Seagrass Restoration) as our primary reference example, this handbook provides step-by-step instructions, best practices, and real-world examples for every aspect of the digitization process.

Target Audiences

Primary Audiences

Verra and Other Standards Organizations

• Maintain and update existing digitized methodologies

• Ensure compliance with evolving regulatory requirements

• Optimize methodology performance and user experience

Methodology Developers and Carbon Market Professionals

• New to Guardian ecosystem seeking to digitize methodologies

• Environmental consultants expanding into digital MRV

• Carbon project developers wanting to understand the digitization process

Secondary Audiences

Technical Implementers

• Developers working on Guardian-based solutions

• System integrators connecting Guardian with external systems

• QA teams testing methodology implementations

Regulatory and Compliance Teams

• Understanding digital methodology validation and verification

• Ensuring audit trails and compliance requirements are met

• Managing methodology updates and version control

Key Features and Benefits

Complete Process Coverage: From initial PDF analysis to production deployment with VM0033 digitization example throughout.

Features	Description
Comprehensive Coverage	• Complete process from PDF analysis to deployment • Real examples from VM0033 implementation • Practical focus with actionable steps • Best practices from successful digitizations
Why VM0033?	• 135-page methodology that covers most challenges • Active use in blue carbon projects • Guardian policy being used by Verra in production • Built in collaboration with Verra & Allcot with real project data and testing
Streamlined Structure	• 27 focused chapters across 8 parts • 20-30 hours total reading time • Practical, hands-on approach throughout • Reduced complexity while maintaining comprehensive coverage

Handbook Structure and Flow

Total Time Investment: 20-30 hours for complete reading

Part I: Foundation (Chapters 1-3) - 20-30 minutes

Purpose: Establish understanding of methodology digitization and Guardian platform Outcome: Clear comprehension of the digitization process and platform capabilities

• Chapter 1: Introduction to Methodology Digitization

• Chapter 2: Understanding VM0033 Methodology

• Chapter 3: Guardian Platform Overview for Methodology Developers

Part II: Analysis and Planning (Chapters 4-7) - 30-40 minutes

Purpose: Systematic analysis of methodology documents and preparation for digitization Outcome: Complete understanding of methodology requirements and test artifacts

• Chapter 4: Methodology Analysis and Decomposition

• Chapter 5: Equation Mapping and Parameter Identification

• Chapter 6: Tools and Modules Integration

• Chapter 7: Test Artifact Development

Part III: Schema Design and Development (Chapters 8-12) - 3-4 hours

Purpose: Practical schema development and Guardian management features Outcome: Production-ready PDD and monitoring schemas with testing validation

• Chapter 8: Schema Architecture and Foundations

• Chapter 9: Project Design Document (PDD) Schema Development

• Chapter 10: Monitoring Report Schema Development

• Chapter 11: Advanced Schema Techniques (API management, Required types, UUIDs)

• Chapter 12: Schema Testing and Validation Checklist

Part IV: Policy Workflow Design and Implementation (Chapters 13-17) - 3-4 hours

Purpose: Transform Part III schemas into complete Guardian policies with automated workflows Outcome: Production-ready policies with stakeholder workflows and token minting

• Chapter 13: Policy Workflow Architecture and Design Principles

• Chapter 14: Guardian Workflow Blocks and Configuration

• Chapter 15: VM0033 Policy Implementation Deep Dive

• Chapter 16: Advanced Policy Patterns and Testing

• Chapter 17: Policy Deployment and Production Management

Part V: Calculation Logic Implementation (Chapters 18-21) - 2-3 hours

Purpose: Convert methodology equations into executable code and implement comprehensive testing Outcome: Production-ready calculation implementations with Guardian's testing framework

• Chapter 18: Custom Logic Block Development

• Chapter 19: Formula Linked Definitions (FLDs)

• Chapter 20: Guardian Tools Architecture and Implementation

• Chapter 21: Calculation Testing and Validation

Part VI: Integration and Testing (Chapters 22-23) - 1-2 hours

Purpose: End-to-end testing and API automation for production deployment Outcome: Production-ready methodology with testing coverage and API integration

• Chapter 22: End-to-End Policy Testing - Multi-role testing, workflow validation, Guardian dry-run capabilities

• Chapter 23: API Integration and Automation - Guardian APIs, automated workflows, virtual user management

Part VII: Deployment and Maintenance (Chapters 24-26) - 5-8 hours

Purpose: Deploy, monitor, and maintain methodology implementations Outcome: Operational methodology with ongoing support procedures

• Chapter 24: User Management and Role Assignment - User roles, permissions, organization management

• Chapter 25: Monitoring and Analytics - Guardian Indexer - Analytics, compliance reporting, audit trails

• Chapter 26: Maintenance and Updates - Version management, bug fixes, regulatory changes

Part VIII: Advanced Topics (Chapters 27-28) - 5-7 hours

Purpose: Advanced integration techniques and troubleshooting Outcome: Expert-level understanding and problem-solving capabilities

• Chapter 27: Integration with External Systems - Registry integration, monitoring systems, enterprise connectivity

• Chapter 28: Troubleshooting and Common Issues - Debugging techniques, issue resolution, performance optimization

Success Metrics

For Standards Organizations

• Reduced Maintenance Effort: 50-70% reduction in methodology update time

• Improved Compliance: Automated audit trails and validation

• Enhanced User Experience: Streamlined certification processes

• Better Data Quality: Automated validation and error prevention

For Methodology Developers

• Faster Time-to-Market: 60-80% reduction in digitization time

• Higher Quality: Comprehensive testing and validation procedures

• Reduced Risk: Proven patterns and best practices from VM0033 implementation

• Ongoing Support: Maintenance and update procedures

For Technical Teams

• Standardized Approach: Consistent methodology implementations

• Reusable Components: Shared libraries and patterns

• Quality Assurance: Comprehensive testing frameworks

• Performance Optimization: Scalable, efficient implementations

Prerequisites and Requirements

Knowledge Prerequisites

Required Knowledge

• Environmental Methodology Understanding: Familiarity with carbon markets and MRV concepts

• JSON and Basic Programming: Ability to read and modify JSON configurations

• Web Technologies: Basic understanding of web applications and APIs

Optional but Helpful

• JavaScript Experience: For advanced calculation logic implementation

• Carbon Market Experience: For understanding business context and requirements

Technical Requirements

Essential Setup

• Guardian Platform Access: MGS or local open source setup for hands-on practice

• VM0033 Methodology Document: Reference material for examples

• Development Tools: Text editor, browser, and API testing tools

Recommended Tools

• Postman or similar: For API testing and automation

• Git: For version control and collaboration

• Code Editor: VS Code or similar with JSON/JavaScript support

Getting Started

Quick Navigation

• 📋 Table of Contents - Complete handbook overview with reading time estimates

• 📝 Chapter Outlines - Detailed descriptions of all chapters and topics

• 🏗️ Part I: Foundation and Preparation - Start your learning journey here (Available Now)

• 🔍 Part II: Analysis and Planning - Systematic methodology analysis techniques (Available Now)

• 🏗️ Part III: Schema Design and Development - Schema development and testing (Available Now)

• ⚙️ Part IV: Policy Workflow Design and Implementation - Complete policy workflow development (Available Now)

• 🧮 Part V: Calculation Logic Implementation - CustomLogicBlock development, Guardian Tools, and testing (Available Now)

• 🔗 Part VI: Integration and Testing - End-to-end testing, API integration, and production deployment validation (Available Now)

• 🚀 Part VII: Deployment and Maintenance - User management, monitoring, and maintenance procedures (In Progress)

• ⚡ Part VIII: Advanced Topics and Best Practices - External integration and troubleshooting (In Progress)

Available Content

Parts I-VI are now available with all twenty-three chapters complete and ready for use, covering the complete foundation through production deployment and API integration.

Part	Status	Chapters	Description
Part I	✅ Available	Chapters 1-3	Foundation concepts, VM0033 overview, Guardian platform introduction
Part II	✅ Available	Chapters 4-7	Methodology analysis, equation mapping, tools integration, test artifacts
Part III	✅ Available	Chapters 8-12	Schema development, field management, testing checklist
Part IV	✅ Available	Chapters 13-17	Policy workflow design, VM0033 implementation, production deployment
Part V	✅ Available	Chapters 18-21	Calculation logic, customLogicBlock development, Guardian Tools, testing
Part VI	✅ Available	Chapters 22-23	End-to-end testing, API integration, automated workflows
Part VII	🚧 In Progress	Chapters 24-26	User management, monitoring, maintenance procedures
Part VIII	🚧 In Progress	Chapters 27-28	External integration, troubleshooting, advanced best practices

Shared Resources

• 🔧 Shared Resources - Templates, integration guides, and reference materials

• 📄 Templates - Standardized chapter and section templates

• 🔗 VM0033 Integration - VM0033-specific integration system

---

This handbook represents the collective knowledge and experience of the Guardian community, with special thanks to the Verra and Allcot team for their collaboration on the VM0033 implementation that serves as our primary example throughout this guide.