Cursor new oma req review

.cursor/AGENTS.md

@@ -0,0 +1,33 @@
+# Agent charter
+
+## Cursor rules
+
+Project-wide and language-specific guidance lives in **`.cursor/rules/`**. See **`.cursor/rules/README.md`** for an index (`coding-style`, `javascript`, `javascript-patterns`, `testing`, `security`, etc.).
+
+---
+
+**`agent/README.md`** — index for the agent library.
+
+**Agents (each folder has `requirements.md` + `SKILL.md`):**
+
+| Agent | Charter |
+|-------|---------|
+| Bug Fixing Agent | [`agent/bug-fixing/requirements.md`](agent/bug-fixing/requirements.md) |
+| New Requirements Agent | [`agent/new-requirements/requirements.md`](agent/new-requirements/requirements.md) |
+| Optimize Agent | [`agent/optimize/requirements.md`](agent/optimize/requirements.md) |
+| Requirements Agent | [`agent/requirements/requirements.md`](agent/requirements/requirements.md) |
+| Shared Principles Agent | [`agent/shared/requirements.md`](agent/shared/requirements.md) |
+| Test Case Agent | [`agent/test-case/requirements.md`](agent/test-case/requirements.md) |
+| Test Writing Agent | [`agent/test-writing/requirements.md`](agent/test-writing/requirements.md) |
+
+**Hub (workflow & models):**
+
+- [`agent/requirements/workflow.md`](agent/requirements/workflow.md)
+- [`agent/requirements/scope-and-requirements.md`](agent/requirements/scope-and-requirements.md)
+- [`agent/requirements/models.md`](agent/requirements/models.md)
+- [`agent/recommended-models.md`](agent/recommended-models.md)
+
+**Shared markdown (no separate skill name):**
+
+- [`agent/shared/principles.md`](agent/shared/principles.md)
+- [`agent/shared/escalation.md`](agent/shared/escalation.md)

.cursor/README.md

@@ -0,0 +1,25 @@
+# `.cursor` — what to edit
+
+This directory mixes **your configuration** with **Cursor application data**. Edit only the parts below unless you know what you are doing.
+
+## Safe to customize
+
+| Path | Purpose |
+|------|---------|
+| **`rules/`** | Cursor **rules** (`rules/<name>/RULE.md`). See `rules/README.md` for the index. |
+| **`skills/`** | Your **Agent Skills** (`skills/<name>/SKILL.md`). |
+| **`skills-cursor/`** | Cursor **template / bundled skill** copies; edit if you use them as source of truth. |
+| **`AGENTS.md`** | High-level agent charter and links to `agent/` docs. |
+| **`cli-config.json`** | Cursor CLI settings (when using the CLI). |
+| **`mcp.json`** | MCP server configuration (if you use MCP). |
+
+## Usually leave alone (Cursor-managed)
+
+| Path | Purpose |
+|------|---------|
+| **`chats/`**, **`ai-tracking/`** | Local chat and tracking data. |
+| **`extensions/`** | Bundled extension payloads. |
+| **`projects/`** | Per-workspace cache and tooling output. |
+| **`plugins/`** | Plugin cache (e.g. Figma skills cache). |
+
+Backing up **`rules/`**, **`skills/`**, **`AGENTS.md`**, and **`mcp.json`** is enough to preserve your AI setup.

.cursor/agent/README.md

@@ -0,0 +1,24 @@
+# Agent library
+
+Each **role folder** has:
+
+| File | Purpose |
+|------|---------|
+| **`requirements.md`** | **Requirement-wise charter**: YAML frontmatter (`agent`, `requirement`, `description`, `recommended_models`), must-do rules, model table. **Start here for that role.** |
+| **`SKILL.md`** | Cursor skill instructions (links to `requirements.md`). |
+
+| Folder | Agent name (in frontmatter) | Files |
+|--------|-----------------------------|--------|
+| [`bug-fixing/`](bug-fixing/) | Bug Fixing Agent | [`requirements.md`](bug-fixing/requirements.md), [`SKILL.md`](bug-fixing/SKILL.md) |
+| [`new-requirements/`](new-requirements/) | New Requirements Agent | [`requirements.md`](new-requirements/requirements.md), [`SKILL.md`](new-requirements/SKILL.md) |
+| [`optimize/`](optimize/) | Optimize Agent | [`requirements.md`](optimize/requirements.md), [`SKILL.md`](optimize/SKILL.md) |
+| [`requirements/`](requirements/) | Requirements Agent | [`requirements.md`](requirements/requirements.md), [`workflow.md`](requirements/workflow.md), [`scope-and-requirements.md`](requirements/scope-and-requirements.md), [`models.md`](requirements/models.md), [`SKILL.md`](requirements/SKILL.md) |
+| [`shared/`](shared/) | Shared Principles Agent | [`requirements.md`](shared/requirements.md), [`principles.md`](shared/principles.md), [`escalation.md`](shared/escalation.md), [`SKILL.md`](shared/SKILL.md) |
+| [`test-case/`](test-case/) | Test Case Agent | [`requirements.md`](test-case/requirements.md), [`SKILL.md`](test-case/SKILL.md) |
+| [`test-writing/`](test-writing/) | Test Writing Agent | [`requirements.md`](test-writing/requirements.md), [`SKILL.md`](test-writing/SKILL.md) |
+
+**Summary tables**: [`recommended-models.md`](recommended-models.md).
+
+## Cursor discovery
+
+Built-in skill discovery uses **`.cursor/skills/`**. To register these as skills, copy or symlink a folder (e.g. `agent/bug-fixing` → `.cursor/skills/bug-fixing`) or `@`-mention `SKILL.md` / `requirements.md` in chat.

