Wegent AGENTS.md

Contributor instructions for Wegent, an AI-native system for defining, organizing, and running teams of AI agents.

In plain words
What is it for?
Use them when modifying Wegent services, interfaces, agent execution, document processing, shared code, or bilingual documentation.
Why use it?
They map the backend, frontend, desktop, execution, chat, and document-processing parts so contributors can change the correct area and follow the project's engineering rules.

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

Made for: Codex, OpenCode.

Per session 1,396 This file is loaded in full into every session.
When invoked 1,396 The same file — it is already loaded in full.
Security scan C 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.01396 $0.01396
Opus 5 $0.00698 $0.00698
Sonnet 5 $0.00279 $0.00279
Haiku 4.5 $0.00140 $0.00140

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

Security

Grade C, and why

Wegent AGENTS.md scanned grade C 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 3d 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.

Hidden instructionshighPrompt injection

Directives inside HTML comments, invisible characters or bidirectional overrides are read by the model and not by the person reviewing the file.

<!-- prettier-ignore -->
AGENTS.md · 100 lines

How it starts

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

Wegent contributor guide

Wegent is an AI-native operating system for defining, organizing, and running agent teams. Keep the system simpler after every change: reuse existing abstractions, remove obsolete paths, and fix the primary flow rather than hiding defects behind fallbacks.

Repository map

Area Technology Responsibility
backend/ FastAPI, SQLAlchemy, MySQL REST API and business logic
frontend/ Next.js, React, TypeScript Main web product
wework/ Electron, Vite, React, TypeScript Desktop workbench and local coding experience
executor/, executor_manager/ Python, Docker Agent execution and orchestration
chat_shell/ FastAPI, LangGraph Lightweight chat runtime
knowledge_runtime/, knowledge_doc_converter/ FastAPI, Celery RAG and document conversion
shared/ Python Shared utilities, models, cryptography and telemetry

Use docs/en/ and docs/zh/ for detailed architecture and guides. Keep this file limited to durable contributor rules. New documentation needs frontmatter with sidebar_position; write Chinese first, then English.

Scoped instructions

  • Before modifying wework/**, read and follow wework/AGENTS.md. It contains the desktop UI, local runtime, i18n, and Electron verification rules.
  • Before modifying frontend/**, read and follow frontend/AGENTS.md. It contains web-frontend state, responsive UI, and i18n rules.
  • Add module-specific instructions beside a module only when they cannot be expressed as a repository-wide rule.

Domain model

Ghost (prompt, MCP servers, skills)
  -> Bot (Ghost + Shell + optional Model)
  -> Team (Bots + collaboration mode)
  -> Task (Team + Workspace)

Code uses CRD terms. In Chinese UI, Team is “智能体” and Bot is “机器人”; English UI calls them Agent and Bot.

  • A Kind resource is identified by namespace, name, and user_id; always query all three.
  • Task and Workspace use TaskResource in tasks; other CRDs use Kind in kinds.
  • Shell types: ClaudeCode, Agno, Dify, and Chat.

Read the full file on GitHub · 100 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. 3d ago First seen · 100 lines · 1,396 tokens per session scan C dcb84150643e

Subscribe to this mod's changes

Wegent AGENTS.md is an instructions file published in the GitHub repository wecode-ai/Wegent (747 stars, last pushed 3d ago), licensed Apache-2.0. It adds 1,396 tokens to every session, about $0.0070 per session on Opus 5. A static security scan graded it C with 1 finding (hidden instructions). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.