Cline rules

1# Generated Project Configuration
2 
3> **Auto-generated by `analyze_project`**
4> **Project:** appscaffold
5> **Type:** library
6 
7Save this content to `.clinerules/project.md` in your project root,
8then review and adjust the values as needed.
9 
10---
11 
12## 🚨 MANDATORY: Load CodeOps Rules Before Any Work
13 
14**Before ANY planning or implementation, the AI agent MUST load these rules
15using the codeops-mcp tools:**
16 
171. `get_rule("agents")` — Load agent behavior rules **(REQUIRED FIRST)**
182. `get_rule("code")` — Load coding standards
193. `get_rule("testing")` — Load testing workflows
204. `get_rule("git-commands")` — Load git commit protocols
21 
22These rules are **mandatory** and must be consulted before every task.
23**Do NOT skip this step. Do NOT proceed without reading these documents.**
24 
25---
26 
27## Project Overview
28 
29- **Name:** appscaffold
30- **Description:** BlendSDK application scaffold generator — generates a Yarn workspaces + Turborepo monorepo with shared, codegen, webapi, and webclient packages
31- **Type:** library
32 
33## Toolchain
34 
35- **Language(s):** TypeScript
36- **Framework(s):** esbuild
37- **Package Manager:** yarn
38- **Test Framework:** Vitest
39 
40**Manifest files found:** package.json, tsconfig.json
41 
42## Commands
43 
44All commands assume execution from the project root. Prefix all shell commands with `clear && sleep [delay] &&` (see Terminal Delay below).
45 
46### Terminal Delay
47 
48- **Delay (seconds):** 3
49- The `clear` ensures a clean terminal; the `sleep` gives VS Code time to initialize the terminal before the command runs.
50- Adjust the delay for your environment: `1` for fast machines, `3` (default) for normal, `5` for slower environments.
51- All command examples below use `sleep 3` — replace `3` with your configured delay.
52 
53### Build
54 
55```bash
56clear && sleep 3 && yarn build
57```
58 
59### Test
60 
61```bash
62# Run all tests
63clear && sleep 3 && yarn test
64```
65 
66### Verify (before commit)
67 
68```bash
69# Full verification — run this before any git commit
70clear && sleep 3 && yarn build && yarn test
71```
72 
73## Project Structure
74 
75### Type: Single repository
76 
77### Directory Layout
78 
79```
80node_modules/
81plans/
82scaffold/
83src/
84```
85 
86## Coding Conventions
87 
88### Naming
89 
90- **Files:** kebab-case
91- **Components/Classes:** PascalCase
92- **Functions/Methods:** camelCase
93- **Constants:** UPPER_SNAKE_CASE
94 
95## Git & Commit Conventions
96 
97### Commit Scope
98 
99```
100# Use module/feature as scope:
101# feat(scaffold): template changes
102# fix(generator): generator logic fixes
103# chore(project): build/config changes
104```
105 
106### Branch Strategy
107 
108- **Main branch:** `master`
109- **Feature branches:** `feature/[name]`
110 
111## Special Rules (Project-Specific)
112 
113```
114- Template files use {{VARIABLE}} placeholder syntax
115- Partials in scaffold/partials/*.txt are injected into templates during generation
116- Test scaffolded output by running the scaffold, then yarn && yarn ncu && yarn build in the output directory
117```
118 
119## Cross-References
120 
121The generic rule files that read this `project.md`:
122 
123- **make_plan.md** — Uses verify command, file paths, commit scope, task file path patterns
124- **code.md** — Uses language conventions, architecture rules
125- **testing.md** — Uses test commands, test locations, test framework
126- **git-commands.md** — Uses commit scope, verify command
127- **agents.md** — Uses shell commands, verify command
128