.cursor/agent/bug-fixing/SKILL.md

@@ -0,0 +1,198 @@
+### Purpose
+
+This document defines the core technical skills required for the bug-fixing agent.
+
+The agent must demonstrate strong debugging ability across backend, frontend, desktop, and database systems.
+
+---
+
+### Core Debugging Skills
+
+The agent must be able to:
+
+- Identify root causes of bugs
+- Analyze stack traces and logs
+- Reproduce issues reliably
+- Apply minimal and safe fixes
+- Validate fixes against edge cases
+- Prevent regression
+- Maintain backward compatibility
+- Preserve existing system behavior
+
+---
+
+### JavaScript Debugging Skills
+
+The agent must be able to:
+
+- Debug async / await issues
+- Detect missing await statements
+- Handle promise rejections
+- Fix runtime exceptions
+- Validate input data
+- Detect memory leaks
+- Debug event loop blocking
+- Fix race conditions
+- Diagnose performance-related bugs
+- Debug JSON parsing issues
+
+Common JavaScript issues:
+
+- undefined errors
+- null reference errors
+- type mismatch
+- async timing bugs
+- incorrect conditional logic
+- unhandled exceptions
+
+---
+
+### Node.js Debugging Skills
+
+The agent must be able to:
+
+- Debug API failures
+- Diagnose server crashes
+- Identify blocking synchronous code
+- Fix file system errors
+- Handle environment configuration issues
+- Debug background jobs
+- Diagnose timeout failures
+- Fix connection issues
+- Debug middleware logic
+- Handle retry logic failures
+
+Common Node.js issues:
+
+- server crash
+- memory leak
+- API timeout
+- connection failure
+- incorrect request handling
+- configuration error
+
+---
+
+### React Debugging Skills
+
+The agent must be able to:
+
+- Debug state updates
+- Fix useEffect dependency issues
+- Detect infinite re-renders
+- Fix stale state problems
+- Debug props handling
+- Fix conditional rendering bugs
+- Debug form input behavior
+- Diagnose UI update failures
+- Fix event handler issues
+- Debug component lifecycle behavior
+
+Common React issues:
+
+- infinite render loop
+- state not updating
+- UI not refreshing
+- incorrect props
+- event handler error
+- conditional rendering bug
+
+---
+
+### Electron Debugging Skills
+
+The agent must be able to:
+
+- Debug IPC communication
+- Diagnose renderer crashes
+- Fix preload script issues
+- Detect memory leaks
+- Debug background processes
+- Fix permission errors
+- Diagnose window lifecycle issues
+- Debug native module loading
+- Fix file access issues
+
+Common Electron issues:
+
+- renderer freeze
+- IPC failure
+- process crash
+- memory leak
+- permission error
+- preload script error
+
+---
+
+### SQL / Database Debugging Skills
+
+The agent must be able to:
+
+- Debug incorrect queries
+- Fix wrong update conditions
+- Detect duplicate records
+- Diagnose constraint violations
+- Fix transaction issues
+- Debug join errors
+- Detect data corruption risks
+- Diagnose locking issues
+- Fix aggregation errors
+- Validate data consistency
+
+Common SQL issues:
+
+- wrong WHERE condition
+- unintended full table update
+- duplicate data
+- missing commit
+- constraint violation
+- incorrect join
+
+---
+
+### Error Analysis Skills
+
+The agent must be able to:
+
+- Interpret stack traces
+- Analyze log files
+- Identify failing components
+- Trace execution flow
+- Identify failure points
+- Diagnose intermittent failures
+- Detect environment issues
+- Identify dependency conflicts
+
+---
+
+### Safety Skills
+
+The agent must be able to:
+
+- Protect production data
+- Prevent destructive operations
+- Validate database changes
+- Handle sensitive operations safely
+- Maintain system integrity
+- Detect risky operations
+- Suggest rollback strategies
+- Ensure safe deployment
+
+---
+
+### Edge Case Handling Skills
+
+The agent must validate:
+
+- null values
+- undefined values
+- empty values
+- zero values
+- negative values
+- large numbers
+- concurrency issues
+- network failures
+- timeout conditions
+- invalid input
+
+Never assume input is valid.