snowflake-architecture-diagram-connected-cli

Connected-CLI mode

Calls the deployed SnowGram agent directly via the Cortex Agents API and renders the response in the bundled lightweight viewer. No Next.js frontend needed.

Prerequisites

• Active cortex connection (set via cortex connections set <name>)
• Agent SNOWGRAM_DB.AGENTS.SNOWGRAM_AGENT deployed and reachable from the active role
• Function grants verified during the parent skill's mode-detection probe

Path resolution (do this once)

This sub-skill uses $SKILL_DIR/... paths. Resolve them by sourcing the canonical helper. The absolute path to that helper is <SKILL_BASE_DIR>/assets/scripts/skill_paths.sh, where <SKILL_BASE_DIR> is the path the skill loader prints as Base directory for this skill: when this skill is loaded (or the path returned by cortex skill list for snowflake-architecture-diagram).

source "<SKILL_BASE_DIR>/assets/scripts/skill_paths.sh"
# Now: $SKILL_DIR, $TEMPLATES_DIR, $COMPOSER_DIR, $VIEWER_DIR, $SCRIPTS_DIR,
#      $STATE_FILE are all set. See the parent SKILL.md for the full table.

For Python helpers, import assets/scripts/skill_paths.py analogously. The parent SKILL.md shows the importlib pattern.

Workflow

Step 1: Invoke the agent

cortex agents run SNOWGRAM_DB.AGENTS.SNOWGRAM_AGENT "<user's prompt>"

Capture stdout. The agent typically returns:

1. A short overview paragraph
2. A Mermaid code block (delimited by ```mermaid / ```)
3. Optionally a JSON block with components / connections (also fenced)
4. Best-practice bullets and citations

Step 2: Extract Mermaid

Use a regex to extract the first fenced Mermaid block:

import re
m = re.search(r'```mermaid\s*\n(.*?)\n```', agent_output, re.DOTALL)
mermaid = m.group(1) if m else None

If Mermaid is present: continue to Step 3.

If Mermaid is missing (agent answered in prose only):

• The agent's tool description may not be enforcing Mermaid output (see snowgram-agent skill for the fix)
• Fall through to standalone mode using the agent's textual response as a hint:
  • Pass the agent's response to a freeform composer call: extract any component names mentioned, look them up in $SKILL_DIR/assets/component_synonyms.json, and feed BLOCK_IDs to composer.py
  • Tag the result source: "connected-cli:fallback-to-standalone"