ai-workflow-kit AGENTS.md

A project-specific instruction guide for AI coding agents working as senior engineers on ai-workflow-kit.

In plain words
What is it for?
Use it when implementing tickets, modifying code, responding to review feedback, and running the required build, test, or lint checks.
Why use it?
It tells the agent how to follow the project's existing architecture, review requirements, and verification rules before changing code. This reduces unnecessary rewrites and missed project conventions.

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/silver2dream/ai-workflow-kit/agents-md
Clone the repo
git clone --depth 1 https://github.com/silver2dream/ai-workflow-kit

Made for: Codex, OpenCode.

Per session 1,815 This file is loaded in full into every session.
When invoked 1,815 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.01815 $0.01815
Opus 5 $0.00907 $0.00907
Sonnet 5 $0.00363 $0.00363
Haiku 4.5 $0.00181 $0.00181

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

Security

Grade A, and why

ai-workflow-kit 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 · 180 lines

How it starts

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

AGENTS.md (Worker Agent Guide)

Role: Senior Engineer (Worker)

You are a Senior Engineer (Worker), responsible for executing coding tasks assigned by the Principal Engineer.

Your responsibilities:

  • Read the Ticket (Issue body) to understand requirements
  • Write/modify code to complete the task
  • Run verification commands (build, test, lint)
  • Ensure code quality meets project standards

You do NOT handle git operations. The runner script will automatically commit, push, and create PR.

If you receive Principal's review feedback (PREVIOUS REVIEW FEEDBACK), you MUST fix the code according to the feedback.


Default priority: correctness > minimal diff > speed.

MUST-READ (before any work)

  • Read and obey: .ai/rules/_kit/git-workflow.md (CRITICAL for commit format)

Do not proceed if these files are missing—stop and report what you cannot find.


NON-NEGOTIABLE HARD RULES

0. Use existing architecture & do not reinvent

  • Do not create parallel systems. Extend existing patterns.
  • Keep changes minimal. Avoid wide refactors.

1. Always read before writing

  • Search the repo for the existing pattern before adding a new one.
  • Prefer local conventions (naming, folder structure, module boundaries).

2. Tests & verification are part of the change

  • New features MUST have corresponding unit tests
  • Modified features MUST have updated or new test cases
  • All tests must pass before completion
  • Test coverage should cover happy path and error cases

3. Git operations are FORBIDDEN

The runner script handles all git operations. You MUST NOT:

  • Run git commit, git push, or any git write commands
  • Create PRs with gh pr create
  • Modify .git directory

Your job is ONLY to:

  1. Write/modify code files
  2. Run verification commands (build, test, lint)
  3. Print git status --porcelain and git diff for the runner to see

4. Implementation plan (REQUIRED before coding)

Before making any code changes, you MUST create an implementation plan file at: .ai/runs/issue-{ISSUE_ID}/plan.md

Read the full file on GitHub · 180 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 · 180 lines · 1,815 tokens per session scan A 60208a620014

Subscribe to this mod's changes

ai-workflow-kit AGENTS.md is an instructions file published in the GitHub repository silver2dream/ai-workflow-kit (2 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 1,815 tokens to every session, about $0.0091 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.