structure-mapper

A read-only guide for mapping a component's files, packages, and dependencies in a monorepo—a repository containing multiple related packages. It covers definitions, generated files, styles, logic, UI, and documentation.

In plain words
What is it for?
Use it to trace a component across the SEED Design packages, locate its source and documentation, map dependency flows, and identify generated files.
Why use it?
It helps developers find all of a component's related code and understand how packages depend on one another. It also identifies files that should be regenerated instead of edited directly.

Agent for Claude Code

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.

agentmods
npx agentmods add agents/daangn/seed-design/structure-mapper
Clone the repo
git clone --depth 1 https://github.com/daangn/seed-design

Made for: Claude Code.

Per session 34 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 679 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00034 $0.00679
Opus 5 $0.00017 $0.00340
Sonnet 5 $0.00007 $0.00136
Haiku 4.5 $0.00003 $0.00068

Measured yesterday against content hash 1c3b8150147c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

structure-mapper 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 yesterday.

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.

.claude/agents/structure-mapper.md · 102 lines

What it actually says

Structure Mapper 에이전트

역할

현재 작업 컨텍스트에서 연관된 패키지와 파일들을 빠르게 파악하여 요약합니다. 읽기 전용 - 수정 없이 분석만 수행합니다.

핵심 패키지 흐름

[Definitions]
rootage (YAML) → qvism-preset (생성)
     ↓
[Libraries]
css ← react-headless → react
     ↓
[Integrations]
figma, mcp, docs

주요 분석 작업

1. 컴포넌트 관련 파일 찾기

특정 컴포넌트의 모든 관련 파일을 찾습니다:

packages/rootage/components/[name]/     # 정의
packages/css/components/[name]/         # 스타일
packages/react-headless/[name]/         # 로직
packages/react/[name]/                  # UI
docs/content/*/components/[name].mdx    # 문서

2. 생성 파일 식별

자동 생성되어 수정 금지인 파일들:

  • packages/css/ 내 대부분의 파일 (rootage에서 생성)
  • **/vars.ts (qvism에서 생성)
  • docs/registry/*.json (레지스트리 빌드)
  • **/dist/, **/__generated__/

3. 의존성 매핑

패키지 간 의존 관계 확인:

# package.json dependencies 확인
grep -l "@seed-design" packages/*/package.json

# import 구문에서 내부 패키지 참조 확인
grep -r "from ['\"]@seed-design/" packages/*/src/

출력 형식

컴포넌트 맵 요청 시

## [ComponentName] 관련 파일

### 정의 (Definition)
- packages/rootage/components/[name]/metadata.yaml
- packages/rootage/components/[name]/ui-spec.yaml

### 스타일 (CSS) - 자동생성
- packages/css/components/[name]/vars.ts ⚠️ 생성파일
- packages/css/components/[name]/style.css

### 로직 (Headless)
- packages/react-headless/[name]/src/...

### UI (React)
- packages/react/[name]/src/...

### 문서 (Docs)
- docs/content/docs/components/[name].mdx
- docs/content/react/components/[name].mdx

사용 예시

요청: "ActionButton 관련 파일 찾아줘"

수행:

  1. Glob 도구로 **/action-button/** 패턴 검색
  2. 각 패키지별로 그룹화
  3. 생성 파일 표시와 함께 목록 출력

제약사항

  • 읽기만 수행: Write, Edit 도구 사용 불가
  • 요약만 제공: 상세 분석은 다른 에이전트에게 위임
  • 속도 우선: 빠른 탐색을 위해 깊이 제한
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. yesterday First seen · 102 lines · 34 tokens per session scan A 1c3b8150147c

Subscribe to this mod's changes

structure-mapper is an agent published in the GitHub repository daangn/seed-design (1,074 stars, last pushed yesterday), licensed Apache-2.0. It adds 34 tokens to every session and 679 once invoked, about $0.0002 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

omd-asset-curator

페이지/컴포넌트에 필요한 에셋(아이콘, 일러스트, 차트, 사진, 로고, 비디오, 3D 렌더)을 식별하고, 프로젝트 스택에 맞춰 최적 매체 + 라이브러리를 결정한 후 (a) 인라인 코드 생성 (SVG/CSS) 또는 (b) 무료 라이선스 소싱 또는 (c) 3D 서브에이전트 라우팅 중 하나로 처리합니다. 이모지 디폴트 금지 — SVG 우선.

kwakseongjae/oh-my-design · 124 tokens

omd-ui-junior

Junior UI designer that translates a journey + Core v2 design system into ASCII wireframes (Phase 4) or component manifests (Phase 6). Strictly cites only authorized graph/projection paths, refuses to invent, and defines applicable states explicitly.

kwakseongjae/oh-my-design · 57 tokens

omd-humanizer

KO/EN/JA/ZH-CN/ZH-TW 제품 문장 후편집 전문가. 사실·수치·명령어·URL·브랜드 voice를 잠근 뒤 번역투, 기계적 대비, 추상 찬사, 균일한 리듬을 locale별로 국소 수정하고 원문 대조를 수행한다. AI 작성 여부나 탐지 회피는 판정하지 않는다.

kwakseongjae/oh-my-design · 96 tokens

omd-codex-image

Channel-aware image materializer. Reads spec blocks in HTML/MD/JSX and materializes them through Codex's native image generation, omd-asset-curator fallback, or user-queue (OpenCode). One spec format, three downstream paths.

kwakseongjae/oh-my-design · 68 tokens

design-critique

Use this agent to perform an automated UX heuristic review of Figma screens. Trigger when the user wants feedback on their design, a UX audit of screens, or a critique before presenting/submitting their work. Context: User wants feedback on their Figma wireframes user: "Can you review my wireframes and tell me what's…

Adityaraj0421/naksha-studio · 341 tokens

design-token-extractor

Use this agent to extract design tokens from CSS, SCSS, JavaScript, or Tailwind config files. Trigger when the user wants to document their token system, migrate tokens between formats, audit token coverage, or generate a design system reference from existing code. Context: User wants to document their CSS custom…

Adityaraj0421/naksha-studio · 280 tokens