{ "manifest": { "name": "Land Kit AI Reference", "version": "2.3.1", "last_updated": "2026-11-04", "description": "Complete documentation for AI assistants building Land Kit Grasshopper scripts", "repository": "https://github.com/chrislandau/land-kit-docs", "docs_repo_path": "ai-reference/" }, "landing_page": "See README.md for complete overview and usage instructions", "quick_links": { "full_docs": "https://github.com/chrislandau/land-kit-docs/tree/main/ai-reference", "readme": "https://github.com/chrislandau/land-kit-docs/blob/main/README.md" }, "reference_files": [ { "id": "components", "name": "Component Registry", "filename": "component_registry.json", "description": "Complete catalog of 123 Land Kit components with inputs, outputs, and specifications", "size": "~150 KB", "update_frequency": "Weekly (auto-generated)", "use_cases": [ "Find what components exist", "Get component input/output details", "Determine component types and categories", "Build component lookup tables" ], "key_data": { "total_components": 123, "structure": "List of component objects with name, nickname, inputs, outputs, category" } }, { "id": "layers", "name": "Layer Validation Reference", "filename": "layer_validation.json", "description": "All 18 environment layers with valid values, data types, dependencies, and creation rules", "size": "~7 KB", "update_frequency": "Monthly (manual updates)", "use_cases": [ "Validate layer names", "Check allowed values for categorical layers (HSG, GC, Condition)", "Understand layer dependencies", "Find which component creates/requires each layer" ], "key_data": { "total_layers": 18, "categorical_layers": ["hsg", "gc", "condition"], "structure": "Dictionary of layer definitions with validation rules" } }, { "id": "workflows", "name": "Workflow Patterns", "filename": "workflow_patterns.json", "description": "5 proven workflow sequences for common tasks (Hydrology, CN Calculation, Solar, Drainage, Custom)", "size": "~8 KB", "update_frequency": "As new patterns are discovered", "use_cases": [ "Reference proven component sequences", "Understand workflow dependencies", "Learn what output layers each workflow creates", "See common patterns and best practices" ], "key_data": { "total_workflows": 5, "workflows": [ "basic_hydrology", "cn_calculation", "solar_analysis", "drainage_design", "custom_analysis" ], "structure": "List of workflow objects with step-by-step component sequences" } }, { "id": "errors", "name": "Error Reference & Troubleshooting", "filename": "error_reference.json", "description": "15+ documented error scenarios with causes, solutions, and troubleshooting guides", "size": "~10 KB", "update_frequency": "As new errors are encountered", "use_cases": [ "Understand common errors and why they occur", "Get step-by-step solutions", "Troubleshoot performance issues", "Debug data validation problems" ], "key_data": { "total_errors": 15, "error_categories": [ "Missing layers", "Invalid values", "Data mismatches", "Performance issues" ], "structure": "List of error objects with causes and solutions" } }, { "id": "integration", "name": "AI Integration Guide", "filename": "INTEGRATION_GUIDE.json", "description": "Detailed implementation guide for AI tools and developers integrating Land Kit", "size": "~15 KB", "update_frequency": "As integration patterns evolve", "use_cases": [ "Learn how to integrate with Raven or other GH AI tools", "Understand caching strategies", "Implement error handling for API calls", "See Python code examples for fetching documentation" ], "key_data": { "example_languages": ["Python"], "caching_strategy": "Download on startup, cache with version checking", "structure": "Detailed guide with code examples and best practices" } } ], "access_instructions": { "for_raven_users": [ "1. In your Raven prompt, reference these docs: 'See Land Kit AI reference at https://github.com/chrislandau/land-kit-docs/tree/main/ai-reference'", "2. Ask Raven to follow workflows from workflow_patterns.json", "3. Reference component nicknames from component_registry.json", "4. Ask Raven to validate data against layer_validation.json" ], "for_tool_developers": [ "1. Fetch this manifest file at startup", "2. For each reference file, construct GitHub raw URL: https://raw.githubusercontent.com/chrislandau/land-kit-docs/main/ai-reference/{filename}", "3. Implement caching with version checking (see INTEGRATION_GUIDE.json)", "4. Use data structures for validation and error handling" ] }, "github_raw_urls": { "manifest": "https://raw.githubusercontent.com/chrislandau/land-kit-docs/main/ai-reference/manifest.json", "component_registry": "https://raw.githubusercontent.com/chrislandau/land-kit-docs/main/ai-reference/component_registry.json", "layer_validation": "https://raw.githubusercontent.com/chrislandau/land-kit-docs/main/ai-reference/layer_validation.json", "workflow_patterns": "https://raw.githubusercontent.com/chrislandau/land-kit-docs/main/ai-reference/workflow_patterns.json", "error_reference": "https://raw.githubusercontent.com/chrislandau/land-kit-docs/main/ai-reference/error_reference.json", "integration_guide": "https://raw.githubusercontent.com/chrislandau/land-kit-docs/main/ai-reference/INTEGRATION_GUIDE.json" }, "usage_examples": [ { "example": "Python script fetching all docs", "code": [ "import urllib2, json", "", "manifest_url = 'https://raw.githubusercontent.com/chrislandau/land-kit-docs/main/ai-reference/manifest.json'", "manifest = json.load(urllib2.urlopen(manifest_url))", "", "# Now fetch all reference files using URLs from manifest", "for ref_file in manifest['reference_files']:", " url = manifest['github_raw_urls'][ref_file['id']]", " data = json.load(urllib2.urlopen(url))", " print(f\"Loaded {ref_file['name']}: {len(str(data))} bytes\")" ] }, { "example": "Raven prompt using this manifest", "prompt": "Generate a Land Kit Grasshopper script. Reference the manifest at https://github.com/chrislandau/land-kit-docs/tree/main/ai-reference. Follow the basic_hydrology workflow. Use +ShapeValues to add HSG and GC data. Then run Calculate CN Layer." }, { "example": "Validating data against reference", "pseudo_code": [ "Load layer_validation.json", "For each HSG value in user data:", " if value not in validation['HSG_values']['allowed']:", " flag error" ] } ], "version_control": { "current_version": "2.3.1", "last_updated": "2026-11-04", "update_strategy": "Check meta.version field in each file", "breaking_changes_in": "When version MAJOR increments", "backwards_compatibility": "Minor and Patch versions maintain compatibility" }, "support": { "issues": "https://github.com/chrislandau/land-kit-docs/issues", "discussions": "https://github.com/chrislandau/land-kit-docs/discussions", "documentation": "https://github.com/chrislandau/land-kit-docs/tree/main" }, "next_steps": [ "Start with README.md for complete overview", "Fetch component_registry.json to understand available components", "Load layer_validation.json for data validation rules", "Review workflow_patterns.json for proven sequences", "Consult error_reference.json when troubleshooting" ] }