canonical_edge_style
ClaudeReturn the canonical edge.style block for a given connectionType. One of: default, async, sync, notification, rpc, stream, tcp.
Developer-Tools
Atsign AI Architect
by Atsign Inc
Overview
Atsign AI Architect helps developers quickly design, generate, and evolve secure applications for the Atsign Platform, including AI and agentic systems, connected products, distributed systems, and other secure connected environments. Teams use a visual blueprint to align on application components, identities, permissions, policies, data flows, and communication paths before coding begins. AI Architect turns that blueprint into structured instructions for an AI coding assistant. Teams can use it to create new applications or guide changes to existing code, embedding security into the application design and reducing costly retrofitting. The blueprint remains a shared, revisable architecture artifact that can guide future changes.
Tools
delete_edge
ClaudeDelete an edge from the blueprint. Use this to fix validation errors or remove unwanted connections. Streams deletion event to UI if sessionId provided.
delete_node
ClaudeDelete a node from the blueprint. Use this to fix validation errors or remove unwanted nodes. Streams deletion event to UI if sessionId provided.
export_for_implementation
ClaudeExport a validated blueprint with Atsign Platform implementation guide. Returns the same format as the web app's 'Export Prompt' button: blueprint structure + complete Atsign Platform SDK guide + node roles. Use this in IDEs (Cursor, Claude Code) to get everything needed for code generation in one call.
get_implementation_rules
ClaudeReturn Atsign Platform implementation rules for code generation. Only call after successful validation.
get_layout_constants
ClaudeGet recommended spacing constants for manual position calculation. Returns spacing values, node dimensions, and starting positions.
list_connection_types
ClaudeReturn the current allowed connection-type catalog as structured JSON.
list_node_types
ClaudeReturn the current allowed node-type catalog as structured JSON, together with the SCOPING PRINCIPLE that determines whether something should be a node at all. Read aiarchitect://rules/architecture-principles before calling this if you have not already.
pick_edge_handles
ClaudeReturn { sourceHandle, targetHandle } so edges leave from the side facing the other node. Always call for every edge.
push_blueprint
ClaudePush a complete, validated blueprint JSON to the user's browser so the canvas updates immediately. Use this after a successful validate_blueprint call to replace the canvas with the final blueprint. Requires an active stream session.
request_current_blueprint
ClaudeRequest access to the blueprint currently loaded in the user's browser. This will prompt the user for permission. If granted, returns the blueprint JSON with metadata (node count, edge count, last updated time). Use this when the user asks you to work with their existing blueprint (e.g., 'improve my blueprint', 'add nodes to my current design', 'analyze my blueprint'). Requires an active stream session — ask the user for their streamSessionId if you don't have it.
scaffold_blueprint
ClaudeReturn schema-valid empty blueprint with one page. Always use this instead of hand-writing top-level JSON.
scaffold_edge
ClaudeBuild complete edge JSON with canonical style and handles, generates unique id. Always use this instead of hand-writing. Canvas caption comes from data.notes (3-8 words) or falls back to connectionType label if notes is omitted.
scaffold_node
ClaudeBuild complete node JSON with all required dimension/style fields and generates a unique id. Always use this instead of hand-writing. Notes support markdown. IMPORTANT: Use suggest_grid_position, suggest_horizontal_position, or suggest_vertical_position to calculate positions for clean layouts with proper spacing.
suggest_grid_position
ClaudeCalculate well-spaced grid position for a node. Returns {x, y}. Use this for clean layouts - nodes will have proper spacing (450px horizontal, 350px vertical). Much better than manually calculating positions.
suggest_horizontal_position
ClaudeCalculate position for horizontal flow layout (left to right). Returns {x, y}. Nodes will be spaced 450px apart horizontally.
suggest_vertical_position
ClaudeCalculate position for vertical flow layout (top to bottom). Returns {x, y}. Nodes will be spaced 350px apart vertically.
update_edge_notes
ClaudeUpdate the caption/notes on an existing edge. Use this to improve edge labeling or fix missing notes. Streams update event to UI if sessionId provided.
update_node_label
ClaudeUpdate the label of an existing node. Use this to fix typos or improve clarity. Streams update event to UI if sessionId provided.
update_node_notes
ClaudeUpdate the notes/description of an existing node. Use this to add missing notes or improve documentation. Streams update event to UI if sessionId provided.
update_node_position
ClaudeUpdate the position of an existing node. Use this to adjust layout or fix cramped spacing. Streams update event to UI if sessionId provided.
validate_blueprint
ClaudeValidate blueprint JSON against schema. Returns { valid, errors, warnings }.
