Borrowing it
Nothing to install: this file belongs to kohj1018/agentic-dev-harness. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/kohj1018/agentic-dev-harness/main/AGENTS.mdgit clone --depth 1 https://github.com/kohj1018/agentic-dev-harnessWrote 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.
[](https://agentmods.dev/instructions/kohj1018/agentic-dev-harness/agents-md)<a href="https://agentmods.dev/instructions/kohj1018/agentic-dev-harness/agents-md"><img src="https://agentmods.dev/badge/instructions/kohj1018/agentic-dev-harness/agents-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.
<a href="https://agentmods.dev/instructions/kohj1018/agentic-dev-harness/agents-md"><img src="https://agentmods.dev/badge/instructions/kohj1018/agentic-dev-harness/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.01495 | $0.01495 |
| Opus 5.5 | $0.00598 | $0.00598 |
| Sonnet 5.5 | $0.00299 | $0.00299 |
| Haiku 4.5 | $0.00150 | $0.00150 |
Grade A, and why
agentic-dev-harness AGENTS.md 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 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.
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.
How it starts
The opening of the file, as written. The whole thing — 58 lines — stays where its author put it; the contents beside it link to each section on GitHub.
프로젝트 지침
목적
- 이 저장소는 여러 AI coding agent (Claude Code, OpenAI Codex 등)에서 동일하게 동작하는 문서 중심 개발 보일러플레이트다.
- 새 프로젝트를 시작할 때 이 구조를 복제해 빠르게 적용할 수 있어야 한다.
- 중요한 단계마다 해당 계층의 문서를 먼저 갱신한 뒤 다음 단계로 진행한다.
핵심 행동 규율
- ✅ 상위 문서 없이 하위 문서를 먼저 만들지 않는다.
- 🚫
.env,secrets/, 서명키·배포 인증서·service account 키 같은 민감 파일은 읽지도 쓰지도 않는다. - ✅ 작업 범위와 비범위를 명확히 적고, 범위 밖 변경은 하지 않는다.
- ✅ 흩어진 임시 메모보다 정해진 위치의 문서를 갱신한다.
- ⚠️ 사실, 가정, 열린 질문을 구분해서 적는다. 검증 가능한 표현을 우선한다.
- ✅ 커밋은 작고 논리적인 단위로 나눈다. 커밋 전에 관련 workitem 문서와 구현 범위가 일치하는지 확인한다.
단순성·YAGNI (구현 시 항상 적용)
- 요구한 범위만 구현한다. 추측성 추상화·미래 대비 코드·계획에 없는 헬퍼는 만들지 않는다.
- 동일 패턴이 3회 이상 반복될 때까지는 추출하지 않는다. 비슷한 코드 3줄이 premature abstraction보다 낫다.
- 시스템 경계(외부 입력, 외부 API)에서만 입력 검증·에러 핸들링을 둔다. 내부 호출에는 두지 않는다.
- WHY가 비자명할 때만 주석을 단다(숨은 제약, 미묘한 invariant, 특정 버그 우회). WHAT 주석은 좋은 식별자 이름으로 대체한다.
- backwards-compat shim, feature flag, 사용 안 되는 변수의
_rename 같은 호환 hack을 만들지 않는다. 정말 안 쓰면 삭제한다. - 변경한 모든 줄은 task의 AC 또는 명시 요청으로 거꾸로 추적 가능해야 한다. 인접 코드 개선·무관 포맷팅·기존 스타일 무시·pre-existing dead code 삭제는 금지 (ADR-006#amend-1).
정책 근거: ADR-006-simplicity-and-architecture.md.
Claude Code plan 모드
Claude Code의 빌트인 plan 모드(Shift+Tab)는 사용자 자율 도구다. 본 보일러플레이트의 lifecycle은 plan 모드를 의무화하지 않으며 산출물 경로(plansDirectory)도 강제하지 않는다. Codex 사용자도 동등한 흐름을 갖는다 (ADR-010, ADR-024).
기본 자동화 직접 지원 범위
보일러플레이트의 기본 자동화·문서 템플릿이 직접 다루는 스택은 web frontend / API server / CLI / monorepo / Supabase 통합 / Flutter(Android·iOS) 6종이다. 그 외(iOS Swift / Android Kotlin / RN / ML / embedded / game / desktop)는 ADR-031의 기본 범위 결정을 supersede하는 project ADR을 발행하는 경로 (ADR-031#amend-1, ADR-059).
TDD 기본 (구현 시 디폴트)
구현은 Red → Green → Refactor 3 phase 사이클을 디폴트로 따른다. opt-out은 task 문서의 ## 6-2. TDD opt-out에 사유와 follow-up이 모두 있을 때만. 정책 근거: ADR-009-tdd-default.md.
깊은 운영 원칙은 다음 문서를 따른다
- 문서 계층과 산출물 인벤토리
- 시각 디자인 (UI 프로젝트 한정)
- 인터페이스 결정 책임 분배 + DESIGN.md 내용 계약 v2 (DESIGN.md UI + ARCH 7-1~7-5 cross-surface enforcement, ADR-073 D8)
- 워크플로우 + 문서 상태 전이
- 기획 결정 마감 + 마일스톤 봉인 (결정 원장·authority·contract-ready·seal — 열린 질문을 문서에 남기지 않는다)
- 마일스톤 층 폐쇄 경계 + 졸업 계약 (산하 전 task done ⇒ task 문서·status·report 불변 — 예외는
## 8의 AC receipt 2종, 재개방 없음) - 에이전트 실행 전략 + 위임 트리거
- Guardrail 운영 원칙
- Optional MCP Connectors 기록·사용 강제
- 새 프로젝트 시작 체크리스트
- Code-as-Agent-Harness 패러다임 + Harness Mutation Contract
- ADR 인덱스
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.
- 1mo ago Changed · +5 tokens per session 72bbc5bb995a
- 2mo ago First seen · 58 lines · 1,490 tokens per session scan A 68e99a072776
agentic-dev-harness AGENTS.md is an instructions file published in the GitHub repository kohj1018/agentic-dev-harness (2 stars, last pushed 1mo ago), licensed MIT. It adds 1,495 tokens to every session, about $0.0060 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-08-31.
Other instructions, from other repositories
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode copilot-instructions.md
Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).
deno copilot-instructions.md
Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.