architecture-lightweight

architecture-lightweight is a cursor rule for Cursor from mywand/cusrsor-do-it. It costs 0 tokens per session (6,791 once invoked), scanned A, original, Apache-2.0.

A lightweight architecture-document template for small projects, covering the system, structure, key flows, data, interfaces, technology choices, and other essentials.

In plain words
What is it for?
Use it to document a new project, guide development and testing, or prepare for a technical review. It is intended for teams of up to 10 people and projects with no more than five services.
Why use it?
It gives a small team a clear way to agree on how a project should work without creating a large documentation burden.

Cursor rule for Cursor

Written for Cursor: installed under .cursor/.

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 rules/mywand/cusrsor-do-it/architecture-lightweight
Clone the repo
git clone --depth 1 https://github.com/mywand/cusrsor-do-it

Made for: Cursor.

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 architecture-lightweight

README.md
[![agentmods](https://agentmods.dev/badge/rules/mywand/cusrsor-do-it/architecture-lightweight.svg)](https://agentmods.dev/rules/mywand/cusrsor-do-it/architecture-lightweight)
Your own site
<a href="https://agentmods.dev/rules/mywand/cusrsor-do-it/architecture-lightweight"><img src="https://agentmods.dev/badge/rules/mywand/cusrsor-do-it/architecture-lightweight.svg" alt="Measured on agentmods" height="20"></a>
Per session 0 Nothing until a file matches its globs; then the whole rule loads.
When invoked 6,791 The whole file, excluding the scripts and references it only reads on demand.
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.1 $0.00000 $0.06791
Opus 5 $0.00000 $0.03395
Sonnet 5 $0.00000 $0.01358
Haiku 4.5 $0.00000 $0.00679

Measured 5d ago against content hash accd3a85b994, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

architecture-lightweight 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 5d 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.

.cursor/rules/docs/architecture-lightweight.mdc · 747 lines

How it starts

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

最近更新: 2025-10-11

轻量级架构文档模板

适用于中小型项目的精简架构文档模板,30分钟完成基础版,2小时完成完整版。

1. 适用场景

1.1 项目规模

维度 范围 说明
团队规模 ≤ 10人 单团队或小型协作团队
开发周期 ≤ 6个月 MVP 或阶段性交付
服务数量 ≤ 5个 单体应用或简单微服务
数据源 ≤ 3个 主库 + 缓存 + 消息队列
外部依赖 ≤ 8个 第三方服务和内部服务

1.2 何时使用

✅ 适合使用

  • 快速启动的新项目
  • 需要快速对齐技术方案
  • 团队规模较小,沟通成本低
  • 迭代速度快,文档需要灵活

❌ 不适合使用

  • 大型分布式系统(使用完整架构文档)
  • 多团队协作项目(需要更详细的接口定义)
  • 高合规要求项目(需要完整的文档体系)

1.3 升级到完整版的时机

出现以下情况建议升级:

  • 团队规模 > 10人
  • 服务数量 > 5个
  • 外部依赖 > 8个
  • 需要详细的组件设计和方法签名
  • 跨团队协作频繁

参考:module-design-guidelines.mdc(完整版模板)

2. 快速填写指南

2.1 30分钟快速版

适用场景:项目启动初期,快速对齐基本方案

必填章节

  1. ✅ 系统概述(10分钟)
  2. ✅ 整体架构(10分钟)
  3. ✅ 核心流程(10分钟)

输出:PPT 级别的架构说明,支持团队讨论

2.2 2小时标准版

适用场景:开发启动前,需要指导实施

必填章节

  1. ✅ 系统概述
  2. ✅ 整体架构
  3. ✅ 核心流程
  4. ✅ 数据设计
  5. ✅ 接口设计
  6. ✅ 技术选型
  7. ✅ 非功能需求

输出:实施级文档,支持开发和测试

2.3 1天完整版

适用场景:评审前或交付时

全部章节:标准版 + 部署架构 + 风险对策 + 后续规划

输出:评审级文档,支持技术评审和决策

3. 文档模板

3.1 文档头部

# <系统名称> 架构说明

**项目类型**: Web应用 / 移动应用 / 微服务 / 数据平台  
**文档版本**: v1.0  
**文档状态**: 草稿 / 评审中 / 已批准  
**负责人**: 姓名  
**创建日期**: YYYY-MM-DD  
**最后更新**: YYYY-MM-DD  

## 变更记录
| 版本 | 日期 | 变更内容 | 变更人 |
|------|------|----------|--------|
| v1.0 | YYYY-MM-DD | 初始版本 | 姓名 |

3.2 章节结构


① 系统概述

1.1 业务目标

问题描述

  • 解决什么业务痛点?
  • 目标用户是谁?
  • 核心价值是什么?

量化目标

  • 用户规模:预计日活 / 月活
  • 性能要求:TPS / QPS / 响应时间
  • 业务指标:转化率 / 交易量等

示例

### 1.1 业务目标
**问题描述**:
当前订单处理系统响应慢(平均 5秒),影响用户体验,导致订单转化率下降 15%。

**量化目标**:
- 支持 1000 QPS 订单查询
- 订单处理响应时间 < 500ms
- 系统可用性 99.9%
- 日订单量支持 10万单

1.2 用户与场景

用户角色 核心场景 使用频率 重要性
普通用户 浏览商品、下单 高频 P0
商家 管理商品、处理订单 中频 P0
运营 数据分析、活动配置 低频 P1
管理员 系统配置、权限管理 低频 P1

1.3 核心功能

P0(核心必需)

  • 用户注册登录
  • 商品浏览和搜索
  • 订单下单和支付
  • 订单状态查询

P1(重要)

  • 购物车管理
  • 收藏和历史记录
  • 优惠券和促销
  • 订单评价

P2(增强)

  • 积分系统
  • 推荐系统
  • 数据分析

1.4 技术栈

层次 技术选型 版本 选择理由
前端 Vue 3 + TypeScript 3.4+ 团队熟悉,生态成熟
后端 Spring Boot 3.2+ 快速开发,社区活跃
数据库 MySQL 8.0+ 关系型需求,运维成熟
缓存 Redis 7.0+ 高性能,支持多种数据结构
消息队列 RabbitMQ 3.12+ 可靠性高,功能完善
搜索 Elasticsearch 8.x 全文检索需求

Read the full file on GitHub · 747 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. 5d ago First seen · 747 lines · 0 tokens per session scan A accd3a85b994

Subscribe to this mod's changes

architecture-lightweight is a cursor rule published in the GitHub repository mywand/cusrsor-do-it (2 stars, last pushed 7mo ago), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 6,791 tokens. 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.