system-prompts-and-models-of-ai-tools/metadata/README.md

📊 Metadata Directory

This directory contains structured JSON metadata for all AI coding tools in the repository.

📋 Purpose

Metadata files provide:

• Structured data for programmatic access
• Consistent format across all tools
• Search and filtering capabilities
• API-friendly information
• Version tracking and history

🗂️ File Structure

Each tool has a corresponding JSON file:

metadata/
  ├── cursor.json
  ├── github-copilot.json
  ├── claude-code.json
  ├── windsurf.json
  └── ...

📄 Metadata Schema

{
  "name": "Tool Name",
  "slug": "tool-name",
  "type": "IDE Plugin | CLI Tool | Web Platform | Autonomous Agent",
  "status": "active | beta | deprecated",
  "description": "Brief description of the tool",
  "version": {
    "current": "1.0.0",
    "lastUpdated": "2025-01-02",
    "history": [
      {
        "version": "1.0.0",
        "date": "2025-01-02",
        "changes": "Initial release"
      }
    ]
  },
  "pricing": {
    "model": "free | freemium | paid | enterprise",
    "tiers": [
      {
        "name": "Free",
        "price": "$0/month",
        "features": ["Feature 1", "Feature 2"]
      }
    ]
  },
  "models": {
    "primary": "GPT-4 | Claude 3.5 Sonnet | etc.",
    "supported": ["Model 1", "Model 2"],
    "customizable": true
  },
  "features": {
    "codeGeneration": true,
    "codeCompletion": true,
    "chatInterface": true,
    "agentMode": false,
    "parallelExecution": false,
    "memorySystem": false,
    "todoTracking": false,
    "gitIntegration": true,
    "multiFileEditing": true,
    "testGeneration": false
  },
  "platforms": {
    "vscode": true,
    "jetbrains": false,
    "web": false,
    "cli": false,
    "standalone": false
  },
  "languages": {
    "supported": ["Python", "JavaScript", "TypeScript", "Java", "C++"],
    "optimized": ["Python", "JavaScript"]
  },
  "integrations": {
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "jira": false
  },
  "security": {
    "secretDetection": true,
    "privateMode": false,
    "localModel": false,
    "dataRetention": "30 days"
  },
  "patterns": {
    "conciseness": "high | medium | low",
    "parallelTools": true,
    "subAgents": false,
    "verificationGates": true,
    "todoSystem": false
  },
  "documentation": {
    "folder": "Cursor Prompts",
    "files": {
      "systemPrompt": "Agent Prompt.txt",
      "tools": "Agent Tools.json",
      "readme": "README.md"
    },
    "hasMultipleVersions": true,
    "versions": ["v1.0", "v1.2", "Agent"]
  },
  "links": {
    "website": "https://cursor.com",
    "docs": "https://docs.cursor.com",
    "github": "https://github.com/...",
    "pricing": "https://cursor.com/pricing"
  },
  "tags": [
    "IDE",
    "VS Code",
    "Agent",
    "Multi-file",
    "Premium"
  ],
  "metrics": {
    "promptTokens": 5000,
    "toolsCount": 15,
    "securityRules": 25,
    "concisenesScore": 85
  },
  "analysis": {
    "strengths": ["Feature 1", "Feature 2"],
    "weaknesses": ["Limitation 1"],
    "uniqueFeatures": ["Unique 1"],
    "bestFor": ["Use case 1", "Use case 2"]
  }
}

🔍 Usage Examples

Python

import json

# Load metadata
with open('metadata/cursor.json') as f:
    tool = json.load(f)

# Check features
if tool['features']['agentMode']:
    print(f"{tool['name']} has agent mode!")

# Filter by price
free_tools = [
    json.load(open(f'metadata/{f}'))
    for f in os.listdir('metadata')
    if json.load(open(f'metadata/{f}'))['pricing']['model'] == 'free'
]

JavaScript

const fs = require('fs');

// Load all metadata
const tools = fs.readdirSync('metadata')
  .filter(f => f.endsWith('.json'))
  .map(f => JSON.parse(fs.readFileSync(`metadata/${f}`)));

// Find IDE plugins
const idePlugins = tools.filter(t => t.type === 'IDE Plugin');

// Sort by pricing
const sorted = tools.sort((a, b) => 
  a.pricing.tiers[0].price.localeCompare(b.pricing.tiers[0].price)
);

PowerShell

# Load metadata
$cursor = Get-Content "metadata/cursor.json" | ConvertFrom-Json

# Check features
if ($cursor.features.agentMode) {
    Write-Host "$($cursor.name) has agent mode!"
}

# Get all tools
$tools = Get-ChildItem "metadata/*.json" | ForEach-Object {
    Get-Content $_.FullName | ConvertFrom-Json
}

# Filter by type
$idePlugins = $tools | Where-Object { $_.type -eq "IDE Plugin" }

📊 Generating Metadata

Manual Creation

Create JSON files following the schema above.

Automated Generation

Use the metadata generation script:

python scripts/generate-metadata.py --tool cursor

Bulk Update

Update all metadata files:

python scripts/generate-metadata.py --all

✅ Validation

Validate metadata against schema:

python scripts/validate-metadata.py

Checks:

• Required fields present
• Valid JSON format
• Correct data types
• Valid enum values
• Links are accessible
• Files exist in repository

🔄 Keeping Updated

When to Update Metadata:

• Tool releases new version
• Pricing changes
• New features added
• Prompts updated
• Integration added/removed

Update Process:

1. Edit JSON file
2. Update version.lastUpdated
3. Add entry to version.history
4. Run validation
5. Commit changes

📈 Statistics

Current metadata files: 31 (to be created)

Coverage by Type:

• IDE Plugins: 11 tools
• CLI Tools: 6 tools
• Web Platforms: 8 tools
• Autonomous Agents: 5 tools
• Other: 1 tool

🤝 Contributing

See CONTRIBUTING.md for guidelines on:

• Adding new metadata files
• Updating existing metadata
• Schema changes
• Validation requirements

📚 Resources

• JSON Schema
• Metadata Best Practices
• Tool Documentation

---

Last Updated: 2025-01-02