{ "edges": [ { "to": "18443356-0962-445c-9f53-daf3e95505ed", "from": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "toPort": "0", "fromPort": "0" }, { "to": "0da401d5-5bd5-4d5c-8bd4-56c0231278e6", "from": "f6117e39-bbea-4b8b-af81-9d11dea411d6", "toPort": "0", "fromPort": "0" }, { "to": "84d7cac3-bcb0-4c99-9778-8382f43a4699", "from": "fcdd844d-d327-45b1-b319-6b2fb78da8b6", "toPort": "0", "fromPort": "0" }, { "to": "8e995431-419c-4d45-b349-368f72ec21c7", "from": "f9b37d10-b08d-4689-9332-c3cdc1e0d2a0", "toPort": "0", "fromPort": "0" }, { "to": "b2f94c0e-b70b-4a2a-8cea-2a9863d78ce0", "from": "ce51847f-7c5f-494f-975b-e8ea545cd50c", "toPort": "0", "fromPort": "ai_languageModel" }, { "to": "b2f94c0e-b70b-4a2a-8cea-2a9863d78ce0", "from": "076af1fe-6bfe-49ab-8500-cd1b2f3db975", "toPort": "0", "fromPort": "0" }, { "to": "e5558bb5-6670-4824-864c-696360085f67", "from": "f006ed96-6ef9-4bc8-96bb-0fac76993db0", "toPort": "0", "fromPort": "0" }, { "to": "9ed95dfa-5a0d-4f76-ab11-e8a25f3fb18b", "from": "84d7cac3-bcb0-4c99-9778-8382f43a4699", "toPort": "0", "fromPort": "0" }, { "to": "0da401d5-5bd5-4d5c-8bd4-56c0231278e6", "from": "c239fbe4-e34f-445f-9292-141699a76a9a", "toPort": "0", "fromPort": "0" }, { "to": "fcdd844d-d327-45b1-b319-6b2fb78da8b6", "from": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "toPort": "0", "fromPort": "0" }, { "to": "f9b37d10-b08d-4689-9332-c3cdc1e0d2a0", "from": "e5558bb5-6670-4824-864c-696360085f67", "toPort": "0", "fromPort": "0" }, { "to": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "from": "b2f94c0e-b70b-4a2a-8cea-2a9863d78ce0", "toPort": "0", "fromPort": "0" }, { "to": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "from": "0da401d5-5bd5-4d5c-8bd4-56c0231278e6", "toPort": "0", "fromPort": "0" }, { "to": "f006ed96-6ef9-4bc8-96bb-0fac76993db0", "from": "5301aa8f-fce4-42e8-8334-3339e873dfc3", "toPort": "0", "fromPort": "0" }, { "to": "076af1fe-6bfe-49ab-8500-cd1b2f3db975", "from": "9ed95dfa-5a0d-4f76-ab11-e8a25f3fb18b", "toPort": "0", "fromPort": "0" }, { "to": "5301aa8f-fce4-42e8-8334-3339e873dfc3", "from": "18443356-0962-445c-9f53-daf3e95505ed", "toPort": "0", "fromPort": "0" } ], "nodes": [ { "id": "c239fbe4-e34f-445f-9292-141699a76a9a", "name": "Receive GitHub URL", "type": "trigger", "params": { "kind": "n8n-nodes-base.webhook", "path": "repo-blueprint", "options": { "ignoreBots": false }, "httpMethod": "POST", "responseMode": "responseNode" }, "position": [ -2704, 208 ] }, { "id": "f6117e39-bbea-4b8b-af81-9d11dea411d6", "name": "Blueprint Form", "type": "trigger", "params": { "kind": "n8n-nodes-base.formTrigger", "path": "repo-blueprint-form", "options": { "buttonLabel": "Generate Blueprint" }, "formTitle": "Repo Blueprint Architect", "formFields": { "values": [ { "fieldLabel": "GitHub Repository URL", "placeholder": "https://github.com/owner/repo", "requiredField": true } ] }, "responseMode": "responseNode", "formDescription": "Enter a public GitHub repository URL to generate an evidence-based system architecture blueprint with Mermaid.js diagrams." }, "position": [ -2704, 512 ] }, { "id": "0da401d5-5bd5-4d5c-8bd4-56c0231278e6", "name": "Parse Owner and Repo", "type": "code", "params": { "jsCode": "const input = $input.first().json;\nconst url = input.body?.github_url || input.body?.repository_url || input['GitHub Repository URL'];\n\nif (!url) {\n throw new Error('Missing GitHub URL. Send body.github_url or body.repository_url (webhook) or fill the form field.');\n}\n\nconst match = url.match(/github\\.com\\/([^\\/]+)\\/([^\\/\\.]+)/);\n\nif (!match) {\n throw new Error(`Invalid GitHub URL: ${url}`);\n}\n\nreturn [{\n json: {\n github_url: url,\n owner: match[1],\n repo: match[2]\n }\n}];" }, "position": [ -2432, 208 ] }, { "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name": "Fetch Repo Metadata", "type": "http", "params": { "url": "=https://api.github.com/repos/{{ $json.owner }}/{{ $json.repo }}", "options": { "response": { "response": { "neverError": true } } }, "sendHeaders": true, "authentication": "predefinedCredentialType", "headerParameters": { "parameters": [ { "name": "Accept", "value": "application/vnd.github.v3+json" }, { "name": "User-Agent", "value": "n8n-repo-blueprint" } ] }, "nodeCredentialType": "githubApi" }, "position": [ -2160, 208 ] }, { "id": "fcdd844d-d327-45b1-b319-6b2fb78da8b6", "name": "Fetch Repo Tree", "type": "http", "params": { "url": "=https://api.github.com/repos/{{ $('Parse Owner and Repo').first().json.owner }}/{{ $('Parse Owner and Repo').first().json.repo }}/git/trees/{{ $json.default_branch || 'main' }}?recursive=1", "options": {}, "sendHeaders": true, "authentication": "predefinedCredentialType", "headerParameters": { "parameters": [ { "name": "Accept", "value": "application/vnd.github.v3+json" }, { "name": "User-Agent", "value": "n8n-repo-blueprint" } ] }, "nodeCredentialType": "githubApi" }, "position": [ -1888, 208 ] }, { "id": "84d7cac3-bcb0-4c99-9778-8382f43a4699", "name": "Identify Key Files", "type": "code", "params": { "jsCode": "const treeData = $input.first().json;\nconst tree = treeData.tree || [];\nconst owner = $('Parse Owner and Repo').first().json.owner;\nconst repo = $('Parse Owner and Repo').first().json.repo;\n\nconst filteredTree = tree.filter(item => {\n const p = item.path.toLowerCase();\n return !p.includes('node_modules') &&\n !p.includes('.git/') &&\n !p.includes('package-lock.json') &&\n !p.includes('yarn.lock') &&\n !p.includes('dist/') &&\n !p.includes('build/') &&\n !p.includes('__pycache__') &&\n !p.includes('.egg-info');\n});\n\nlet fileTreeStr = filteredTree\n .filter(item => item.type === 'blob')\n .map(item => item.path)\n .join('\\n');\nif (fileTreeStr.length > 40000) {\n fileTreeStr = fileTreeStr.substring(0, 40000) + '\\n... [TREE TRUNCATED]';\n}\n\nconst keyPatterns = [\n /^main\\.py$/i,\n /^app\\.py$/i,\n /^index\\.(js|ts|tsx)$/i,\n /^server\\.(js|ts)$/i,\n /^package\\.json$/i,\n /^requirements\\.txt$/i,\n /^pyproject\\.toml$/i,\n /^Cargo\\.toml$/i,\n /^go\\.mod$/i,\n /^setup\\.py$/i,\n /^setup\\.cfg$/i,\n /^docker-compose\\.ya?ml$/i,\n /^Dockerfile$/i,\n /^Makefile$/i,\n /^config\\/.*\\.(ya?ml|json|toml)$/i,\n /^src\\/index\\.(js|ts|tsx)$/i,\n /^src\\/main\\.(py|js|ts|rs)$/i,\n /^src\\/app\\.(py|js|ts)$/i,\n /^\\.github\\/workflows\\/.*\\.ya?ml$/i,\n /^streamlit_app\\.py$/i,\n /^train.*\\.py$/i,\n /^model.*\\.py$/i,\n /^predict.*\\.py$/i,\n /^Pipfile$/i,\n /^environment\\.ya?ml$/i\n];\n\nconst keyFiles = filteredTree\n .filter(item => item.type === 'blob')\n .filter(item => keyPatterns.some(pattern => pattern.test(item.path)))\n .map(item => item.path)\n .slice(0, 12);\n\nconst totalFiles = filteredTree.filter(i => i.type === 'blob').length;\nconst totalDirs = filteredTree.filter(i => i.type === 'tree').length;\n\nif (keyFiles.length === 0) {\n return [{\n json: { owner, repo, filePath: null, fileTreeStr, totalFiles, totalDirs }\n }];\n}\n\nreturn keyFiles.map(filePath => ({\n json: { owner, repo, filePath, fileTreeStr, totalFiles, totalDirs }\n}));" }, "position": [ -1616, 208 ] }, { "id": "9ed95dfa-5a0d-4f76-ab11-e8a25f3fb18b", "name": "Fetch Key File Contents", "type": "http", "params": { "url": "=https://api.github.com/repos/{{ $json.owner }}/{{ $json.repo }}/contents/{{ $json.filePath }}", "options": { "response": { "response": { "neverError": true } } }, "sendHeaders": true, "authentication": "predefinedCredentialType", "headerParameters": { "parameters": [ { "name": "Accept", "value": "application/vnd.github.v3+json" }, { "name": "User-Agent", "value": "n8n-repo-blueprint" } ] }, "nodeCredentialType": "githubApi" }, "position": [ -1344, 208 ] }, { "id": "076af1fe-6bfe-49ab-8500-cd1b2f3db975", "name": "Prepare LLM Input", "type": "code", "params": { "jsCode": "const items = $input.all();\nconst owner = $('Parse Owner and Repo').first().json.owner;\nconst repo = $('Parse Owner and Repo').first().json.repo;\nconst metadata = $('Fetch Repo Metadata').first().json;\nconst description = metadata.description || '';\nconst topics = (metadata.topics || []).join(', ');\nconst language = metadata.language || '';\nconst fileTreeStr = $('Identify Key Files').first().json.fileTreeStr;\nconst totalFiles = $('Identify Key Files').first().json.totalFiles;\nconst totalDirs = $('Identify Key Files').first().json.totalDirs;\n\nconst fileContents = items\n .filter(item => item.json.content && item.json.path)\n .map(item => {\n try {\n const decoded = Buffer.from(item.json.content, 'base64').toString('utf-8');\n const truncated = decoded.length > 3000\n ? decoded.substring(0, 3000) + '\\n... [TRUNCATED]'\n : decoded;\n return `--- FILE: ${item.json.path} ---\\n${truncated}\\n`;\n } catch(e) {\n return `--- FILE: ${item.json.path} --- [BINARY/UNREADABLE]\\n`;\n }\n })\n .join('\\n');\n\nconst prompt = `Repository: ${owner}/${repo}\\nDescription: ${description || 'No description provided'}\\nTopics: ${topics || 'None'}\\nPrimary Language: ${language || 'Unknown'}\\nTotal files: ${totalFiles} | Total directories: ${totalDirs}\\n\\n=== FULL FILE TREE ===\\n${fileTreeStr}\\n\\n=== KEY FILE CONTENTS ===\\n${fileContents}`;\n\nreturn [{\n json: {\n owner,\n repo,\n llmInput: prompt,\n fileTreeStr,\n totalFiles,\n totalDirs\n }\n}];" }, "position": [ -1088, 208 ] }, { "id": "b2f94c0e-b70b-4a2a-8cea-2a9863d78ce0", "name": "Analyze Architecture", "type": "llm", "params": { "text": "={{ $json.llmInput }}", "prompt": "={{ $json.llmInput }}", "batching": {}, "messages": { "messageValues": [ { "message": "You are a Senior Software Architect performing a forensic, evidence-only code analysis. You describe ONLY what exists in the repository evidence below. You NEVER speculate or assume.\n\nABSOLUTE RULES — VIOLATION MEANS FAILURE:\n1. ONLY reference technologies found in the file tree or file contents provided.\n2. Check dependency files (requirements.txt, package.json, Cargo.toml, go.mod, pyproject.toml) — list ONLY libraries found there.\n3. No Dockerfile in tree → DO NOT mention Docker.\n4. No .tf files in tree → DO NOT mention Terraform.\n5. No .github/workflows/ in tree → DO NOT mention CI/CD.\n6. Read entry-point files (main.py, app.py, index.js) to understand the project's ACTUAL purpose and domain.\n7. Every claim must trace to a specific file in the evidence.\n\nTOKEN EFFICIENCY: Concise. Bullets over paragraphs. No filler. Every sentence must add information.\n\nMERMAID SYNTAX RULES (violations break rendering):\n1. Node IDs: ONLY alphanumeric (A, B, SVC1). No special chars, spaces, or hyphens.\n2. Labels: ALWAYS in double quotes: A[\"Service\"].\n3. Reserved words (end, graph, subgraph, style, click, class, default): NEVER as node IDs.\n4. Edge labels in double quotes: A -->|\"data\"| B\n5. Every subgraph closes with end on its own line.\n6. Use flowchart TD (NOT graph TD).\n7. No emoji or unicode in Mermaid code.\n\nDark-theme hex styles:\n- Frontend: style ID fill:#1f6feb,stroke:#58a6ff,color:#fff\n- Backend: style ID fill:#238636,stroke:#3fb950,color:#fff\n- Database: style ID fill:#da3633,stroke:#f85149,color:#fff\n- External: style ID fill:#8b949e,stroke:#c9d1d9,color:#fff\n\nUse subgraph blocks to group by layer. Shapes: [\"Service\"] for services, [(\"Database\")] for databases.\n\nOUTPUT FORMAT (strict — nothing outside these sections):\n\n## Project Purpose\n[1-2 sentences: what this project does, with its specific domain, based on code evidence.]\n\n## Technical Stack\n- **Language**: [from file extensions]\n- **Framework**: [from dependency files ONLY]\n- **Key Dependencies**: [from requirements.txt/package.json/etc.]\n- **Infrastructure**: [ONLY if config files exist in tree — omit entire line if none]\n\n## Architecture Blueprint\n```mermaid\nflowchart TD\n[diagram reflecting ACTUAL file structure — subgraphs by layer]\n```\n\n## Request Flow\n```mermaid\nsequenceDiagram\n[based on ACTUAL code paths — min 3 participants]\n```\n\n## Evidence-Based Risks\n1. [Risk traceable to specific file/pattern]\n2. [Risk traceable to specific file/pattern]\n3. [Risk traceable to specific file/pattern]" } ] }, "provider": "openai", "promptType": "define", "approximated": true }, "position": [ -816, 208 ] }, { "id": "ce51847f-7c5f-494f-975b-e8ea545cd50c", "name": "Claude 3.5 Sonnet", "type": "llm", "params": { "model": "claude-sonnet-4-5-20250929", "options": { "temperature": 0.1, "maxTokensToSample": 3000 }, "provider": "anthropic", "temperature": 0.1 }, "position": [ -816, 432 ] }, { "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "name": "Fix Markdown", "type": "code", "params": { "jsCode": "const input = $input.first().json;\nlet md = input.text || '';\n\n// Fix: Ensure space after # headers\nmd = md.replace(/^(#{1,6})([^\\s#])/gm, '$1 $2');\n\n// Fix: Ensure blank line before headers\nmd = md.replace(/([^\\n])\\n(#{1,6}\\s)/g, '$1\\n\\n$2');\n\n// Fix: Ensure blank line before code blocks\nmd = md.replace(/([^\\n])\\n```/g, '$1\\n\\n```');\n\n// Fix: Ensure blank line after code blocks\nmd = md.replace(/```\\n([^\\n`])/g, '```\\n\\n$1');\n\n// Fix: Remove trailing whitespace on lines\nmd = md.replace(/[ \\t]+$/gm, '');\n\nreturn [{\n json: {\n ...input,\n text: md\n }\n}];" }, "position": [ -544, 208 ] }, { "id": "18443356-0962-445c-9f53-daf3e95505ed", "name": "Generate Dashboard HTML", "type": "code", "params": { "jsCode": "const analysisOutput = $input.first().json.text || '';\nconst owner = $('Parse Owner and Repo').first().json.owner;\nconst repo = $('Parse Owner and Repo').first().json.repo;\nconst description = $('Fetch Repo Metadata').first().json.description || '';\nconst totalFiles = $('Prepare LLM Input').first().json.totalFiles;\nconst totalDirs = $('Prepare LLM Input').first().json.totalDirs;\nconst defaultBranch = $('Fetch Repo Metadata').first().json.default_branch || 'main';\nconst now = new Date().toISOString().split('T')[0];\n\nconst mermaidBlocks = [];\nconst mermaidRegex = /```mermaid\\n([\\s\\S]*?)```/g;\nlet m;\nwhile ((m = mermaidRegex.exec(analysisOutput)) !== null) {\n mermaidBlocks.push(m[1].trim());\n}\n\nconst markdown = `# System Blueprint: ${owner}/${repo}\\n\\n> ${description || 'Architecture analysis'}\\n>\\n> Auto-generated on ${now} by Repo-to-Blueprint Architect\\n\\n${analysisOutput.trim()}\\n\\n---\\n\\n## Repository Stats\\n| Metric | Value |\\n|--------|-------|\\n| Total Files | ${totalFiles} |\\n| Total Directories | ${totalDirs} |\\n| Generated | ${now} |\\n| Source | [${owner}/${repo}](https://github.com/${owner}/${repo}) |\\n\\n---\\n\\n*Generated by Repo-to-Blueprint Architect via n8n*\\n`;\n\nconst mermaidPreview = mermaidBlocks.length > 0 ? mermaidBlocks[0].substring(0, 1500) : '[No diagram]';\n\nreturn [{\n json: {\n owner,\n repo,\n markdownContent: markdown,\n mermaidCode: mermaidPreview,\n diagramCount: mermaidBlocks.length,\n commitMessage: `docs: update system blueprint (${now})`,\n defaultBranch\n }\n}];" }, "position": [ -272, 208 ] }, { "id": "5301aa8f-fce4-42e8-8334-3339e873dfc3", "name": "Fetch Existing README", "type": "http", "params": { "url": "=https://api.github.com/repos/{{ $json.owner }}/{{ $json.repo }}/contents/README_ARCH.md?ref={{ $json.defaultBranch }}", "options": { "response": { "response": { "neverError": true } } }, "sendHeaders": true, "authentication": "predefinedCredentialType", "headerParameters": { "parameters": [ { "name": "Accept", "value": "application/vnd.github.v3+json" }, { "name": "User-Agent", "value": "n8n-repo-blueprint" } ] }, "nodeCredentialType": "githubApi" }, "position": [ 0, 208 ] }, { "id": "f006ed96-6ef9-4bc8-96bb-0fac76993db0", "name": "Prepare Push Data", "type": "code", "params": { "jsCode": "const dashData = $('Generate Dashboard HTML').first().json;\nconst existing = $input.first().json;\n\nconst content = Buffer.from(dashData.markdownContent).toString('base64');\n\nconst body = {\n message: dashData.commitMessage,\n content: content,\n branch: dashData.defaultBranch\n};\n\nif (existing.sha) {\n body.sha = existing.sha;\n}\n\nreturn [{\n json: {\n owner: dashData.owner,\n repo: dashData.repo,\n pushBodyStr: JSON.stringify(body),\n isUpdate: !!existing.sha,\n diagramCount: dashData.diagramCount,\n mermaidCode: dashData.mermaidCode\n }\n}];" }, "position": [ 272, 208 ] }, { "id": "e5558bb5-6670-4824-864c-696360085f67", "name": "Push README_ARCH.md", "type": "http", "params": { "url": "=https://api.github.com/repos/{{ $json.owner }}/{{ $json.repo }}/contents/README_ARCH.md", "method": "PUT", "options": {}, "jsonBody": "={{ $json.pushBodyStr }}", "sendBody": true, "sendHeaders": true, "specifyBody": "json", "authentication": "predefinedCredentialType", "headerParameters": { "parameters": [ { "name": "Accept", "value": "application/vnd.github.v3+json" }, { "name": "User-Agent", "value": "n8n-repo-blueprint" } ] }, "nodeCredentialType": "githubApi" }, "position": [ 544, 208 ] }, { "id": "f9b37d10-b08d-4689-9332-c3cdc1e0d2a0", "name": "Notify on Update", "type": "integration", "params": { "text": "=:{{ $('Prepare Push Data').first().json.isUpdate ? 'arrows_counterclockwise' : 'blueprint' }}: *System Blueprint {{ $('Prepare Push Data').first().json.isUpdate ? 'Updated' : 'Created' }}*\n\n*Repository:* \n*Blueprint:* \n*Diagrams:* {{ $('Prepare Push Data').first().json.diagramCount }} generated\n*Stats:* {{ $('Prepare LLM Input').first().json.totalFiles }} files | {{ $('Prepare LLM Input').first().json.totalDirs }} dirs\n\n```{{ $('Prepare Push Data').first().json.mermaidCode }}```", "select": "channel", "service": "slack", "resource": "message", "channelId": { "__rl": true, "mode": "list", "value": "" }, "operation": "post", "otherOptions": {} }, "position": [ 816, 48 ] }, { "id": "8e995431-419c-4d45-b349-368f72ec21c7", "name": "Send Success Page", "type": "passthrough", "params": { "mode": "noOp", "options": { "responseCode": 200, "responseHeaders": { "entries": [ { "name": "Content-Type", "value": "text/html; charset=utf-8" } ] } }, "respondWith": "text", "responseBody": "=Blueprint Generated

✅

Blueprint Generated!

Architecture analysis complete for
{{ $('Parse Owner and Repo').first().json.owner }}/{{ $('Parse Owner and Repo').first().json.repo }}

{{ $('Prepare Push Data').first().json.diagramCount }} diagram(s) generated and pushed.

View README_ARCH.md →

" }, "position": [ 1088, 48 ] } ] }

Transform GitHub repos into evidence-based architecture blueprints with Claude