butgo-specdrive-lab: Instructions file for Codex

AGENTS.md

butgo-specdrive-lab AGENTS.md is an instructions file for Codex, OpenCode from butgo/butgo-specdrive-lab. It costs 5,729 tokens per session, scanned A, original, MIT.

A top-level AGENTS.md instruction document for the butgo-specdrive project, a repository for managing software work through specifications and AI collaboration. It defines shared working rules, document hierarchy, project scope, and responsibilities.

In plain words
What is it for?
Use it as the repository-wide reference when working on specifications, project documents, scripts, prompts, history rules, or AI collaboration within butgo-specdrive.
Why use it?
It gives people and coding agents a common set of rules for working in the repository. This reduces confusion about which documents govern a task and how changes should be managed.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: runs codex exec, but also the file is AGENTS.md. Also seen: mentions AGENTS.md; mentions Codex.

This is butgo/butgo-specdrive-lab's own configuration. It tells Codex and OpenCode how to work on butgo-specdrive-lab 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 butgo-specdrive-lab configures →

Reuse

Borrowing it

Nothing to install: this file belongs to butgo/butgo-specdrive-lab. 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/butgo/butgo-specdrive-lab/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/butgo/butgo-specdrive-lab

Made for: Codex, OpenCode.

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 butgo-specdrive-lab AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/butgo/butgo-specdrive-lab/agents-md.svg)](https://agentmods.dev/instructions/butgo/butgo-specdrive-lab/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/butgo/butgo-specdrive-lab/agents-md"><img src="https://agentmods.dev/badge/instructions/butgo/butgo-specdrive-lab/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 5,729 This file is loaded in full into every session.
When invoked 5,729 The same file — it is already loaded in full.
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.05729 $0.05729
Opus 5 $0.02864 $0.02864
Sonnet 5 $0.01146 $0.01146
Haiku 4.5 $0.00573 $0.00573

Measured 6d ago against content hash a1028f81c532, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

butgo-specdrive-lab 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 6d 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 · 651 lines

How it starts

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

AGENTS.md

1. 문서 목적

이 문서는 이 저장소 및 그 하위 프로젝트들에 공통 적용되는 **최상위 작업 기준 문서(공통 헌법)**이다.

이 문서는 다음 목적을 가진다.

  • 문서 작업과 구현 작업의 공통 운영 규칙을 정한다.
  • 개발자와 AI의 역할과 책임을 분리한다.
  • 문서 우선 원칙과 구조 우선 원칙을 유지한다.
  • 현재 단계에 필요한 최소 수준의 작업만 진행하도록 범위를 통제한다.
  • 변경 관리와 상태 반영 원칙을 고정한다.
  • 반복 검증을 통해 다른 프로젝트에도 적용 가능한 운영 템플릿의 기준으로 활용한다.

이 문서는 상세 설계 문서나 현재 상태 문서를 대체하지 않는다.
이 문서는 프로젝트 전반의 작업 규칙 / 협업 운영 기준 / AI 운영 기준을 정의한다.


2. 프로젝트 성격

butgo-specdrive는 개발 스펙 문서를 기반으로 AI 협업을 실행하는 도구다.

현재 이 저장소는 다음 성격으로 이해해야 한다.

  • 완성된 SaaS 제품 저장소가 아니다.
  • 현재는 core workflow / engine / repo-local Codex skill 중심 운영체계 검증 단계다.
  • 실제 애플리케이션 프로젝트를 함께 두고 specdrive의 운영 방식을 검증하는 통합 작업 저장소다.
  • 현재 AI 엔진 기준은 Codex다.
  • 현재 실행 기준은 repo-local Codex skill 직접 사용이다.

이 저장소를 일반적인 웹 서비스, 백오피스 SaaS, 협업 플랫폼 UI 프로젝트처럼 해석하지 말아야 한다.


3. 적용 범위

이 문서는 저장소 전체에 공통 적용된다.

예상 적용 대상은 다음과 같다.

  • 루트 수준의 공통 문서
  • docs/specdrive/**
  • docs/projects/**
  • 공통 표준 문서
  • 스크립트, 프롬프트, 히스토리 운영 규칙
  • AI 협업 전반

단, 특정 영역이나 특정 프로젝트에만 필요한 상세 규칙은
각 전용 AGENTS.md 에서 추가로 정의한다.

예:

  • docs/specdrive/AGENTS.md
  • docs/projects/board/AGENTS.md

4. 문서 계층 원칙

이 저장소의 규칙 문서는 다음 계층을 가진다.

4.1 루트 AGENTS.md

전체 프로젝트군에 공통 적용되는 최상위 작업 기준 문서(공통 헌법)

4.2 영역 전용 AGENTS.md

특정 시스템 또는 특정 프로젝트에만 적용되는 추가 규칙

예:

  • docs/specdrive/AGENTS.md
  • docs/projects/board/AGENTS.md

4.3 하위 개별 문서

요구사항, 설계, 구현 계획, 운영 정책, 상태 문서, 히스토리 등 실제 작업 문서


5. 우선순위 규칙

문서 간 규칙이 충돌할 경우 우선순위는 다음과 같다.

  1. 루트 AGENTS.md
  2. 해당 영역의 전용 AGENTS.md
  3. 개별 문서
  4. 작업 메모, 임시 노트, 대화 초안

즉, 하위 문서는 상위 규칙을 위반할 수 없다.
하위 문서는 상위 규칙을 구체화한 내용이어야 하며, 상위 규칙과 충돌해서는 안 된다.


6. 이 저장소를 보는 기본 관점

이 저장소는 크게 다음 축으로 이해한다.

6.1 specdrive

specdrive는 어떻게 협업할 것인가를 다루는 도구 영역이다.

주요 관심사:

  • 문서 기반 AI 협업 흐름
  • 세션 시작 규칙
  • 문맥 복구
  • 프롬프트 실행 흐름
  • 문서 검토와 동기화
  • repo-local Codex skill 구조
  • history / phase / cycle 관리
  • 반복 가능한 작업 절차 정규화

6.2 projects

projects는 무엇을 만들 것인가를 다루는 실제 애플리케이션 작업공간이다.

여기에는 다음이 포함될 수 있다.

  • 요구사항
  • 설계
  • 구현 계획
  • 상태
  • 히스토리
  • 애플리케이션별 결정 사항
  • 검증용 실제 프로그램 또는 실제 프로젝트 문서

Read the full file on GitHub · 651 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. 6d ago First seen · 651 lines · 5,729 tokens per session scan A a1028f81c532

Subscribe to this mod's changes

butgo-specdrive-lab AGENTS.md is an instructions file published in the GitHub repository butgo/butgo-specdrive-lab (1 stars, last pushed 4mo ago), licensed MIT. It adds 5,729 tokens to every session, about $0.0286 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.

Related

Other instructions, from other repositories

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,182 tokens

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

microsoft/vscode · 6,785 tokens

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.

vercel/next.js · 7,296 tokens

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.

langchain-ai/langchain · 4,469 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens