Instruction file imported from agent-kit-startup/agent-kit (.cursor/rules/cursor-skills-general.mdc). Copyright stays with the author.

description: CURSOR-SKILLS general rules (best practices, setup, quality). Source: cursor-skills.vercel.app alwaysApply: true

CURSOR-SKILLS - General Rules

Base: CURSOR-SKILLS. Apply the repository's conventions in any environment.

Principles

• Setup: use extensions, linting, and formatting suited to the environment; Git integration and debugging.
• Structure: follow the environment's conventions, consistent naming, separation of concerns.
• Quality: readable code, error handling, useful comments, tests.
• Workflow: Git, tests, CI/CD, documentation, and code review.
• Documentation: professional, inheritable standard (docs-professional-standard); project voice, no people, unrelated projects, or session context. Chat vs repo hygiene (agent-output-hygiene).

Coding Guidelines

• Think Before Coding: do not assume; flag uncertainty; show tradeoffs; ask when a requirement is ambiguous.
• Simplicity First: the minimum code that solves the problem; no unrequested features; no abstraction for a single use; ask "would a senior find this overengineered?".
• Surgical Changes: touch only what is needed; do not "improve" adjacent code without being asked; keep the existing style; remove only what your change made orphaned.
• Goal-Driven Execution: define success criteria before implementing; iterate until the goal is verified.

Git

Recommended flow: never commit directly to main. Always promote via staging once the project adopts this flow.

1. Local development -> origin/staging via git staging (commit on a working branch, MR to staging, merge).
2. Approved staging -> origin/main (production) via git prod (merge staging -> main, push main).

• BLOCKED (when applicable): direct commit/push to main; direct merge to main.
• ALLOWED: only the origin/staging -> origin/main promotion via git prod.

Commit messages: Conventional Commits (feat:, fix:, docs:, chore:, etc.). Details and technical prompts in autogit/gitupdate.md when it exists.

Recommended configuration (JSON)

{
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": { "source.fixAll": true },
  "files.autoSave": "afterDelay",
  "editor.tabSize": 2,
  "editor.insertSpaces": true
}

Shortcuts

• Ctrl+Shift+P - Command Palette
• Ctrl+` - Terminal
• F5 - Debug
• Ctrl+Shift+F - Find in Files

QA and Review

• Code follows environment standards
• Error handling and documentation
• Tests (unit, integration, E2E as applicable)
• Performance and security considered

Avoid

• Misconfigured environment, ignored linting, confusing structure, missing docs/tests.
• Configure the IDE, format, handle errors, test, and document.