yd-blueprint

yd-blueprint is a skill for Claude Code from LeeYudok/agents-scaffold. It costs 176 tokens per session (3,952 once invoked), scanned A, original, MIT.

A project blueprint tool that records a codebase's structure, data flow, implementation status, and remaining work as JSONL, a format with one JSON object per line. It displays that information in a Vite and React page at a local address.

In plain words
What is it for?
Use it to create or update project maps, show frontend-to-backend boundaries, track implementation status and open work, and check a blueprint against the current code and deployment state.
Why use it?
Architecture diagrams and status pages become misleading when their paths and facts grow old. This keeps the recorded information separate from the display and checks whether referenced code paths still exist.

Skill for Claude Code

Written for Claude Code: installed under .claude/. Also seen: mentions Codex.

Good fit Use it to create or update project maps, show frontend-to-backend boundaries, track implementation status and open work, and check a blueprint against the current code and deployment state.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/leeyudok/agents-scaffold/yd-blueprint
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.

Any agent
npx skills add LeeYudok/agents-scaffold --skill yd-blueprint
Clone the repo
git clone --depth 1 https://github.com/LeeYudok/agents-scaffold

Made for: Claude Code.

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 yd-blueprint

README.md
[![agentmods](https://agentmods.dev/badge/skills/leeyudok/agents-scaffold/yd-blueprint/github.svg)](https://agentmods.dev/skills/leeyudok/agents-scaffold/yd-blueprint)
Your own site
<a href="https://agentmods.dev/skills/leeyudok/agents-scaffold/yd-blueprint"><img src="https://agentmods.dev/badge/skills/leeyudok/agents-scaffold/yd-blueprint/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for yd-blueprint

Your own site · 80×15
<a href="https://agentmods.dev/skills/leeyudok/agents-scaffold/yd-blueprint"><img src="https://agentmods.dev/badge/skills/leeyudok/agents-scaffold/yd-blueprint.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 176 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,952 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.00176 $0.03952
Opus 5.5 $0.00070 $0.01581
Sonnet 5.5 $0.00035 $0.00790
Haiku 4.5 $0.00018 $0.00395

Measured today against content hash b944daeff75e, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

yd-blueprint 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 today.

The scan reads SKILL.md. This mod also ships 6 executable files (assets/template/scripts/check.mjs, assets/template/scripts/check.sh, assets/template/src/blueprint.ts, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

.claude/skills/yd-blueprint/SKILL.md · 104 lines

How it starts

The opening of the file, as written. The whole thing — 104 lines — stays where its author put it; the contents beside it link to each section on GitHub.

yd-blueprint

역할

프로젝트의 구조·기록 흐름·구현 현황·남은 작업을 JSONL 데이터로 적고, Vite + React 화면으로 띄운다(패키지 매니저는 bun·pnpm·npm 아무거나). 화면은 localhost:5173/blueprint/ 하나다. 데이터와 화면을 나눠 두면 에이전트가 HTML 을 문자열로 고치지 않고 줄 단위로 고치며, 검사기가 낡은 경로를 잡는다.

언제 쓰나

  • 청사진·구조도·구현 현황표를 새로 만들 때 — 첫 인스턴스는 infra 레포의 감지 화면 청사진이다. 옛 정적 청사진 HTML 은 지우지 않고 같은 폴더의 backup/blueprint/ 로 옮겨 보관했다
  • 구성요소·경로·상태가 바뀌어 기존 청사진을 고칠 때
  • 프론트(브라우저)·중계·백엔드의 읽기·영상·쓰기 경계를 한 장에 그려야 할 때
  • 청사진이 코드와 어긋났는지(없는 경로, 오래된 기준일) 확인할 때

만들기

  1. 조사 — 청사진에 적을 사실은 코드·설정·배포 상태에서 직접 확인한다. 기존 문서의 문장을 그대로 옮기지 않는다. 확인한 날이 asOf 다.
  2. 뼈대 — scripts/new-blueprint.sh [--root <기준 폴더>] [--dir frontend] [--pm bun|pnpm|npm] [--deps-dir ~/.tmp]. 기본은 git 루트의 frontend/. 이미 비어 있지 않은 폴더는 덮어쓰지 않으므로, 기존 프론트가 있으면 --dir frontend/blueprint 처럼 비켜 만든다. 하위 프로젝트에 두려면 --root <하위 프로젝트 폴더> 처럼 준다. git 저장소 밖이면 --root 가 꼭 필요하다.
  3. 데이터 — data/*.jsonl 에 줄마다 JSON 한 개를 적는다(아래 스키마). 파일명 순서가 표시 순서다. 샘플 줄은 지운다.
  4. 띄우기 — cd <폴더> && bun run dev(pnpm·npm 이면 pnpm run dev·npm run dev). 기본 포트 5173 의 /blueprint/ 가 열린다. 포트가 차 있으면 vite 가 다음 포트를 잡으니 vite 가 출력한 주소를 쓴다. 자동 열기는 BROWSER=none.
  5. 검사 — check 스크립트(예: bun run check). 스키마·참조·근거 경로 존재를 본다. build 는 타입체크 후 dist/ 를 만든다.

스크래치·로컬 청사진은 의존성을 한 폴더에 모은다. --deps-dir ~/.tmp 를 주면 그 폴더의 node_modules 에 없는 패키지만 설치하고, 청사진 폴더에는 설치하지 않는다. 대상이 그 폴더 아래면 링크하지 않는다. Node 가 상위 폴더를 타고 올라가 찾기 때문이다. 밖이면 node_modules 심링크를 건다. 패키지는 버전 하나만 둘 수 있고 이미 있는 패키지는 버전이 달라도 건드리지 않는다. 락파일이 프로젝트에 남지 않으므로 커밋할 청사진에는 쓰지 않는다. vite 캐시는 템플릿이 프로젝트 폴더의 .vite 에 두므로 공유 node_modules 를 써도 섞이지 않는다.

뼈대는 어느 패키지 매니저로 깔아도 수정 없이 같다. package.json 의 스크립트는 특정 매니저나 런타임을 부르지 않는다(bun run·bunx·node 파일 금지). check 는 sh scripts/check.sh 가 bun 이 있으면 bun, 없으면 node(22.6 이상)로 같은 check.mjs 를 돌린다. --pm 을 주지 않으면 PATH 에서 bun → pnpm → npm 순으로 처음 찾은 것을 쓴다. bun 을 앞세우는 이유는 설치가 가장 빠르고, pnpm 은 패키지를 받기 어려운 환경이 있기 때문이다(2026-10-05 사용자 지시). 락파일은 설치한 매니저가 만든 하나만 커밋한다. 매니저가 하나도 없으면 brew install oven-sh/bun/bun.

데이터 스키마

Read the full file on GitHub · 104 lines

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. today First seen · 104 lines · 176 tokens per session scan A b944daeff75e

Subscribe to this mod's changes

yd-blueprint is a skill published in the GitHub repository LeeYudok/agents-scaffold (36 stars, last pushed today), licensed MIT. It adds 176 tokens to every session and 3,952 once invoked, about $0.0007 per session on Opus 5.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-10-25.