agentmods.dev

James-RAG-Evol: Instructions file for Claude Code

CLAUDE.md

James-RAG-Evol CLAUDE.md is an instructions file for Claude Code from Hashevolution/James-RAG-Evol. It costs 11,831 tokens per session, scanned A, original, MIT.

A session briefing for JAMES, a local-first system for auditable knowledge reasoning. It records the project's current version, direction, and recent work.

In plain words
What is it for?
Use it before working on JAMES to understand its current roadmap, releases, audit benchmarks, and where to look for more detail.
Why use it?
It quickly gives a new coding-agent session the project context and important rules without relying on earlier chat history.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: mentions CLAUDE.md; mentions Claude Code.

This is Hashevolution/James-RAG-Evol's own configuration. It tells Claude Code how to work on James-RAG-Evol itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything James-RAG-Evol configures →

not rated 21repo changed 1mo ago A scan 11,831 tokens original MIT
View source ↗ Hashevolution/James-RAG-Evol bestpractices.dev
Reuse

Borrowing it

Nothing to install: this file belongs to Hashevolution/James-RAG-Evol. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/Hashevolution/James-RAG-Evol/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/Hashevolution/James-RAG-Evol

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 James-RAG-Evol CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/hashevolution/james-rag-evol/claude-md/github.svg)](https://agentmods.dev/instructions/hashevolution/james-rag-evol/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/hashevolution/james-rag-evol/claude-md"><img src="https://agentmods.dev/badge/instructions/hashevolution/james-rag-evol/claude-md/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 James-RAG-Evol CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/hashevolution/james-rag-evol/claude-md"><img src="https://agentmods.dev/badge/instructions/hashevolution/james-rag-evol/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 11,831 This file is loaded in full into every session.
When invoked 11,831 The same file — it is already loaded in full.
Security scan A 1 finding. 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.11831 $0.11831
Opus 5.5 $0.04732 $0.04732
Sonnet 5.5 $0.02366 $0.02366
Haiku 4.5 $0.01183 $0.01183

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

Security

Grade A, and why

James-RAG-Evol CLAUDE.md scanned grade A with 1 finding 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 1mo 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

테스트는 operator 가 띄운 서버에 curl 로 붙거나 단발 foreground 실행으로
CLAUDE.md · 375 lines

How it starts

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

SEKOS / JAMES — Session Briefing for Claude Code

Read this first. This file orients any new Claude Code session to the project's current direction in under 60 seconds.

What JAMES is

A local-first, auditable knowledge reasoning system. See docs/ARCHITECTURE.md for full design principles and non-goals.

Where we are right now

단일 진실원 (single source of truth): docs/handovers/v0.6.2-lrb-rebaseline-close-2026-09-21.md. (Phase 정의는 v0.6.2-restart-roadmap-2026-09-03.md 가, 사이클 마감 실측은 v0.6.1-close-2026-09-10.md 가 계속 유효하고, 최신 문서가 진행 결과를 갱신합니다.) 아래는 그 요약입니다. 충돌하면 로드맵 문서가 우선입니다.

  • 최신 릴리스: v0.6.1 — 2026-09-10 마감, DOI 미발행 (operator 판단). v0.4.4 이후 태그 없이 떠 있던 282 PR (#831–#1112) 을 전부 담습니다 — v0.5 마감 · v0.6 · v0.6.1 · v0.6.2 재개분. 릴리스 노트 docs/release_notes_v0.6.1.md, 마감 핸드오버 docs/handovers/v0.6.1-close-2026-09-10.md. ⚠️ v0.5 는 자체 태그가 없습니다 — 소급 태깅은 DOI 계보를 바꾸므로 operator 판단. 최신 DOI 는 여전히 v0.4.4 10.5281/zenodo.20652679.
  • 사이클 상태: v0.6.1 released / v0.6 정식 미진입. 태그는 제품 릴리스이지 사이클 진입이 아닙니다. v0.5 → v0.6 게이트 = Dim F (외부 고객 6 개월 이상 파일럿) 미통과. 2-fork 계약이 유효 — Fork A LOI 체결 → Track D 버티컬 팩 / Fork B 6 개월 무LOI → 전략 재평가. 판정 시점 ≈ 2026-12-13. 둘 다 operator 결정이며, 결정 전에도 아래 Phase 1–5 는 전부 진행 가능합니다.
  • 실제로 진행된 것: v0.6 / v0.6.1 제품 하드닝 스트림 — PR #886–#1078 (2026-06-13 → 2026-06-26). 2026-09-10 에 v0.6.1 로 태깅됐습니다 (그 태그의 실제 범위는 #831–#1112 로 더 넓습니다). 주요 산출물: 운영 하드닝 P1–P4 (신뢰 프록시 / HTTPS 가이드 / 테넌트 미들웨어 / 온보딩·롤백·추론 시각화·용어집) · 템플릿(양식) 엔진 · 에이전트 트랙 (core/agent_tools + tool-use 루프 + run_shell 기본 OFF) · LLM 라우팅 통합 + 모드별 측정 라우팅 · 채팅 UX 전면 개편 · UI 8→5 페이지 통합 + 비주얼 회귀 하네스 · CSP 인라인 스타일 이관 · 이미지-OCR/비전 체인 수리 · heartbeat 스트리밍 · detailed 답변 스타일.
  • 🔴 lifecycle live-consistency arc (#1018–#1027, #1033–#1034): 프로브(#1020)가 라이브 그래프 탐색이 lifecycle status 를 무시함을 측정으로 증명 (캐스케이드가 라이브 계층에서 사실상 무효였음) → relation_is_live() 게이트를 탐색 / 그래프 스코어 / T1 유효 윈도우 / 3D 스냅샷 전 표면에 적용, 시간여행 경로 격리 검증, 백로그 재측정으로 회귀 없음 확인 (#1028–#1032). 이것이 core/graph traversal 0-라인 streak 의 유일한, 측정 근거로 승인된 예외입니다. 이전 핸드오버의 "0 라인 streak 유지" 문장을 그대로 복사하지 마세요.
  • ✅ main CI 그린, 그리고 넓어짐 (2026-09-09) — --ignore 목록 51건을 전부 회수해 CI 가 실제로 도는 테스트가 4,469 → 5,309 (+840), 여전히 0 failed. 목록에 달려 있던 "의존성이 생기면 회수" 계획은 이미 추월당해 있었습니다 — 파일들은 통과하고 있었고 아무도 확인하지 않았습니다. 측정은 detached worktree (.env 없음) + 죽은 Ollama 포트 + 환경변수 73개 제거로 "내 머신에서는 통과한다" 를 배제한 뒤, 실제 CI 실행으로 확정했습니다.
  • ✅ Phase 3.3 종료 (2026-09-09) — JS 인라인 style= 26 → 0, setAttribute('style') 1 → 0. CSP style-src 가 'unsafe-inline' 을 떼고 'self' 로 졸업했습니다. 모드 기본값은 report-only 그대로 — enforce 플립은 operator 판단이고, 🔴 남은 블로커는 style 이 아니라 graph.html 의 unpkg.com 스크립트 3종입니다 (script-src 'self' 가 차단; 로컬 우선 원칙상 vendoring 이 답).
  • 이전 마감 (2026-09-08) — 4,464 passed / 0 failed (f410c3c, run 34171536814). 2026-06-22 이후 처음입니다. 로드맵 Phase 2 종료. 마지막 남았던 LRB S2 는 operator 가 §7 결정 #1 (충돌 수리) 을 택해 PR #1089 로 처리했고 (V/N/J = 0.2500 / 0.5875 / 0.7625, J − N 은 0.175 로 불변), 그 과정에서 CI 가 57개 테스트 파일을 --ignore 하며 902 테스트 / 적색 8건을 가리고 있던 것이 드러나 PR #1088 이 8건 전부 수리 + 6개 un-ignore (57 → 51). ruff / bandit 은 계속 초록. mobile.css 잔여 !important 도 #1116 으로 20 → 0. 로드맵 Phase 4 는 2026-09-10 에 종료, Phase 3 은 3.1 / 3.2 (operator dogfood) 만 남았습니다.
  • ✅ LRB 재베이스라인 arc 종료 (2026-09-12 → 09-14, #1121–#1128) — operator 가 결정 #1 · #7 을 승인해 발표 수치를 재베이스라인했고, S3 publication 4-leg cross-model 을 사전등록표 그대로 ⭐⭐ partial (3/4) + attribution finding 으로 닫았습니다. JAMES 주장 (J > N, J > V, J−N > +0.10) 은 10개 LLM-grounded 셀 전부에서 성립하고, 깨진 것은 claude leg 의 baseline 순서 (V ≈ N, 0.019 차) 입니다. 측정 위생 3건 (#1123 / #1124 / #1126) 이 오염된 실행 2회를 잡아 폐기시켰습니다. 수치와 상세는 아래 §"Where to look next" 첫 행 — 여기에 복제하지 마세요 (rule #6). 로드맵 Phase 5 측정 백로그 소진, 잔여 = QVT 3축 (서버 필요).
  • 유지보수 4 PR (#1077 #1078 08-19 / #1079 08-26 / #1080 08-28): v0.3.3 DOI 계보 정정, ruff F-class 해소, Ali 엔지니어링 4건 ①②③ 발송 + uuid7 production 결함 수리 (start_trace() 가 Python 3.14 전용 uuid.uuid7() 호출 → 지원 인터프리터 전부에서 /query/ 엣지 다운), 아랍어 파이프라인 능력 감사, 그리고 CI 원인별 정리 (_IncludedRouter 래퍼가 137 라우트를 숨긴 문제 + rule #5 2건).
  • 유휴 구간: 마지막 기능 세션 2026-06-26. 이후 착륙한 것은 전부 문서·인용·CI 유지보수입니다.
  • 전략 프레임: 여전히 mother platform. v1.0 이전 버티컬 분화 금지 (rule #1). v0.5 후보 도메인 = enterprise internal knowledge ontology (horizontal) — 이는 선택 기준이지 구현 승인이 아닙니다.
  • 브랜드 규약: SEKOS = 제품 브랜드 (UI / 대외 / 마케팅), JAMES = 엔진 코드명 (소스, JAMES_* env, --sut james, RAB/LRB, Zenodo DOI). PR #934 에서 확정 — 재현성 때문에 코드/논문 쪽은 JAMES 유지.

Read the full file on GitHub · 375 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. 1mo ago Changed · -20 lines · -343 tokens per session a3357a03162a
  2. 1mo ago Changed · +8 lines · +271 tokens per session a29c8e74492e
  3. 1mo ago Changed · +17 lines · +674 tokens per session 22d0141a34e8
  4. 1mo ago Changed · +37 lines · +1,187 tokens per session 841544c29530
  5. 1mo ago Changed · +28 lines · +632 tokens per session 183194b735a4
  6. 2mo ago Changed · +33 lines · +498 tokens per session f6e5589505a7
  7. 2mo ago First seen · 272 lines · 8,912 tokens per session scan A d30a2df681c7

Subscribe to this mod's changes

James-RAG-Evol CLAUDE.md is an instructions file published in the GitHub repository Hashevolution/James-RAG-Evol (21 stars, last pushed 1mo ago), licensed MIT. It adds 11,831 tokens to every session, about $0.0473 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Data and AIRAG and vectorsai-agentfastapigraph-ragknowledge-graphlocal-ailocal-llm
Related

James-RAG-Evol CLAUDE.md compared with instructions from other repositories

James-RAG-Evol CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
James-RAG-Evol CLAUDE.mdHashevolution/James-RAG-EvolInstructions file211mo agoMITA11,831Claude Code
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode