mica-admin AGENTS.md

mica-admin AGENTS.md is an instructions file for Codex, OpenCode from lets-mica/mica-admin. It costs 3,190 tokens per session, scanned A, original, Apache-2.0.

Project instructions for a low-code permission-management platform with Java, Spring Boot, Vue, Vite, and a mobile app. It describes the repository’s separate backend, web, mobile, and documentation areas, plus rules for making changes safely.

In plain words
What is it for?
Understanding the monorepo layout, using the listed build and test commands, respecting module boundaries, and checking before renaming fields, changing schemas, deleting files, committing, or pushing changes.
Why use it?
A repository containing several related applications needs clear boundaries and conventions. These instructions prevent accidental commits, renames, schema changes, or cross-module confusion.

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/lets-mica/mica-admin/agents-md
Clone the repo
git clone --depth 1 https://github.com/lets-mica/mica-admin

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 mica-admin AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/lets-mica/mica-admin/agents-md.svg)](https://agentmods.dev/instructions/lets-mica/mica-admin/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/lets-mica/mica-admin/agents-md"><img src="https://agentmods.dev/badge/instructions/lets-mica/mica-admin/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 3,190 This file is loaded in full into every session.
When invoked 3,190 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.03190 $0.03190
Opus 5 $0.01595 $0.01595
Sonnet 5 $0.00638 $0.00638
Haiku 4.5 $0.00319 $0.00319

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

Security

Grade A, and why

mica-admin 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 4d 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 · 177 lines

How it starts

The opening of the file, as written. The whole thing — 177 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.

项目概述

mica-admin 是基于 mica 工具集的低代码权限管理平台,使用 Maven、Spring Boot 4.1、Spring Security、MyBatis-Plus(后端)+ Vben Admin 5.x(前端)+ uniapp x(移动 App)。

仓库根目录结构(mono-repo,单 git 仓库):

目录 说明 技术栈
mica-admin-server/ Spring Boot 后端(Java 17+) Maven 模块
mica-admin-web/ Web 管理端(Vben Admin 5.x 本地化) Vite + Vue 3 + Naive UI
mica-admin-uniapp/ 移动 App(uniapp x) uniapp x + Vue 3 + TypeScript + Pinia
docs/ 设计文档 -

mica-admin-uniapp/ 不进 Maven:它是独立的 npm/pnpm 工程,与 mica-admin-web/ 平级。 三者放在同一 git 仓库是为了 AI 编码时能"看见完整上下文",便于跨模块协作。

工作准则(必读)

  • ❌ 禁止擅自 git commit / git push。所有变更默认保持 M / A 状态,等用户明确说"提交"、"commit"、"push" 时再执行。需要提交时,先把 git status 摘要给用户看一眼。
  • ❌ 禁止擅自重命名既有字段。即使觉得"更合理"也不动,字段名/列名属于业务决策,改之前必须先和用户确认。
  • ✅ 改动默认只改类型,不改命名(除非用户明确要求)。
  • 命名 / 删文件 / 改 schema 之前,先用 AskUserQuestion 确认,不要先斩后奏。

构建命令

后端 (mica-admin-server)

从仓库根目录执行:

# 默认 dev profile,跳过前端构建
mvn package
# 生产构建:触发 pnpm install + pnpm build:prod,把 dist 打入 META-INF/resources
mvn clean package -Pprod -U -Dmaven.test.skip=true

# 单测
mvn test -Dtest=ClassName#methodName -DfailIfNoTests=false

# 本地启动
mvn spring-boot:run -Dspring-boot.run.profiles=dev

Maven profile 行为:

  • dev(默认激活):skipNpmBuild=true,不构建前端。
  • prodskipNpmBuild=false,通过 exec-maven-plugin 触发前端构建,并把 mica-admin-web/dist 复制到 META-INF/resources,与后端 jar 合并。

前端 (mica-admin-web)

cd mica-admin-web
pnpm install
pnpm dev               # Vite dev server,端口 5888,/api 代理到 http://localhost:8080
pnpm typecheck         # vue-tsc --noEmit --skipLibCheck
pnpm lint              # eslint --fix
pnpm build             # 类型检查 + 生产构建
pnpm build:prod        # 仅打包,跳过类型检查(Maven prod profile 调的就是这个)
pnpm build:analyze     # 构建并分析包体积

后端架构 (mica-admin-server)

主包:net.dreamlu.mica.admin,源码 src/main/java/

Read the full file on GitHub · 177 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. 4d ago First seen · 177 lines · 3,190 tokens per session scan A d78776380bf3

Subscribe to this mod's changes

mica-admin AGENTS.md is an instructions file published in the GitHub repository lets-mica/mica-admin (5 stars, last pushed 14d ago), licensed Apache-2.0. It adds 3,190 tokens to every session, about $0.0159 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.