Skip to content

akiiwa-games/AgentCompass / skills/agent-compass

agent-compass

Flagged

Choose owner, model and effort, outbound authorization, advisor use, and continuation for delegated work. Reads local usage and effective account policy, profiles the task with the configured System-One scorer, then allocates a compatible worker. Use for independent worker or advisor work; ordinary local execution needs no routing.

FileKindSize
SKILL.mdskill md5.5 KB
agents/openai.yamlconfig427 B
calibration/README.mdmarkdown55.2 KB
calibration/arena_capture.pyscript14.0 KB
calibration/community.pyscript25.2 KB
calibration/five_axis.pyscript196.4 KB
calibration/measurements.pyscript68.4 KB
calibration/refresh.pyscript48.6 KB
calibration/series.pyscript10.2 KB
calibration/sources.pyscript24.1 KB
calibration/tiers.pyscript14.6 KB
grok-bot/.gitignoreother47 B
grok-bot/dependency_patch.pyscript4.5 KB
grok-bot/install_cli.pyscript3.6 KB
grok-bot/test-recovery.mjsscript8.6 KB
grok-bot/test_install_cli.pyscript4.1 KB
grok-bot/upstream.jsonconfig3.4 KB
references/accounts.jsonconfig155.9 KB
references/classifier-cases.jsonconfig21.5 KB
references/dispatch-lifecycle.mdmarkdown28.9 KB
references/dispatch-rules.mdmarkdown11.3 KB
references/effort-matching.mdmarkdown5.1 KB
references/fast-modes.mdmarkdown3.5 KB
references/five-axis-scores.jsonconfig3.1 MB
references/gemini-decisions-api.mdmarkdown2.9 KB
references/grok-bot.mdmarkdown13.0 KB
references/herdr.mdmarkdown5.1 KB
references/jev-api.mdmarkdown1.6 KB
references/level-3-conversion.jsonconfig2.4 KB
references/model-capabilities.jsonconfig3.6 KB
references/model-capabilities.mdmarkdown14.6 KB
references/parent-address-gate.mdmarkdown10.1 KB
references/plan-templates.jsonconfig13.2 KB
references/provider-discovery.mdmarkdown11.5 KB
references/provider-usage.mdmarkdown4.1 KB
references/public-data.jsonconfig816 B
references/public-measurements.jsonconfig1.3 MB
references/roll-reference.mdmarkdown26.7 KB
references/router-internals.mdmarkdown93.7 KB
references/task-classifier.mdmarkdown6.1 KB
references/user-scores.jsonconfig6.8 KB
references/work-kinds.mdmarkdown4.7 KB
references/worker-communication.mdmarkdown2.1 KB
scripts/account_fleet.pyscript32.9 KB
scripts/account_state.pyscript22.2 KB
scripts/accounts_override.pyscript14.8 KB
scripts/allocator.pyscript19.8 KB
scripts/antigravity_plan.pyscript18.7 KB
scripts/antigravity_telemetry.pyscript5.1 KB
scripts/auto_bundles.pyscript31.3 KB
scripts/axis_scores.pyscript40.3 KB
scripts/caller_input.pyscript3.0 KB
scripts/candidate_eval.pyscript54.0 KB
scripts/candidate_ranking.pyscript9.5 KB
scripts/capability_catalog.pyscript8.0 KB
scripts/check_router_contract.pyscript2.8 KB
scripts/conftest.pyscript2.5 KB
scripts/cwd_policy.pyscript1.5 KB
scripts/data_age.pyscript1.5 KB
scripts/decision_ledger.pyscript18.9 KB
scripts/demo_plan.pyscript6.3 KB
scripts/dispatch_fallback.pyscript40.3 KB
scripts/dispatch_flow.pyscript58.7 KB
scripts/dispatch_ground_truth.pyscript43.5 KB
scripts/dispatch_registry.pyscript113.7 KB
scripts/entry.pyscript1.7 KB
scripts/env_vars.pyscript580 B
scripts/fast_modes.pyscript2.5 KB
scripts/fixtures/grok-api-responses.jsonconfig907 B
scripts/fixtures/reference-accounts.jsonconfig26.9 KB
scripts/grok_bot_paths.pyscript1005 B
scripts/host_herdr.pyscript16.8 KB
scripts/host_placement.pyscript9.4 KB
scripts/host_policy.pyscript10.1 KB
scripts/launch_failures.pyscript5.9 KB
scripts/launch_values.pyscript12.3 KB
scripts/ledger_snapshot.pyscript11.1 KB
scripts/live_models.pyscript21.1 KB
scripts/model_latch.pyscript7.6 KB
scripts/model_resolution.pyscript18.0 KB
scripts/override_store.pyscript2.2 KB
scripts/plan_state_residue.pyscript5.0 KB
scripts/provider_inventory.pyscript128.2 KB
scripts/provider_retry.pyscript34.6 KB
scripts/public_data.pyscript59.2 KB
scripts/quota_economy.pyscript38.0 KB
scripts/quota_exhaustion.pyscript5.9 KB
scripts/quota_overrides.pyscript25.6 KB
scripts/quota_pools.pyscript29.8 KB
scripts/reference_provenance.pyscript32.3 KB
scripts/released_names.pyscript3.8 KB
scripts/roll.pyscript106.3 KB
scripts/route_judge.pyscript83.4 KB
scripts/route_simulation.pyscript26.3 KB
scripts/router_test_support.pyscript6.7 KB
scripts/run_grok_bot.pyscript18.8 KB
scripts/scorer_client.pyscript55.2 KB
scripts/stage_help.pyscript5.8 KB
scripts/state_upgrade.pyscript24.0 KB
scripts/subscription_cli.pyscript3.6 KB
scripts/task_intake.pyscript33.6 KB
scripts/test_account_identity.pyscript7.1 KB
scripts/test_account_state.pyscript63.3 KB
scripts/test_accounts_override.pyscript30.1 KB
scripts/test_allocator.pyscript94.2 KB
scripts/test_antigravity_plan.pyscript13.2 KB
scripts/test_applicable_quota.pyscript9.1 KB
scripts/test_auto_bundles.pyscript10.8 KB
scripts/test_billing_routing_policy.pyscript9.9 KB
scripts/test_cadence_count.pyscript32.2 KB
scripts/test_calibration_units.pyscript27.0 KB
scripts/test_capability_catalog.pyscript5.0 KB
scripts/test_decision_ledger.pyscript8.5 KB
scripts/test_demo_plan.pyscript3.4 KB
scripts/test_derived_state.pyscript21.6 KB
scripts/test_dispatch.pyscript322.3 KB
scripts/test_dispatch_answers.pyscript14.8 KB
scripts/test_dispatch_fallback.pyscript53.2 KB
scripts/test_entry.pyscript1.6 KB
scripts/test_fast_modes.pyscript9.9 KB
scripts/test_five_axis.pyscript290.1 KB
scripts/test_five_axis_economy.pyscript105.0 KB
scripts/test_fleet_parity.pyscript15.6 KB
scripts/test_grok_bot.pyscript47.7 KB
scripts/test_ground_truth_recording.pyscript68.8 KB
scripts/test_herdr.pyscript14.1 KB
scripts/test_host_policy.pyscript24.6 KB
scripts/test_launch_values.pyscript8.0 KB
scripts/test_metered_usd.pyscript60.4 KB
scripts/test_model_resolution.pyscript9.2 KB
scripts/test_named_route_facts.pyscript28.6 KB
scripts/test_native_hosts.pyscript6.0 KB
scripts/test_new_user_fleet.pyscript3.3 KB
scripts/test_no_hardcode_classification.pyscript75.1 KB
scripts/test_no_legacy_scoring.pyscript6.5 KB
scripts/test_override_store.pyscript2.3 KB
scripts/test_plan_says_why.pyscript44.9 KB
scripts/test_provider_inventory.pyscript83.2 KB
scripts/test_provider_names.pyscript126.0 KB
scripts/test_provider_pools.pyscript14.2 KB
scripts/test_public_data.pyscript93.5 KB
scripts/test_quota_exhaustion.pyscript5.6 KB
scripts/test_rate_limit_windows.pyscript6.3 KB
scripts/test_record_says_why.pyscript26.5 KB
scripts/test_reference_provenance.pyscript16.7 KB
scripts/test_refresh_entry.pyscript110.7 KB
scripts/test_released_names.pyscript4.1 KB
scripts/test_reset_priority.pyscript4.8 KB
scripts/test_roll_answers.pyscript44.7 KB
scripts/test_roll_notifications.pyscript10.4 KB
scripts/test_route_judge.pyscript99.8 KB
scripts/test_route_simulation.pyscript7.0 KB
scripts/test_routing_parity.pyscript32.3 KB
scripts/test_routing_review.pyscript25.1 KB
scripts/test_setup_discovery_parity.pyscript9.5 KB
scripts/test_stage_help.pyscript2.0 KB
scripts/test_state_upgrade.pyscript13.8 KB
scripts/test_turn_refusal.pyscript16.7 KB
scripts/test_usage_cache.pyscript4.9 KB
scripts/test_usage_collector.pyscript21.4 KB
scripts/test_usage_core_claude_accounts.pyscript1.8 KB
scripts/test_usage_core_grok_cli_billing.pyscript15.6 KB
scripts/test_usage_core_magpie.pyscript5.4 KB
scripts/test_usage_core_magpie_pool.pyscript10.8 KB
scripts/test_usage_core_safety.pyscript24.4 KB
scripts/test_user_scores.pyscript102.3 KB
scripts/test_venice_usage.pyscript1.3 KB
scripts/test_window_scope.pyscript5.5 KB
scripts/turn_refusal.pyscript10.7 KB
scripts/usage_cache.pyscript4.7 KB
scripts/usage_collector.pyscript7.4 KB
scripts/usage_core.pyscript142.0 KB
scripts/usage_magpie.pyscript10.6 KB
scripts/usage_reading.pyscript17.1 KB
scripts/user_scores.pyscript72.8 KB
scripts/venice_usage.pyscript2.6 KB
scripts/window_scope.pyscript3.2 KB
scripts/worker_context.pyscript8.9 KB
scripts/worker_sessions.pyscript10.9 KB

