AgentSkillsCN

mecw-patterns

通过上下文管理,运用MECW理论与模式预防幻觉。该方法遵循50%法则。 MECW、上下文窗口、幻觉、50%法则、上下文压力 适用场景:当需要构建上下文感知系统,或监测上下文压力时使用。

SKILL.md
--- frontmatter
name: mecw-patterns
description: |
  MECW theory and patterns for hallucination prevention via context management. Implements 50% rule.

  MECW, context window, hallucination, 50% rule, context pressure
  Use when: implementing context-aware systems or monitoring context pressure
category: infrastructure
tags: [context-management, mecw, hallucination-prevention, token-optimization, thresholds]
dependencies: []
tools: [mecw-monitor, context-tracker]
provides:
  infrastructure: [context-monitoring, mecw-compliance, pressure-calculation]
  patterns: [context-optimization, safe-budgeting, hallucination-prevention]
usage_patterns:
  - context-window-management
  - hallucination-prevention
  - token-budget-planning
  - pressure-monitoring
complexity: intermediate
estimated_tokens: 350
progressive_loading: true
modules:
  - modules/mecw-theory.md
  - modules/monitoring-patterns.md
  - modules/prevention-strategies.md
reusable_by: [conserve, abstract, conjure, spec-kit, sanctum, imbue]
version: 1.4.0

Table of Contents

MECW Patterns

Overview

Maximum Effective Context Window (MECW) patterns provide the theoretical foundations and practical utilities for managing context window usage to prevent hallucinations. The core principle: Never use more than 50% of total context window for input content.

When To Use

  • Need to prevent hallucinations in long-running sessions
  • Managing context-heavy workflows
  • Building systems that process large amounts of data
  • Want proactive context pressure monitoring
  • Require safe token budget calculation

When NOT To Use

  • Project doesn't use the leyline infrastructure patterns
  • Simple scripts without service architecture needs

Core Principle: The 50% Rule

Context pressure increases non-linearly as usage approaches limits. Exceeding 50% of context window significantly increases hallucination risk.

Pressure Levels

LevelUsageEffectAction
LOW<30%Optimal performance, high accuracyContinue normally
MODERATE30-50%Good performance, within MECWMonitor closely
HIGH50-70%Degraded performance, risk zoneOptimize immediately
CRITICAL>70%Severe degradation, high hallucinationReset context

Quick Start

Basic Pressure Check

python
from leyline import calculate_context_pressure

pressure = calculate_context_pressure(
    current_tokens=80000,
    max_tokens=200000
)
print(pressure)  # "MODERATE"

Verification: Run the command with --help flag to verify availability.

Full Compliance Check

python
from leyline import check_mecw_compliance

result = check_mecw_compliance(
    current_tokens=120000,
    max_tokens=200000
)

if not result['compliant']:
    print(f"Overage: {result['overage']:,} tokens")
    print(f"Action: {result['action']}")

Verification: Run the command with --help flag to verify availability.

Continuous Monitoring

python
from leyline import MECWMonitor

monitor = MECWMonitor(max_context=200000)

# Track usage throughout session
monitor.track_usage(80000)
status = monitor.get_status()

if status.warnings:
    for warning in status.warnings:
        print(f"[WARN] {warning}")

if status.recommendations:
    print("\nRecommended actions:")
    for rec in status.recommendations:
        print(f"  • {rec}")

Verification: Run the command with --help flag to verify availability.

Detailed Topics

For detailed implementation patterns:

Best Practices

  1. Plan for 40%: Design workflows to use ~40% of context, leaving buffer
  2. Buffer for Response: Leave 50% for model reasoning + response generation
  3. Monitor Continuously: Check context at each major step
  4. Fail Fast: Abort and restructure when approaching limits
  5. Document Aggressively: Keep summaries for context recovery after reset

Integration with Other Skills

This skill provides foundational utilities referenced by:

  • conserve:context-optimization - Uses MECW for optimization decisions
  • conjure:delegation-core - Uses MECW for delegation triggers
  • Plugin authors building context-aware systems

Reference in your skill's frontmatter:

yaml
dependencies: [leyline:mecw-patterns]

Verification: Run the command with --help flag to verify availability.

Exit Criteria

  • Context pressure monitored before major operations
  • MECW compliance checked when loading large content
  • Safe budget calculated before batch operations
  • Recommendations followed when warnings issued
  • Context reset triggered before CRITICAL threshold

Troubleshooting

Common Issues

Command not found Ensure all dependencies are installed and in PATH

Permission errors Check file permissions and run with appropriate privileges

Unexpected behavior Enable verbose logging with --verbose flag