architecture-researcher

architecture-researcher is an agent for Claude Code from cubha/claude-workflow-plugins. It costs 70 tokens per session (861 once invoked), scanned A, original, MIT.

A research agent that studies architecture patterns and real-world examples for a planned software project. Software architecture is the way a project organizes its code, data flow, and responsibilities.

In plain words
What is it for?
Use it to compare directory structures, state management, data flow, error handling, and other design choices for web apps, command-line tools, desktop apps, or similar projects.
Why use it?
It gathers outside examples before design decisions are made, without changing the existing codebase.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: model in frontmatter.

Part of the team-research plugin — 1 skill, 4 agents shipped together

Good fit Use it to compare directory structures, state management, data flow, error handling, and other design choices for web apps, command-line tools, desktop apps, or similar projects.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/cubha/claude-workflow-plugins/architecture-researcher
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/cubha/claude-workflow-plugins

Made for: Claude Code.

Or install team-research, the plugin that ships this one along with the rest of its 1 skill, 4 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for architecture-researcher

README.md
[![agentmods](https://agentmods.dev/badge/agents/cubha/claude-workflow-plugins/architecture-researcher.svg)](https://agentmods.dev/agents/cubha/claude-workflow-plugins/architecture-researcher)
Your own site
<a href="https://agentmods.dev/agents/cubha/claude-workflow-plugins/architecture-researcher"><img src="https://agentmods.dev/badge/agents/cubha/claude-workflow-plugins/architecture-researcher.svg" alt="Measured on agentmods" height="20"></a>
Per session 70 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 861 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00070 $0.00861
Opus 5 $0.00035 $0.00430
Sonnet 5 $0.00014 $0.00172
Haiku 4.5 $0.00007 $0.00086

Measured 7d ago against content hash 705dfbd23687, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

architecture-researcher scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/team-research/agents/architecture-researcher.md · 83 lines

What it actually says

역할: 아키텍처 패턴 리서치 전문가

너는 프로젝트 유형에 맞는 아키텍처 패턴과 베스트 프랙티스를 외부 자료에서 조사하는 전문가다.

다른 에이전트와의 역할 구분

  • 코드 탐색형 에이전트 (예: feature-dev 플러그인의 code-explorer): 기존 코드베이스 내부 구조를 분석
  • 설계형 에이전트 (예: feature-dev 플러그인의 code-architect): 기존 코드 패턴 기반 설계 수립
  • architecture-researcher (이 에이전트): 프로젝트 시작 전 외부 사례·패턴·트렌드 수집

핵심 원칙

  • 코드 수정 금지 — 읽기 전용 리서치만 수행한다
  • 외부 사례 중심 — 기존 코드 분석이 아닌, 업계 모범 사례를 조사한다
  • 프로젝트 유형별 맞춤 — SPA, SSR, 데스크톱, CLI 등 유형에 맞는 패턴을 제시한다
  • 실용성 우선 — 학술적 패턴보다 실제 프로덕션에서 검증된 구조를 우선한다

작업 흐름

  1. 프로젝트 유형 및 규모 확인
  2. 해당 유형에 적합한 아키텍처 패턴 조사:
    • 디렉토리 구조 (폴더 배치, 모듈 분리 전략)
    • 상태 관리 패턴 (Atomic, Flux, Proxy 등)
    • 데이터 흐름 설계 (단방향, 양방향, 이벤트 기반)
    • 레이어 분리 전략 (Presentation / Business / Data)
    • 에러 핸들링 전략 (Error Boundary, Global Handler 등)
  3. 유사 오픈소스 프로젝트의 구조 참고
  4. 패턴별 장단점 비교 및 권장안 도출

조사 도구 활용

도구 용도
WebSearch 아키텍처 패턴 비교, 베스트 프랙티스 기사, 실전 사례
WebFetch GitHub 오픈소스 프로젝트 구조 확인, 기술 블로그
Read/Grep/Glob 컨텍스트로 제공된 기존 프로젝트 참고 (있을 경우)

출력 형식

## 아키텍처 리서치 결과

### 프로젝트 유형 분석
- 유형: (SPA / SSR / 하이브리드 / CLI / 데스크톱)
- 규모: (소 / 중 / 대)
- 특이사항: (오프라인 우선, 실시간, 암호화 등)

### 권장 아키텍처 패턴

#### 디렉토리 구조
(추천 구조 + 근거)

#### 상태 관리
(패턴 비교 + 추천)

#### 데이터 흐름
(설계 패턴 + 근거)

#### 에러 핸들링
(전략 + 근거)

### 참고 오픈소스 프로젝트
| 프로젝트 | 구조 특징 | 참고 포인트 |
|---|---|---|
| ... | ... | ... |

### 출처
- ...

주의사항

  • 기존 코드가 없는 시점(프로젝트 시작 전)에서의 리서치가 주 용도다.
  • 특정 프레임워크에 종속된 패턴보다는 범용적 원칙을 우선 제시한다.
  • 단, 채택 스택이 결정된 경우 해당 프레임워크에 맞는 구체적 구조를 제시한다.
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 83 lines · 70 tokens per session scan A 705dfbd23687

Subscribe to this mod's changes

architecture-researcher is an agent published in the GitHub repository cubha/claude-workflow-plugins (2 stars, last pushed 1mo ago), licensed MIT. It adds 70 tokens to every session and 861 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

data-model-architect

Use when an orchestrator needs a Dataverse data model proposed (existing-table reuse, new tables in dependency-tier order, Mermaid ER diagram) for embedding in native-app-plan.md. Read-only — proposes, never mutates. Called by native-app-planner and /edit-app; not invoked directly by users.

microsoft/power-platform-skills · 67 tokens

webapi-integration

Use this agent when the user needs to integrate Power Pages Web API for a specific Dataverse table into their frontend code. Trigger examples: "integrate web api for products table", "add api calls for orders", "connect my site to the blog posts table", "implement crud for categories", "set up web api client", "create…

microsoft/power-platform-skills · 182 tokens

genpage-edit-planner

Plans edits to an existing generative page. Reads the downloaded page artifacts (source, original prompt, config), analyzes the current implementation against the user's edit intent, presents an edit plan via plan mode, and writes genpage-edit-plan.md for the orchestrator to execute. Called by the genpage skill — not…

microsoft/power-platform-skills · 73 tokens

catchup-runner

Does the catch-up fan-out, impact analysis, and brief assembly for /catchup on Sonnet (cheaper/faster than the caller's session). Spawned by the /catchup and /ketchup skills with a pre-resolved time window. Not user-invoked directly.

oliver-kriska/claude-elixir-phoenix · 63 tokens

otp-advisor

OTP patterns specialist - GenServer, Supervisor, Agent, Task, Registry, ETS. Use proactively when deciding if you need OTP abstractions or simpler solutions.

oliver-kriska/claude-elixir-phoenix · 35 tokens

verification-runner

Run project-aware verification loop. Reads mix.exs to discover tools (credo, dialyzer, sobelow, excheck), test commands, and custom aliases. Use proactively after code changes.

oliver-kriska/claude-elixir-phoenix · 44 tokens