AgentDeck AGENTS.md

Project instructions for AgentDeck, a tool that works with several coding agents such as Claude Code, Codex, OpenCode, and Antigravity. They explain which guidance files and workflows each agent reads.

In plain words
What is it for?
Use them when working on AgentDeck, especially before adding features, changing its structure, debugging, or deciding how an agent should follow project workflows.
Why use it?
They prevent agents from using the wrong instructions or assuming that every agent discovers project workflows automatically. They also require checking the project's main guidance before making changes.

Instructions file for CodexOpenCode

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 instructions/puritysb/agentdeck/agents-md
Clone the repo
git clone --depth 1 https://github.com/puritysb/AgentDeck

Made for: Codex, OpenCode.

Per session 1,520 This file is loaded in full into every session.
When invoked 1,520 The same file — it is already loaded in full.
Security scan B 1 finding. 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.01520 $0.01520
Opus 5 $0.00760 $0.00760
Sonnet 5 $0.00304 $0.00304
Haiku 4.5 $0.00152 $0.00152

Measured 2d ago against content hash 7115b1211ea5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

AgentDeck AGENTS.md scanned grade B 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 2d 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.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

- **Hook 포맷 (CRITICAL)**: Claude Code v2.1+ hook 은 3단계 중첩 포맷이 필수이며 구 flat 포맷은 조용히 실패합니다. Codex 는 `~/.codex/config.toml` lifecycle hook 을 씁니다. 자세한 규칙·자동 마이그레이션은 `CLAUDE.md` "Key Conventions" 의 Hook format 항목 참조(여기서 복제하지 말
AGENTS.md · 40 lines

How it starts

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

AGENTS.md

프로젝트 지침 (Antigravity & AI Agents)

이 프로젝트(AgentDeck)에서 작업할 때 모든 AI 에이전트(Claude Code, Codex, OpenCode, Antigravity 포함)는 다음 지침을 반드시 따르십시오.

0. 지원 에이전트 / Supported agents

이 레포는 Claude Code · Codex · OpenCode · Antigravity 를 오가며 개발합니다. 각 에이전트의 진입 방식, 읽는 파일, 자동 발견 범위, 한계는 docs/agent-harness.md 의 매트릭스가 단일 기준입니다. 핵심:

  • Claude Code / Codex = 1급 저작 에이전트. 둘 다 hook + skill 자동 발견을 가집니다. Skill 의 정본은 .agents/skills/<name>/SKILL.md 이고, .claude/skills/*.md 는 그 정본을 가리키는 얇은 포인터일 뿐입니다(절차 내용을 복붙/편집하지 마십시오 — drift 방지).
  • OpenCode = 제품 세션 타입으로는 완전 지원(PTY + SSE)이지만, 이 레포를 편집하는 개발 도구로서는 hook/skill 자동 발견이 없습니다. AGENTS.mdCLAUDE.md 를 읽되, 절차가 필요하면 .agents/workflows/<name>.md 경로를 직접 지정해서 사용하십시오.
  • Antigravity = 지시 파일(AGENTS.mdCLAUDE.md)만 읽습니다. 세션 관측·hook·skill 자동 발견이 없으며, Apple 앱은 Antigravity 의 사용량/크레딧 통계만 읽을 뿐 코딩 세션을 관측하지 않습니다. skill 자동 실행을 기대하지 말고 워크플로우 파일 경로를 직접 인용하십시오.

1. 컨텍스트 및 아키텍처 파악 (필수)

  • 모든 작업(특히 새로운 기능 추가, 구조 변경, 디버깅) 시작 전에 반드시 CLAUDE.md를 먼저 읽으십시오.
  • DEVELOPMENT_LOG.md는 전체 파일을 매번 통독하지 마십시오. 이 파일은 최근 2개월분만 유지하고, 그 이전 기록은 월별로 docs/devlog/<YYYY-MM>.md 에 아카이브되어 있습니다(인덱스: docs/devlog/README.md). 먼저 최신 항목(파일 상단 일부)을 확인한 뒤, 작업 대상 키워드/파일명으로 rg 검색하되 더 오래된 기록이 필요하면 해당 월 아카이브 파일만 검색하십시오(아카이브 전체를 한꺼번에 로드하지 말 것). 예: rg -n "Codex|hooks|config.toml" DEVELOPMENT_LOG.md docs/devlog/2026-04.md.
  • CLAUDE.md는 프로젝트 아키텍처, 브릿지-플러그인 통신 규약, 포트 설정, UI/UX 비전(특히 Android E-ink 최적화 규칙)을 담고 있는 **단일 진실 공급원(SSOT)**입니다.
  • 정보를 여러 문서로 분산시키지 마십시오. 만약 프로젝트의 핵심 구조적 변경이 발생하면, 이 정보들을 CLAUDE.mdDEVELOPMENT_LOG.md에 업데이트하여 최신 상태로 유지해야 합니다.

2. 워크플로우 자동화 활용

  • 빌드, 환경 설정 등의 반복 작업은 직접 스크립트 명령어를 유추해서 실행하지 말고, .agents/workflows/ 디렉토리에 정의된 워크플로우를 사용하십시오.
    • 예: 안드로이드 APK 빌드 (build-android.md), 터미널 환경 세션 시작 등
  • .agents/skills/의 repo-scoped skills 가 절차의 정본입니다. workflow 파일은 사람이 읽는 원본 절차이고, skill 은 자동 발견/호출을 위한 실행 표면입니다. Codex 는 .agents/skills/ 를 자동 발견하고, Claude Code 는 .claude/skills/ 의 포인터를 통해 같은 정본에 도달합니다.
  • 세션 인계: /clear·/new·작업 전환·다른 에이전트로 넘기기 전에 session-end skill 을 실행하십시오.

Read the full file on GitHub · 40 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. 2d ago First seen · 40 lines · 1,520 tokens per session scan B 7115b1211ea5

Subscribe to this mod's changes

AgentDeck AGENTS.md is an instructions file published in the GitHub repository puritysb/AgentDeck (212 stars, last pushed 2d ago), licensed MIT. It adds 1,520 tokens to every session, about $0.0076 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.