scripts/router_test_support.py

View on GitHub
"""Hermetic router fixtures shared by contract tests and their subprocesses."""
from contextlib import ExitStack
from datetime import timedelta
import os
from pathlib import Path
import tempfile
from unittest.mock import patch


def temporary_root(add_cleanup):
    directory = tempfile.TemporaryDirectory(prefix='router-tests-')
    add_cleanup(directory.cleanup)
    return Path(directory.name)


def isolated_router_state(add_cleanup, *, discovery=True, policy=True):
    """Install isolated defaults; individual tests may override any boundary."""
    import decision_ledger
    import env_vars
    import host_policy
    import provider_inventory

    stack = ExitStack()
    add_cleanup(stack.close)
    root = Path(stack.enter_context(tempfile.TemporaryDirectory(prefix='router-tests-')))
    # Inherited daemon/provider paths survive HOME changes unless removed explicitly.
    env = {key: value for key, value in os.environ.items()
           if not key.startswith(('ROUTER_', 'AGENTCOMPASS_', 'ROUTE_MANAGER_', 'PASEO_', 'DOT2API_'))
           and key not in ('CODEX_HOME', 'CLAUDE_CONFIG_DIR', 'JEV_API_KEY', 'TYPESAFE_API_KEY', 'GEMINI_API_KEY')}
    env.update(HOME=str(root), USERPROFILE=str(root), ROUTER_PROVIDER_HOME=str(root),
               ROUTER_STATE_DIR=str(root / '.agent-compass'), PASEO_HOME=str(root / '.paseo'),
               ROUTER_DISPATCH_DB=str(root / 'dispatch.sqlite3'),
               ROUTER_LEDGER=str(root / 'ledger.jsonl'), ROUTER_USAGE_CACHE=str(root / 'usage.json'),
               ROUTER_CAPACITY=str(root / 'capacity.json'), ROUTER_OVERRIDES=str(root / 'overrides.json'),
               AGENTCOMPASS_ACCOUNTS_OVERRIDE=str(root / 'accounts-override.json'),
               ROUTER_SCORER_CONFIG=str(root / 'scorer-config.json'),
               AGENTCOMPASS_PUBLIC_DATA='off', AGENTCOMPASS_ANTIGRAVITY_PLAN='off', AGENTCOMPASS_LIVE_MODELS='off')
    # Point tests at the fleet fixture so they do not depend on the current public data.
    import account_fleet
    env['ROUTER_ACCOUNTS_FILE'] = str(account_fleet.reference_fleet_path())
    stack.enter_context(patch.dict(os.environ, env, clear=True))
    stack.enter_context(patch.object(Path, 'home', return_value=root))
    # user_env otherwise falls back to the Windows registry, outside the fixture.
    stack.enter_context(patch.object(env_vars, 'user_env', side_effect=os.environ.get))
    stack.enter_context(patch.object(decision_ledger, 'LEDGER_WRITES', True))
    if discovery:
        stack.enter_context(patch.object(provider_inventory, 'current',
                                        return_value={'accounts': {}, 'launchers': {}}))
    if policy:
        stack.enter_context(patch.object(host_policy, 'load_policy', return_value=None))
    return root


