Architecture Research
Research the architecture of a codebase or system. Reads source code, finds external context, explains design decisions, and produces ELK diagrams. Use when... Skill: Architecture Research Owner: brennerspear Summary: Research the architecture of a codebase or system. Reads source code, finds external context, explains design decisions, and produces ELK diagrams. Use when... Tags: latest:1.0.0 Version history: v1.0.0 | 2026-02-25T00:11:40.406Z | user Initial publish Archive index: Archive v1.0.0: 2 files, 2841 bytes Files: SKILL.md (5266b), _meta.json (140b) File v1.0.0:SKI
Rank
62
Safety
84
Downloads
1.0k
Updated
Oct 11, 2026
Version
1.0.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.0release · observed Feb 25, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17ebpr0c7y6bpmzatrjw5rdt583fggy:architecture-research- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-brennerspear-architecture-research/snapshot"
Run-check
$0.02 USD1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.
Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.
Documentation
CLAWHUB
5,832 characters of source documentation, loaded on request.
Extracted files
2 files captured from the source.
SKILL.md
---
name: architecture-research
description: Research the architecture of a codebase or system. Reads source code, finds external context, explains design decisions, and produces ELK diagrams. Use when asked to understand, explain, or diagram how a repo/system is built.
compatibility: "Requires: diagrams skill (clawhub install diagrams)"
---
# Architecture Research
## Trigger
Activate when the user wants to:
- Understand how a repo or system is architected
- Get diagrams of a codebase's structure or data flow
- Understand design decisions and trade-offs in a project
## Workflow
### 1. Read the Source
Clone or browse the repo. Read actual code — module structure, entry points, key abstractions. Don't rely solely on READMEs.
Focus on:
- Directory structure and module boundaries
- Entry points and public APIs
- Data models and storage
- Config and dependency injection patterns
- Build/deploy setup
### 2. Find External Context
Search for official docs, blog posts, conference talks, design docs, ADRs, and community discussions that explain the *why* behind the architecture.
Cite what you find. If you're inferring rationale (no source), say so explicitly.
### 3. Explain from Multiple Angles
Cover at least these perspectives:
| Angle | What to show |
|-------|-------------|
| **System overview** | Major components and how they connect |
| **Data/control flow** | What happens for a key operation (e.g., a request, a build, a deploy) |
| **Design decisions** | What they chose, the obvious alternative, and why |
### 4. Produce ELK Diagrams (with SVG rendering)
For each major angle, generate an **ELK JSON graph** (elkjs format), then **render it to SVG** so it displays inline in markdown.
#### ELK JSON structure
```json
{
"id": "root",
"layoutOptions": {
"elk.algorithm": "layered",
"elk.direction": "DOWN",
"elk.spacing.nodeNode": "40"
},
"children": [
{ "id": "node1", "width": 150, "height": 60, "labels": [{ "text": "Component A" }] }
],
"edges": [
{ "id": "e1", "sources": ["node1"], "targets": ["node2"], "labels": [{ "text": "calls" }] }
]
}
```
#### Rendering to SVG
This skill uses the **diagrams** skill for rendering. Install it if you haven't:
```bash
clawhub install diagrams
```
Then render ELK JSON → SVG using the diagrams skill's renderer:
```bash
# Single file
node <diagrams-skill-dir>/scripts/render-elk.mjs diagram.json output.svg
# Batch: all .json files in a folder → svg/ subfolder
node <diagrams-skill-dir>/scripts/render-elk.mjs --dir <folder>
# Batch + PNG (macOS only)
node <diagrams-skill-dir>/scripts/render-elk.mjs --dir <folder> --png
```
Replace `<diagrams-skill-dir>` with the path to the installed diagrams skill directory.
> **Note:** elkjs must be installed locally where you run the script. See the diagrams skill's SKILL.md for full setup.
**Workflow for each diagram:**
1. Write the ELK JSON to a `.json` file in the research folder
2. Render: `node <diagrams-skill-dir>/scripts/ren_meta.json
{
"ownerId": "kn73629had1csmxwjst38fqjxh80bxr5",
"slug": "architecture-research",
"version": "1.0.0",
"publishedAt": 1771978300406
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/brennerspear/skills/architecture-research",
"sourceUrl": "https://clawhub.ai/brennerspear/skills/architecture-research",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T15:06:08.450Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-brennerspear-architecture-research/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-brennerspear-architecture-research/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T15:06:08.450Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1K downloads",
"href": "https://clawhub.ai/brennerspear/architecture-research",
"sourceUrl": "https://clawhub.ai/brennerspear/architecture-research",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T15:06:08.450Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.0",
"href": "https://clawhub.ai/brennerspear/architecture-research",
"sourceUrl": "https://clawhub.ai/brennerspear/architecture-research",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-25T00:11:40.406Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-brennerspear-architecture-research/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-brennerspear-architecture-research/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.0",
"description": "Initial publish",
"href": "https://clawhub.ai/brennerspear/architecture-research",
"sourceUrl": "https://clawhub.ai/brennerspear/architecture-research",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-25T00:11:40.406Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
