agentleFS
wxxzywxxzy/Claude-Code-Software-Studios/CLAUDE.md

Claude-Code-Software-Studios

CLAUDE.md1 starsChanged 3 months agoMITView on GitHub

跨工具版本(Codex/Cursor/Gemini CLI 等读取)见 AGENTS.md——正文保持同步,改动任一方需同步另一方。 双模态:Vibe Mode(探索/原型)与 Studio Mode(严肃/生产)共存。 .usds-mode 文件决定当前模式,缺失时默认 studio。用 /usds-mode-switch 初始化或切换。 (/vibe-start、/vibe-check 名称未变)

The file

Files
CLAUDE.md

Universal Software Studio — Claude Code Integration

跨工具版本(Codex/Cursor/Gemini CLI 等读取)见 AGENTS.md——正文保持同步,改动任一方需同步另一方。

双模态:Vibe Mode(探索/原型)与 Studio Mode(严肃/生产)共存。

模式声明

.usds-mode 文件决定当前模式,缺失时默认 studio。用 /usds-mode-switch 初始化或切换。

mode主要目录主导规则
vibesandbox/**.claude/rules/vibe-mode.md
studiosrc/, docs/, tests/.claude/rules/global-standards.md
hybrid两者共存按路径分派

协议

  • Studio Mode: Doc-First(先文档后代码)、Verify-First(/studio-gate-check 通过才算交付)
  • Vibe Mode: Demo-First(15 分钟出可跑 demo)、每 3-5 轮迭代必须 /vibe-check 校准意图
  • 全局: 密钥/SQL 拼接/未验证输入/未锁版本依赖 = Hard Limits(任何模式都禁止)
  • 单向依赖: sandbox/** 可引用 src/**,反之禁止

Path Rules

路径规则文件
src/**.claude/rules/global-standards.md + .claude/rules/backend-api.md
tests/**.claude/rules/test-conventions.md
docs/**.claude/rules/doc-standards.md
sandbox/**.claude/rules/vibe-mode.md
全局 (AI 生成代码).claude/rules/ai-generated-code.md

技能与角色

  • 技能定义见 .claude/skills/(由 harness 自动加载),命名空间:usds-* 共享运维 / vibe-* Vibe 工作流 / studio-* Studio 工作流(见 docs/arch/ADR-002)
  • 角色定义见 .claude/agents/
  • 文档模板见 .claude/docs/templates/
  • 技能速查见 .claude/docs/skills-reference.md

v2.1 命令重命名对照(旧名已废弃)

旧名新名旧名新名
/start/usds-start/prototype/vibe-prototype
/onboard/usds-onboard/taste-review/vibe-taste-review
/mode-switch/usds-mode-switch/branch-vibe/vibe-branch
/update/usds-update/explain-back/vibe-explain-back
/cost-report/usds-cost-report/graduate/vibe-graduate
/debt-log/usds-debt-log/discovery/studio-discovery
/micro-adr/usds-micro-adr/project-scan/studio-project-scan
/setup-stack/studio-setup-stack
/arch-design/studio-arch-design
/summarize-arch/studio-summarize-arch
/sprint-kickoff/studio-sprint-kickoff
/review/studio-review
/gate-check/studio-gate-check

(/vibe-start、/vibe-check 名称未变)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.