def usage_windows(now, accounts):
    """Quota observations from account -> (window, remaining percent, reset hours)."""
    return {'read_ok': True, 'accounts': {name: {'windows': [
        {'id': wid, 'remaining_pct_before_reset': rem, 'observed_remaining_pct': rem,
         'seconds_until_reset': hours * 3600, 'resets_at': (now + timedelta(hours=hours)).isoformat()}
        for wid, rem, hours in rows]} for name, rows in accounts.items()}}


LEVEL_OF_DIFFICULTY = {'routine': 1, 'hard': 2, 'coupled': 3, 'frontier': 3}
READONLY_KINDS = frozenset({'code_audit', 'architecture_reasoning', 'exploration_forensics', 'web_research', 'creative_ideation'})


def profile(**changes):
    """A valid classifier profile for a bounded implementation task, with `changes` applied (`axis_demand` may be a
    partial dict). Tests that need a task the router can plan start from this."""
    import task_intake
    explicit_demand = changes.pop('axis_demand', None)
    work_kind = changes.get('work_kind', 'code_implementation')
    if 'work_kind' not in changes:
        if changes.get('needs_gui') is True:
            work_kind = 'gui_control'
        elif changes.get('read_only_review') is True:
            work_kind = 'code_audit'
        elif changes.get('access') == 'read-only' and changes.get('local_only') is True:
            work_kind = 'exploration_forensics'
    primary_level = changes.get('primary_level', 2)
    secondary_kind = changes.get('secondary_kind', 'none')
    secondary_level = changes.get('secondary_level', 0 if secondary_kind == 'none' else 1)
    needs_gui = bool(changes.get('needs_gui', 'gui_control' in (work_kind, secondary_kind)))
    needs_visual = bool(changes.get('needs_visual', needs_gui or 'visual_analysis' in (work_kind, secondary_kind)))
    read_only_review = bool(changes.get('read_only_review', work_kind == 'code_audit'))
    default_access = 'read-only' if (read_only_review or work_kind == 'code_audit') else 'write'
    task_count = changes.get('task_count', '2' if changes.get('multi_task') is True else '1')
    multi_task = bool(changes.get('multi_task', task_count != '1'))
    base = {
        'work_kind': work_kind,
        'primary_level': primary_level,
        'secondary_kind': secondary_kind,
        'secondary_level': secondary_level,
        'needs_visual': needs_visual,
        'needs_gui': needs_gui,
        'local_only': False,
        'wants_fast': False,
        'read_only_review': read_only_review,
        'access': default_access,
        'expected_hours': 1.0,
        'multi_task': multi_task,
        'task_count': task_count,
    }
    merged = {**base, **changes}
    projected = task_intake.project_axis_demand(
        merged['work_kind'], merged['primary_level'], merged['secondary_kind'], merged['secondary_level'],
    )
    merged['axis_demand'] = {**projected, **(explicit_demand or {})}
    return merged


def profile_for(task):
    """The profile a classifier would give a task a test wrote with only a few fields (work_kind, difficulty, needs,
    expected_hours): the fields the test names are kept, the rest is `profile()`."""
    import task_intake
    needs = task.get('needs') or {}
    raw_kind = task.get('work_kind')
    gui = bool(needs.get('gui') or task.get('needs_gui') or raw_kind == 'gui_control')
    visual = bool(needs.get('visual') or gui or task.get('needs_visual') or raw_kind == 'visual_analysis')
    kind = (
        raw_kind if raw_kind in task_intake.WORK_KINDS
        else 'gui_control' if gui
        else 'visual_analysis' if visual
        else 'code_implementation'
    )
    lvl = LEVEL_OF_DIFFICULTY.get(task.get('difficulty') or 'hard', 2)
    hours = task.get('expected_hours') or task.get('hours')
    local = bool(needs.get('local_only') or task.get('local_only'))
    access = 'read-only' if kind in READONLY_KINDS else 'write'
    return profile(
        work_kind=kind, primary_level=lvl, needs_visual=visual, needs_gui=gui,
        local_only=local, access=access,
        **({'expected_hours': float(hours)} if hours else {}),
    )
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall