matecloud: Instructions file for Codex

AGENTS.md

matecloud AGENTS.md is an instructions file for Codex, OpenCode from mateaix/matecloud. It costs 1,958 tokens per session, scanned A, original, Apache-2.0.

A repository instruction file for Codex, documenting MateCloud’s Java and Maven project structure, development commands, services, tests, documentation, and database migrations.

In plain words
What is it for?
Use it when building or testing MateCloud, running individual services, generating API documentation, or applying database migrations.
Why use it?
It gives the coding agent the project-specific context and commands needed to work consistently across a 42-module codebase.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions AGENTS.md; mentions Codex.

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

About the project

MateCloud is a Java-based platform for building multi-tenant business applications from cooperating services, using Spring Cloud Alibaba and domain-driven design. It supports SaaS and low-code development with built-in services for authentication, administration, notifications, messaging, and AI features. The catalogue add-ons operate MateCloud through its command-line and MCP-based tooling.

mateaix/matecloud · 1,710 stars · on GitHub · mate.vip

Reuse

Borrowing it

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

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 matecloud AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/mateaix/matecloud/agents-md/github.svg)](https://agentmods.dev/instructions/mateaix/matecloud/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/mateaix/matecloud/agents-md"><img src="https://agentmods.dev/badge/instructions/mateaix/matecloud/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.

agentmods 80×15 button for matecloud AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/mateaix/matecloud/agents-md"><img src="https://agentmods.dev/badge/instructions/mateaix/matecloud/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,958 This file is loaded in full into every session.
When invoked 1,958 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.01958 $0.01958
Opus 5.5 $0.00783 $0.00783
Sonnet 5.5 $0.00392 $0.00392
Haiku 4.5 $0.00196 $0.00196

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

Security

Grade A, and why

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

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

AGENTS.md · 162 lines

How it starts

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

AGENTS.md

This file provides guidance to Codex (Codex.ai/code) when working with code in this repository.

Project Overview

MateCloud is a DDD microservice scaffold built with Spring Boot 4.0.5 + Spring Cloud 2025.1.1 + Spring Cloud Alibaba + Dubbo 3.3.6. Java 21, MyBatis Plus, Sa-Token auth, Redisson, MapStruct.

Philosophy: minimal common, each module does one thing well, starter = plug-and-play capability.

Development Commands

Backend (Java / Maven)

# Full build (42 modules)
mvn clean install -DskipTests

# Build one module with dependencies
mvn clean install -pl mate-biz/mate-system -am -DskipTests

# Run a service (requires infra: Nacos + MySQL + Redis)
make infra-up                                       # start MySQL/Redis/RabbitMQ/Nacos/MinIO
cd mate-biz/mate-system && mvn spring-boot:run

# Tests
mvn test                                            # unit tests
mvn verify -Pintegration-test                       # integration (Testcontainers)

# Generate API docs (Smart-Doc, not Swagger)
mvn smart-doc:html -pl mate-biz/mate-system

# Database migration
java -jar mate-cli/target/mate-cli.jar db migrate --module mate-system

Frontend (mate-ui)

cd mate-ui
pnpm install                  # pnpm monorepo (turbo orchestration)
pnpm dev                      # Vite dev server → http://localhost:3000

# Default dev credentials (created by AdminUserSeeder on first boot):
#   admin / admin123 / 13800138000

Frontend is a pnpm workspace monorepo: apps/admin (Vue 3 + Vite + Element Plus + TypeScript) with shared packages in packages/{core,hooks,ui,utils}. Vite proxies /api to http://127.0.0.1:9010 (gateway).

Makefile shortcuts

make build                    # mvn clean install -DskipTests
make build-module MODULE=mate-auth
make test                     # unit tests
make verify                   # integration tests
make infra-up / infra-down    # infrastructure only
make up / down                # full stack (docker compose)

Read the full file on GitHub · 162 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. 2mo ago First seen · 162 lines · 1,958 tokens per session scan A d08408eedb61

Subscribe to this mod's changes

matecloud AGENTS.md is an instructions file published in the GitHub repository mateaix/matecloud (1,710 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 1,958 tokens to every session, about $0.0078 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-30.

Related

matecloud AGENTS.md compared with instructions from other repositories

matecloud AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
matecloud AGENTS.mdmateaix/matecloudInstructions file1.7k1mo agoApache-2.0A1,958Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149ktodayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode