Skip to content

forcedotcom/sf-skills / plugins/builder/agentforce-adlc/skills/agentforce-architecture-analyze

agentforce-architecture-analyze

Verified

Declared architecture snapshot for one Agentforce agent: planner, topics, actions, flows, Apex, prompt templates, and NGA plugins. Renders a human-readable architecture document and Mermaid invocation graph from design-time metadata (not runtime audit rows). TRIGGER when user asks to describe, diagram, inventory, audit, document, or diff (e.g. v3 vs v5) the architecture / action tree / topic structure / tool inventory of a specific agent by agent API name in a specific org. DO NOT TRIGGER for runtime session traces, conversation transcripts, generation timings, or gateway audit chains — this skill reads design-time metadata only (use agentforce-d360-analyze for session traces).

FileKindSize
README.mdmarkdown8.5 KB
SKILL.mdskill md17.5 KB
assets/cli/describe_sobject.yamlconfig317 B
assets/cli/describe_tooling_sobject.yamlconfig347 B
assets/cli/list_metadata_genaiprompttemplate.yamlconfig342 B
assets/cli/org_display.yamlconfig280 B
assets/cli/retrieve_genai_plugin.yamlconfig391 B
assets/cli/show_access_token.yamlconfig700 B
assets/mermaid/action_tree.mmdother986 B
assets/mermaid/data_flow.mmdother893 B
assets/mermaid/dependency_graph.mmdother810 B
assets/mermaid/invocation_sequence.mmdother1004 B
assets/mermaid/planner_state.mmdother813 B
assets/soql/apex_class_bodies_by_ids.soqlother103 B
assets/soql/apex_class_bodies_by_names.soqlother102 B
assets/soql/bot_definition_details.soqlother152 B
assets/soql/bot_version_lookup.soqlother186 B
assets/soql/flow_definition_by_ids.soqlother115 B
assets/soql/flow_definition_ids_by_names.soqlother146 B
assets/soql/flow_definition_view_by_durable_ids.soqlother180 B
assets/soql/flow_metadata_by_id.soqlother73 B
assets/soql/functions_by_plugins.soqlother317 B
assets/soql/planner_attrs_by_parent_ids.soqlother156 B
assets/soql/planner_bundle_functions.soqlother93 B
assets/soql/planner_definition_by_agent_chain.soqlother174 B
assets/soql/plugin_functions_by_plugin_ids.soqlother93 B
assets/soql/plugin_instructions_by_plugin_ids.soqlother168 B
assets/soql/plugins_by_planner.soqlother199 B
references/architecture_sections.mdmarkdown8.3 KB
references/contract.jsonconfig11.7 KB
references/soql_fields.mdmarkdown24.6 KB
scripts/_shared/__init__.pyscript82 B
scripts/_shared/fs_guard.pyexecutablescript12.8 KB
scripts/_shared/paths.pyscript3.9 KB
scripts/_shared/runtime.pyscript2.0 KB
scripts/_shared/sql.pyscript355 B
scripts/cache_check.pyexecutablescript8.9 KB
scripts/config.pyscript5.9 KB
scripts/emit_env.pyexecutablescript5.1 KB
scripts/emit_result.pyexecutablescript10.7 KB
scripts/fetch_soql.pyscript26.1 KB
scripts/finalize.pyexecutablescript11.8 KB
scripts/main.pyscript113.9 KB
scripts/metadata_listing.pyscript9.5 KB
scripts/parallel_retrieve.pyscript3.3 KB
scripts/parse_bundle.pyexecutablescript7.9 KB
scripts/parse_wave.pyexecutablescript36.1 KB
scripts/probe_channels.pyscript11.1 KB
scripts/render_architecture.pyscript40.0 KB
scripts/resolve_bot.pyexecutablescript9.4 KB
scripts/resolve_invocation_target.pyscript4.8 KB
scripts/rest_client.pyscript33.7 KB
scripts/retrieve_planner.pyscript464 B
scripts/sanitize.pyexecutablescript1013 B
scripts/sf_cli.pyscript12.3 KB
scripts/soql_loader.pyscript11.1 KB
scripts/summarize_tree.pyexecutablescript4.6 KB
scripts/tests/__init__.pyscript0 B
scripts/tests/_bootstrap.pyscript843 B
scripts/tests/fixtures/__init__.pyscript0 B
scripts/tests/fixtures/genai_payloads.pyscript12.5 KB
scripts/tests/test_cache_check.pyscript12.6 KB
scripts/tests/test_cache_check_main.pyscript10.4 KB
scripts/tests/test_config.pyscript3.8 KB
scripts/tests/test_end_to_end_fixture.pyscript26.2 KB
scripts/tests/test_finalize.pyscript11.2 KB
scripts/tests/test_flow_children_inflation.pyscript25.6 KB
scripts/tests/test_fs_guard.pyscript4.3 KB
scripts/tests/test_iterative_wave_b.pyscript19.0 KB
scripts/tests/test_main_pipeline.pyscript145.1 KB
scripts/tests/test_parallel_retrieve.pyscript4.8 KB
scripts/tests/test_parse_bundle.pyscript15.6 KB
scripts/tests/test_parse_wave.pyscript26.9 KB
scripts/tests/test_parse_wave_classifiers.pyscript8.6 KB
scripts/tests/test_parse_wave_helpers.pyscript14.3 KB
scripts/tests/test_parse_wave_main.pyscript16.4 KB
scripts/tests/test_per_branch_visited.pyscript9.5 KB
scripts/tests/test_probe_channels.pyscript13.3 KB
scripts/tests/test_probe_cli_recipes.pyscript8.2 KB
scripts/tests/test_render_architecture.pyscript32.7 KB
scripts/tests/test_resolve_bot.pyscript7.5 KB
scripts/tests/test_resolve_creds.pyscript12.0 KB
scripts/tests/test_resolve_invocation_target.pyscript5.2 KB
scripts/tests/test_rest_client.pyscript49.8 KB
scripts/tests/test_runtime_override.pyscript3.9 KB
scripts/tests/test_sf_cli.pyscript17.3 KB
scripts/tests/test_signature_stamping.pyscript18.0 KB
scripts/tests/test_skill_md_pipeline_block.pyscript12.7 KB
scripts/tests/test_soql_loader.pyscript21.3 KB
scripts/tests/test_summarize_tree.pyscript8.9 KB
scripts/tests/test_write_emit_ctx.pyscript19.2 KB
scripts/write_emit_ctx.pyexecutablescript14.1 KB

