🎉 init: 小龙的工作空间

reflections/2026-06-05-nextjs-path.md

@@ -0,0 +1,31 @@
+# Reflection: Next.js `src/app/` vs `app/` Path Convention
+
+> Date: 2026-06-05 | Severity: P0 | Recurrence: 1
+
+## Context
+Domain Benchmark Suite v1 — frontend-builder-agent.mjs 生成的 Next.js 项目输出到 `src/app/` 目录。10/10 项目 Build 失败（0/10 Build）。Next.js App Router 默认 pages directory 是 `app/`。
+
+## Root Cause
+Frontend Builder Agent 的初始设计内嵌了错误的路径假设。模板代码输出到 `src/app/`，但 Next.js `app/` router 不从 `src/app/` 读取。Tailwind content 配置和 tsconfig paths 也指向了错误路径。
+
+## Fix
+全局替换：
+- `src/app/` → `app/`
+- 更新 tsconfig paths 匹配 `app/`
+- 更新 tailwind.config content 匹配 `app/**/*.{ts,tsx}`
+
+## Pattern Class
+**Path Convention Mismatch** — Generator/Builders 有硬编码路径假设，与实际 runtime 的 convention 不一致。
+
+## Future Trigger
+- Any Next.js project generation
+- Any framework-specific builder agent creation
+- Any path-dependent code generation
+
+## Checklist
+- [ ] 验证生成器输出目录与目标框架的 default convention 一致
+- [ ] 在生成器写完第一版后立即跑 build smoke test
+- [ ] tsconfig paths 与 tailwind content 与 pages directory 三者一致性检查
+
+## Recurrence Count
+1