forcedotcom/sf-skills / plugins/builder/agentforce-adlc/skills/agentforce-architecture-analyze
agentforce-architecture-analyze
VerifiedDeclared 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).
scripts/tests/test_config.py
View on GitHub"""Tests for config path builders validate every component."""
from __future__ import annotations
import unittest
from . import _bootstrap # noqa: F401
import config # type: ignore
from config import fs_guard # type: ignore — re-exported from _shared/
class BuildAgentDataDirTests(unittest.TestCase):
def test_valid_inputs_produce_expected_path(self):
p = config.build_agent_data_dir(
org_id_15="00Dxx0000000000",
agent_api_name="MyAgent",
agent_version="v5",
)
self.assertEqual(p.name, "MyAgent__v5")
self.assertEqual(p.parent.name, "00Dxx0000000000")
# Full path must be under DATA_ROOT.
self.assertTrue(str(p).startswith(str(config.DATA_ROOT)))
def test_dotdot_in_agent_api_name_raises(self):
with self.assertRaises(fs_guard.ValidationError):
config.build_agent_data_dir(
org_id_15="00Dxx0000000000",
agent_api_name="..",
agent_version="v5",
)
def test_slash_in_agent_api_name_raises(self):
with self.assertRaises(fs_guard.ValidationError):
config.build_agent_data_dir(
org_id_15="00Dxx0000000000",
agent_api_name="foo/bar",
agent_version="v5",
)
def test_slash_in_org_id_15_raises(self):
with self.assertRaises(fs_guard.ValidationError):
config.build_agent_data_dir(
org_id_15="00D/x0000000000",
agent_api_name="MyAgent",
agent_version="v5",
)
def test_dotdot_in_agent_version_raises(self):
with self.assertRaises(fs_guard.ValidationError):
config.build_agent_data_dir(
org_id_15="00Dxx0000000000",
agent_api_name="MyAgent",
agent_version="..",
)
class BuildAgentCacheDirTests(unittest.TestCase):
def test_valid_inputs_produce_expected_path(self):
p = config.build_agent_cache_dir(
org_id_15="00Dxx0000000000",
agent_api_name="MyAgent",
agent_version="v5",
)
self.assertEqual(p.name, "MyAgent__v5")
self.assertTrue(str(p).startswith(str(config.CACHE_ROOT)))
def test_slash_in_any_component_raises(self):
with self.assertRaises(fs_guard.ValidationError):
config.build_agent_cache_dir(
org_id_15="00Dxx0000000000",
agent_api_name="foo/bar",
agent_version="v5",
)
class BuildProbeCacheDirTests(unittest.TestCase):
def test_valid_api_version_ok(self):
p = config.build_probe_cache_dir(
org_id_15="00Dxx0000000000",
api_version="v60.0",
)
self.assertEqual(p.name, "v60.0")
self.assertTrue(str(p).startswith(str(config.PROBE_CACHE_ROOT)))
def test_v60_no_minor_raises(self):
with self.assertRaises(fs_guard.ValidationError):
config.build_probe_cache_dir(
org_id_15="00Dxx0000000000",
api_version="v60",
)
def test_api_version_with_slash_raises(self):
with self.assertRaises(fs_guard.ValidationError):
config.build_probe_cache_dir(
org_id_15="00Dxx0000000000",
api_version="v60.0/../",
)
def test_api_version_dotdot_raises(self):
with self.assertRaises(fs_guard.ValidationError):
config.build_probe_cache_dir(
org_id_15="00Dxx0000000000",
api_version="..",
)
def test_slash_in_org_id_raises(self):
with self.assertRaises(fs_guard.ValidationError):
config.build_probe_cache_dir(
org_id_15="00D/x0000000000",
api_version="v60.0",
)
if __name__ == "__main__":
unittest.main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |