Context Module - AI-Optimized Site Documentation with TOON Format

[maximus]

Export your ProcessWire site structure as comprehensive, AI-optimized documentation for ChatGPT, Claude, Copilot, and other AI coding assistants.

What It Does

Context automatically generates complete documentation of your ProcessWire site in formats specifically optimized for working with AI:

📊 Site Structure

• Complete page hierarchy exported as JSON, TOON, and ASCII tree
• Shows all relationships, templates, URLs, and metadata
• Smart collapsing for large page lists

📋 Templates & Fields

• All template definitions with complete field configurations
• Field types, options, requirements, default values
• Special handling for Repeater, Matrix, Table fields

📦 Content Samples

• Real page examples exported for each template
• Shows actual data formats and field usage
• Helps AI understand your content patterns

💾 Code Snippets

• Customized selector patterns for your site type
• Helper functions and utility code
• API implementation examples

🤖 AI Prompts

• Ready-to-use project context file
• Template creation prompts
• Debugging assistance prompts

Dual Format Export (The Game Changer!)

Context exports in two formats simultaneously:

JSON Format

Standard format for development tools, APIs, and compatibility

TOON Format (AI-Optimized) ✨

Token-Oriented Object Notation designed specifically for AI prompts:

• 30-60% fewer tokens than JSON
• Significantly reduces API costs
• Same data, more compact representation
• No external dependencies - pure PHP

Real Savings Example

For a typical ProcessWire site with 50 templates:

structure.json  (15,000 tokens)  →  structure.toon  (8,500 tokens)  = 43% savings
templates.json  (8,000 tokens)   →  templates.toon  (4,000 tokens)  = 50% savings
samples/*.json  (12,000 tokens)  →  samples/*.toon  (6,500 tokens)  = 46% savings

Cost Impact (Claude Sonnet pricing):

• JSON export: $0.105 per AI interaction
• TOON export: $0.057 per AI interaction
• Save ~$5/month if you use AI assistants 100 times/month

Installation

cd /site/modules/
git clone https://github.com/mxmsmnv/Context.git

Then in admin: Modules → Refresh → Install

Or download from ProcessWire Modules Directory

Quick Start

1. Setup → Modules → Context → Configure
2. Choose your site type (Blog, E-commerce, Business, Catalog, Generic)
3. ✅ Enable "Export TOON Format" (recommended for AI work!)
4. Enable optional features:
   • ✅ Export Content Samples
   • ✅ Create Code Snippets
   • ✅ Create AI Prompts
5. Click "Export Context for AI"

Files appear in /site/assets/context/

Generated Files

/site/assets/context/
├── README.md                      # Complete documentation
├── structure.json / .toon         # Page hierarchy
├── structure.txt                  # ASCII tree
├── templates.json / .toon         # All templates & fields
├── config.json / .toon            # Site configuration
├── modules.json / .toon           # Installed modules
├── classes.json / .toon           # Custom Page classes
│
├── samples/                       # Real content examples
│   ├── product-samples.json
│   └── product-samples.toon       # 46% smaller!
│
├── snippets/                      # Code patterns
│   ├── selectors.php              # Customized for your site type
│   ├── helpers.php                # Utility functions
│   └── api-examples.php           # REST API examples
│
└── prompts/                       # AI instructions
    └── project-context.md         # Complete project overview

Using with AI Assistants

Upload TOON files to save tokens and costs:

📎 structure.toon
📎 templates.toon
📎 prompts/project-context.md

Then ask your AI assistant: "Help me create a blog post template with title, body, author, categories, and featured image. Follow the existing patterns from templates.toon"

The AI has complete context of your site and can generate code that follows your exact patterns!

Site Type Customization

Code snippets automatically adapt to your site type:

Blog / News / Magazine

• Post listings, author archives, category filtering
• Recent posts, popular content, related articles

E-commerce / Online Store

• Product listings, cart logic, order processing
• Inventory management, payment integration

Business / Portfolio / Agency

• Service pages, team members, case studies
• Testimonials, project galleries

Catalog / Directory / Listings

• Brand hierarchies, category filters
• Advanced search, sorting, pagination

Generic / Mixed Content

• General purpose patterns for any site type

Features Overview

Always Exported (Core)

• ✅ Complete page tree structure
• ✅ All templates with field definitions
• ✅ Site configuration and settings
• ✅ Installed modules list
• ✅ Custom Page classes
• ✅ README with complete documentation

Optional (Configurable)

• ⚙️ Content samples (1-10 per template)
• ⚙️ API JSON schemas
• ⚙️ URL routing structure
• ⚙️ Performance metrics
• ⚙️ Code snippets library
• ⚙️ AI prompt templates
• ⚙️ IDE integration files (.cursorrules, .claudecode.json)

Advanced Settings

• Auto-update on template/field changes
• Maximum tree depth (3-20 levels)
• JSON children limit (prevent huge files)
• Compact mode for large lists
• Custom AI instructions

Why TOON Format?

TOON is specifically designed for AI prompts. Here's the difference:

JSON (verbose):

{
  "products": [
    {"id": 1, "title": "Dark Chocolate", "price": 12.99},
    {"id": 2, "title": "Milk Chocolate", "price": 9.99}
  ]
}

TOON (compact):

products[2]{id,title,price}:
1,Dark Chocolate,12.99
2,Milk Chocolate,9.99

Same data, 50% fewer tokens!

Use Cases

• 🤖 AI-Assisted Development Upload your site context to Claude/ChatGPT and get code that follows your exact patterns
• 📚 Developer Onboarding New team members get complete site documentation instantly
• 🔄 Site Migration Export complete site structure for documentation or migration planning
• 📖 Code Standards Maintain consistency across your team with AI that knows your patterns
• 💰 Cost Optimization Reduce AI API costs by 30-60% with TOON format

Links

• GitHub: https://github.com/mxmsmnv/Context
• TOON Format Spec: https://toonformat.dev

Screenshots

Spoiler

Example Workflow

1. Export your site Click one button, get complete documentation in both JSON and TOON formats
2. Upload to AI Upload .toon files to Claude/ChatGPT for maximum efficiency
3. Build features faster AI knows your exact site structure, templates, and patterns
4. Save money Use 30-60% fewer tokens on every AI interaction

---

Perfect for ProcessWire developers who use AI coding assistants! The TOON format support makes it significantly more cost-effective to work with Claude, ChatGPT, and similar tools.

Questions? Suggestions? Let me know! 🚀