Circuit AGENTS.md

Project instructions for Circuit, covering shared slash-command rules, compatibility between Claude and Codex, planning mode, commits, and GitHub accounts.

In plain words
What is it for?
Use them when running project workflows, working in plan mode, maintaining Claude or Codex files, or preparing commits and pull requests.
Why use it?
They keep workflows separate where the two coding agents differ and define how changes should be planned and committed.

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/circui-try/circuit/agents-md
Clone the repo
git clone --depth 1 https://github.com/CIrcui-try/Circuit

Made for: Codex, OpenCode.

Per session 772 This file is loaded in full into every session.
When invoked 772 The same file — it is already loaded in full.
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.00772 $0.00772
Opus 5 $0.00386 $0.00386
Sonnet 5 $0.00154 $0.00154
Haiku 4.5 $0.00077 $0.00077

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

Security

Grade A, and why

Circuit 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 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.

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.

AGENTS.md · 31 lines

What it actually says

슬래시 커맨드 공통 규칙

.claude/commands/, .claude/skills/, .codex/commands/, .codex/skills/, .agents/skills/ 안의 모든 워크플로에 공통으로 적용한다. 개별 커맨드와 스킬은 이 규칙을 다시 명시하지 않는다.

Claude / Codex 양립

  • .claude/commands/ 는 Claude 전용 슬래시 커맨드다. .claude/state, mcp__linear-server__*, TodoWrite, AskUserQuestion, ExitPlanMode 같은 Claude 전용 표현을 Codex 방식으로 바꾸지 않는다.
  • .claude/skills/ 는 Circuit 앱의 Claude 스킬 디스커버리용 미러다. Claude 커맨드와 같은 런타임 표현을 유지한다.
  • .codex/commands/ 는 Codex 슬래시 커맨드 전용이다. .codex/state 와 Codex에서 사용할 수 있는 도구명을 기준으로 유지한다.
  • .codex/skills/ 는 Circuit 앱의 Codex 스킬 디스커버리용 미러다. .agents/skills/ 와 같은 Codex 런타임 표현을 유지한다.
  • .agents/skills/ 는 Codex 프로젝트 스킬용 원본이다. Claude 커맨드를 덮어쓰거나 대체하지 않고, Codex 앱에서 재사용할 워크플로 지침으로 관리한다.
  • 같은 워크플로 이름을 공유하더라도 Claude와 Codex의 상태 디렉터리, MCP 서버명, 도구명은 런타임별로 분리한다.

Plan mode 호환

Plan mode 가 활성화된 상태에서 워크플로가 호출되어도 거부하지 말 것. Plan mode 의 정의는 "계획만 세우고 승인 후 실행" 이므로 다음 순서로 처리한다:

  1. 읽기 전용 도구로 커맨드가 실제로 수행할 작업 (워크트리 경로, 변경 파일, 커밋 단위 후보, 실행할 명령) 을 충분히 파악한다.
  2. plan 파일에 그 내용을 구체적으로 정리한다. "plan mode 라서 못 한다" 같은 답변은 금지.
  3. Claude 에서는 ExitPlanMode, Codex 에서는 Codex Plan mode 승인 흐름으로 승인 요청한다. 사용자가 plan mode 를 빠져나오면 정리한 계획대로 실제 절차를 그대로 이어 수행한다.

커밋 / GitHub 계정

  • 개인별 커밋 author / committer / GitHub CLI active account 정책은 공개 추적 파일에 기록하지 않는다. 필요한 경우 AGENTS.local.md 같은 ignored 로컬 파일이나 사용자 홈 디렉터리 설정에 둔다.
  • PR 제목, PR 본문, 커밋 메시지는 반드시 영어로 작성한다. 한국어를 쓰지 않는다.
  • 커밋 메시지에 Co-Authored-By 트레일러를 추가하지 않는다.
  • GitHub CLI(gh) 를 실제로 호출하는 워크플로에서는 첫 gh 명령 직전에만 gh-auth-check 스킬 절차로 로그인 상태를 확인한다. 로그인되어 있지 않으면 작업을 중단하고 사용자에게 알린다.
  • 앱 시작, 저장소 읽기, 로컬 구현, 테스트, 커밋-only 작업처럼 gh 를 호출하지 않는 흐름에서는 gh-auth-check 를 선제 실행하지 않는다.

모든 답변은 한국어로 합니다

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 · 31 lines · 772 tokens per session scan A 992bb41198ab

Subscribe to this mod's changes

Circuit AGENTS.md is an instructions file published in the GitHub repository CIrcui-try/Circuit (5 stars, last pushed 3mo ago), licensed MIT. It adds 772 tokens to every session, about $0.0039 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.