What is clix-dev-flow AGENTS.md?

A set of instructions for AI agents working on the Dev Flow extension project. The extension’s files include commands, documentation, configuration, and runtime task data.

It helps with developing, documenting, reviewing, and maintaining the Dev Flow extension, including its commands and project files.

It gives an agent project-specific guidance so it can understand the codebase and follow the project’s development workflow.

How shrwnsan/clix-dev-flow configures Codex and OpenCode

Reuse

Borrowing it

Nothing to install: this file belongs to shrwnsan/clix-dev-flow. 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/shrwnsan/clix-dev-flow/main/AGENTS.md

Clone the repo

git clone --depth 1 https://github.com/shrwnsan/clix-dev-flow

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.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/shrwnsan/clix-dev-flow/agents-md/github.svg)](https://agentmods.dev/instructions/shrwnsan/clix-dev-flow/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/shrwnsan/clix-dev-flow/agents-md"><img src="https://agentmods.dev/badge/instructions/shrwnsan/clix-dev-flow/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.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/shrwnsan/clix-dev-flow/agents-md"><img src="https://agentmods.dev/badge/instructions/shrwnsan/clix-dev-flow/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 753 This file is loaded in full into every session.

When invoked 753 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.

Model	Per session	Once invoked
Fable 5.1	$0.00753	$0.00753
Opus 5.5	$0.00301	$0.00301
Sonnet 5.5	$0.00151	$0.00151
Haiku 4.5	$0.00075	$0.00075

Measured 2mo ago against content hash b10327b340b5, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

clix-dev-flow 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 2mo 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 · 99 lines

How it starts

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

AI Agent Guidelines

This document provides essential guidelines for AI agents working with the Dev Flow extension project development and maintenance.

Purpose: This file documents how AI agents should interact with and contribute to this Dev Flow project itself (development, documentation, code reviews, etc.).

Extension Version: 1.1.0

Related Documentation:

GEMINI.md - Gemini CLI extension context (loaded automatically by Gemini CLI)
README.md - User-facing documentation and command reference

Project Structure

dev-flow/
├── README.md                    # User-facing documentation
├── AGENTS.md                    # This file - AI agent guidelines
├── GEMINI.md                    # Gemini CLI extension context
├── EXAMPLES.md                  # Usage examples
├── CHANGELOG.md                 # Version history
├── NOTICE                       # Attribution notice
├── gemini-extension.json        # Extension configuration
├── commands/dev/                # Command definitions (.toml files)
└── tasks/                       # Created during runtime (not tracked)

Core Extension Workflow

The Dev Flow extension follows a simple three-step process for users:

Plan (/dev:create-prd) - Generate feature planning documents
Design (/dev:generate-tasks) - Create task breakdowns
Build (/dev:process-task-list) - Execute implementation

Agent Guidelines for Project Work

When Contributing to This Project

Focus on maintaining simplicity - this is intentionally a lightweight CLI extension
Keep documentation clear and concise
Test changes thoroughly before committing
Follow established patterns in the codebase

Documentation Updates

Update README.md for user-facing changes
Update GEMINI.md for extension context changes
Update AGENTS.md when changing how agents should work with the project
Keep CHANGELOG.md updated with version changes

Code Reviews and Development

Prioritize user experience and simplicity
Ensure commands work reliably across different environments
Test with actual Gemini CLI installation when possible
Verify documentation accuracy after changes

Read the full file on GitHub · 99 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.

2mo ago First seen · 99 lines · 753 tokens per session scan A b10327b340b5

Subscribe to this mod's changes

clix-dev-flow AGENTS.md is an instructions file published in the GitHub repository shrwnsan/clix-dev-flow (10 stars, last pushed 1y ago), licensed Apache-2.0. It adds 753 tokens to every session, about $0.0030 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.

clix-dev-flow AGENTS.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
clix-dev-flow AGENTS.mdshrwnsan/clix-dev-flow	Instructions file	10	1y ago	Apache-2.0	A	753	Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	yesterday	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

clix-dev-flow: Instructions file for Codex