Initial commit

2025-11-29 18:27:31 +08:00
commit b3b538c011
38 changed files with 5130 additions and 0 deletions
--- a/metadata.yaml
+++ b/metadata.yaml
@@ -0,0 +1,244 @@
+# BAML Code Generation Skill - Metadata
+# Version: 1.0.0
+# Last Updated: 2025-01-25
+
+skill:
+  name: "BAML Code Generation"
+  version: "1.0.0"
+  description: "Generate production-ready BAML applications from natural language requirements"
+  author: "Claude Code"
+  license: "MIT"
+
+activation:
+  triggers:
+    keywords:
+      - "BAML"
+      - "LLM"
+      - "structured output"
+      - "code generation"
+      - "extraction"
+      - "classification"
+      - "RAG"
+      - "agents"
+    patterns:
+      - "generate BAML"
+      - "create BAML function"
+      - "build BAML"
+      - "extract.*BAML"
+      - "classify.*BAML"
+
+  auto_activate: true
+  confidence_threshold: 0.7
+
+requirements:
+  mcp_servers:
+    required:
+      - name: "baml_Docs"
+        description: "Core BAML repository access"
+        repository: "BoundaryML/baml"
+        tools:
+          - "mcp__baml_Docs__fetch_baml_documentation"
+          - "mcp__baml_Docs__search_baml_documentation"
+          - "mcp__baml_Docs__search_baml_code"
+          - "mcp__baml_Docs__fetch_generic_url_content"
+
+    optional:
+      - name: "baml_Examples"
+        description: "Production pattern examples"
+        repository: "BoundaryML/baml-examples"
+        fallback: "Use cached patterns from baml_Docs"
+
+  dependencies:
+    - "MCP protocol support"
+    - "Claude Code runtime"
+
+capabilities:
+  patterns:
+    - extraction
+    - classification
+    - rag
+    - agents
+    - multimodal
+
+  languages:
+    - python
+    - typescript
+    - ruby
+    - java
+    - golang
+    - csharp
+
+  frameworks:
+    python:
+      - fastapi
+      - flask
+      - django
+    typescript:
+      - nextjs
+      - express
+      - nestjs
+    ruby:
+      - rails
+      - sinatra
+
+features:
+  code_generation:
+    types: true
+    functions: true
+    clients: true
+    tests: true
+    integration: true
+    deployment: true
+
+  optimization:
+    token_reduction: true
+    prompt_compression: true
+    type_simplification: true
+    caching: true
+    target_reduction: 0.55  # 55% reduction
+
+  validation:
+    syntax: true
+    types: true
+    semantics: true
+    completeness: true
+    performance: true
+
+  multimodal:
+    image: true
+    audio: true
+    vision_models: true
+
+performance:
+  targets:
+    simple_function_ms: 5000    # <5s
+    complex_system_ms: 30000    # <30s
+    compilation_success: 0.95   # >95%
+    test_pass_rate: 0.90        # >90%
+
+  caching:
+    session_ttl: 900            # 15 minutes
+    persistent_ttl: 604800      # 7 days
+    max_cache_size_mb: 100
+    eviction_policy: "LRU"
+
+  cost:
+    target_per_generation: 0.02  # <$0.02
+    token_budget: 4000           # Skill core
+
+cache:
+  structure:
+    patterns: "cache/patterns.json"
+    syntax: "cache/syntax.json"
+    query_cache: "cache/query_cache.json"
+
+  tiers:
+    - name: "embedded"
+      location: "SKILL.md"
+      size_tokens: 500
+      ttl: null  # never expires
+      content: "Core BAML syntax rules"
+
+    - name: "session"
+      location: "memory"
+      size_patterns: 10
+      ttl: 900  # 15 minutes
+      content: "Recent patterns"
+
+    - name: "persistent"
+      location: "cache/patterns.json"
+      size_patterns: 20
+      ttl: 604800  # 7 days
+      content: "Top patterns by usage"
+
+    - name: "mcp"
+      location: "remote"
+      size: "unlimited"
+      ttl: 0  # real-time
+      content: "Live repository"
+
+outputs:
+  artifacts:
+    - type: "baml_code"
+      format: ".baml"
+      description: "Generated BAML types and functions"
+
+    - type: "tests"
+      formats: [".py", ".ts", ".rb"]
+      description: "Test suites with 100% coverage"
+
+    - type: "integration"
+      formats: [".py", ".ts", ".rb", ".java", ".go", ".cs"]
+      description: "Framework-specific integration code"
+
+    - type: "deployment"
+      formats: ["Dockerfile", "docker-compose.yml", "k8s.yaml"]
+      description: "Deployment configurations"
+
+    - type: "metadata"
+      format: ".json"
+      description: "Generation metadata and metrics"
+
+quality:
+  validation_layers: 5
+  test_coverage_target: 1.0  # 100%
+  min_quality_score: 80
+
+  success_criteria:
+    first_compilation: 0.95
+    type_safety: 1.0
+    test_passage: 0.90
+    user_satisfaction: 0.85
+
+monitoring:
+  metrics:
+    - "generation_time_ms"
+    - "token_count"
+    - "optimization_savings"
+    - "pattern_match_accuracy"
+    - "cache_hit_rate"
+    - "mcp_query_latency"
+    - "validation_success_rate"
+    - "cost_per_generation"
+
+  alerts:
+    - condition: "generation_time_ms > 30000"
+      action: "log_slow_generation"
+
+    - condition: "cache_hit_rate < 0.5"
+      action: "review_cache_strategy"
+
+    - condition: "cost_per_generation > 0.02"
+      action: "investigate_token_usage"
+
+maintenance:
+  pattern_updates:
+    frequency: "real-time"
+    source: "MCP live queries"
+    manual_required: false
+
+  skill_updates:
+    token_budget_check: "on_deploy"
+    compression_review: "monthly"
+    validation_tuning: "quarterly"
+
+documentation:
+  readme: "SKILL.md"
+  quickstart: "../specs/001-baml-codegen-skill/quickstart.md"
+  troubleshooting: "TROUBLESHOOTING.md"
+  examples: "templates/"
+
+version_info:
+  current: "1.0.0"
+  status: "mvp"
+  release_date: "2025-01-25"
+  changelog:
+    - version: "1.0.0"
+      date: "2025-01-25"
+      changes:
+        - "Initial MVP release"
+        - "Core pattern matching (extraction, classification, rag, agents)"
+        - "MCP integration with baml_Docs server"
+        - "Multi-tier caching strategy"
+        - "Test and integration generation"
+        - "5-layer validation pipeline"