scripts/tests/test_runtime_override.py

View on GitHub
"""Tests for the --data-dir / --cache-dir override mechanism.

Three things must be true after ``--data-dir <path>`` is parsed:

1. ``paths.DATA_ROOT`` points at the override.
2. ``config.DATA_ROOT`` points at the override (re-export).
3. ``main.DATA_ROOT`` points at the override (the local ``from config import
   DATA_ROOT`` snapshot at module top).

If any of the three is stale, callers reading ``DATA_ROOT`` from that module
see the default path. ``main.py:2221`` writes ``str(DATA_ROOT)`` into the
``.emit_ctx.json`` file consumed by ``emit_result.py`` — getting that wrong
means the RESULT block points users at the wrong directory.
"""
from __future__ import annotations

from pathlib import Path

from . import _bootstrap  # noqa: F401 — sys.path setup

import config  # type: ignore
import main  # type: ignore
from _shared import paths, runtime  # type: ignore


def _reset_overrides() -> None:
    """Clear runtime overrides so the test starts from a known state."""
    runtime.set_data_root_override(None)
    runtime.set_cache_root_override(None)
    # Re-resolve all three namespace levels back to defaults.
    default_data = runtime.resolve_data_root("investigating-agentforce-architecture")
    default_cache = runtime.resolve_cache_root("investigating-agentforce-architecture")
    paths.DATA_ROOT = default_data
    paths.CACHE_ROOT = default_cache
    config.DATA_ROOT = default_data
    config.CACHE_ROOT = default_cache
    config.PROBE_CACHE_ROOT = default_cache / "_channel_probe"
    main.DATA_ROOT = default_data


def test_default_paths_under_vibe() -> None:
    """No overrides → all 3 namespaces point at ~/.vibe/."""
    _reset_overrides()
    expected_data = Path.home() / ".vibe" / "data" / "investigating-agentforce-architecture"
    expected_cache = Path.home() / ".vibe" / "cache" / "investigating-agentforce-architecture"
    assert paths.DATA_ROOT == expected_data
    assert config.DATA_ROOT == expected_data
    assert main.DATA_ROOT == expected_data
    assert paths.CACHE_ROOT == expected_cache
    assert config.CACHE_ROOT == expected_cache


def test_data_dir_override_rebinds_three_namespaces(tmp_path: Path) -> None:
    """--data-dir /tmp/x → all 3 namespaces (paths, config, main) update."""
    _reset_overrides()
    override = tmp_path / "custom-data"
    args = main.parse_args([
        "--org-alias", "myorg",
        "--agent", "MyAgent",
        "--work-dir", str(tmp_path / "work"),
        "--data-dir", str(override),
    ])
    main._apply_path_overrides(args)
    # All three namespace levels must equal the override path.
    assert paths.DATA_ROOT == override, "paths.DATA_ROOT not rebound"
    assert config.DATA_ROOT == override, "config.DATA_ROOT not rebound"
    assert main.DATA_ROOT == override, "main.DATA_ROOT not rebound"
    _reset_overrides()


def test_cache_dir_override_rebinds_paths_and_config(tmp_path: Path) -> None:
    """--cache-dir /tmp/y → paths.CACHE_ROOT, config.CACHE_ROOT, and PROBE_CACHE_ROOT update."""
    _reset_overrides()
    override = tmp_path / "custom-cache"
    args = main.parse_args([
        "--org-alias", "myorg",
        "--agent", "MyAgent",
        "--work-dir", str(tmp_path / "work"),
        "--cache-dir", str(override),
    ])
    main._apply_path_overrides(args)
    assert paths.CACHE_ROOT == override
    assert config.CACHE_ROOT == override
    assert config.PROBE_CACHE_ROOT == override / "_channel_probe"
    _reset_overrides()


def test_no_override_leaves_defaults_intact(tmp_path: Path) -> None:
    """Running with no override flags must not mutate anything."""
    _reset_overrides()
    expected_data = Path.home() / ".vibe" / "data" / "investigating-agentforce-architecture"
    args = main.parse_args([
        "--org-alias", "myorg",
        "--agent", "MyAgent",
        "--work-dir", str(tmp_path / "work"),
    ])
    main._apply_path_overrides(args)
    assert paths.DATA_ROOT == expected_data
    assert config.DATA_ROOT == expected_data
    assert main.DATA_ROOT == expected_data
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall