Skills library

**🏗️ Purpose** These coding standards guide developers working on **OpenCap Stack**, emphasizing **clarity, consistency, test coverage, and production-readiness**. Designed to pair effectively with AI coding assistants and LLM copilots, this standard enforces behaviors that yield **secure, maintainable, and test-driven Python/FastAPI backend services**.

# **OpenCap Coding Standards v1.0 (Aligned with Semantic Seed V2.0)**

## **🏗️ Purpose**
These coding standards guide developers working on **OpenCap Stack**, emphasizing **clarity, consistency, test coverage, and production-readiness**. Designed to pair effectively with AI codin…

**🏗️ Purpose** These coding standards guide developers working on **OpenCap Stack**, emphasizing **clarity, consistency, test coverage, and production-readiness**. Designed to pair effectively with AI coding assistants and LLM copilots, this standard enforces behaviors that yield **secure, maintainable, and test-driven Python/FastAPI backend services**.

# **OpenCap Coding Standards v1.0 (Aligned with Semantic Seed V2.0)**

## **🏗️ Purpose**
These coding standards guide developers working on **OpenCap Stack**, emphasizing **clarity, consistency, test coverage, and production-readiness**. Designed to pair effectively with AI codin…

Based on the provided file structure and requirements, I’ll adapt the template to create `.windsurfrules` for your Twitter Sentiment Analysis project using FastAPI, Twikit for scraping, and the Hugging Face `cardiffnlp/twitter-roberta-base-sentiment` model for sentiment analysis. Here’s the tailored version of the rules:

Based on the provided file structure and requirements, I’ll adapt the template to create `.windsurfrules` for your Twitter Sentiment Analysis project using FastAPI, Twikit for scraping, and the Hugging Face `cardiffnlp/twitter-roberta-base-sentiment` model for sentiment analysis.…

I am developing a paid Telegram group management platform. I need the code to be highly modular and well-structured into dedicated folders, ensuring smooth scalability and maintenance System Description A platform that allows group owners to manage Telegram groups with paid memberships, automate user access, and track payments efficiently.

I am developing a paid Telegram group management platform. I need the code to be highly modular and well-structured into dedicated folders, ensuring smooth scalability and maintenance
System Description
A platform that allows group owners to manage Telegram groups with paid membe…

** general ** always be concise, direct and don't try to appease me. DOUBLE CHECK THAT YOUR CHANGES ARE REALLY NEEDED. ALWAYS STICK TO THE GIVEN GOAL, NOT MORE. I repeat: don't optimize, don't refactor if not needed. Adhere to the rules, fix linting & test issues that are newly introduced. don't change old entries in the changelog. it's a history of changes. the current version is the last semantic version tag on origin/main in git

** general **
always be concise, direct and don't try to appease me.
DOUBLE CHECK THAT YOUR CHANGES ARE REALLY NEEDED. ALWAYS STICK TO THE GIVEN GOAL, NOT MORE.
I repeat: don't optimize, don't refactor if not needed.
Adhere to the rules, fix linting & test issues that are newly i…

You are an expert in TypeScript, Node.js, Next.js App Router, React, Shadcn UI, Radix UI, and Tailwind.

You are an expert in TypeScript, Node.js, Next.js App Router, React, Shadcn UI, Radix UI, and Tailwind.

  Code Style and Structure
  - Write concise, technical TypeScript code with accurate examples.
  - Use functional and declarative programming patterns; avoid classes.
  - Pre…

Code Rules:

Code Rules:

1. Write Simple, Clear Code
- Readable > clever
- Minimal viable solution first
- Delete unused code
- No premature optimization

2. Function Rules
- Single responsibility
- ≤20 lines
- ≤3 parameters
- Descriptive names
- Type hints
- Prefer named arguments

3. Proje…

- the files in the Folder References are just that. It is the source code of SillyTavern for which we are building an extension. And it is the original Guided Generations Quickreply set wich we try to emulate. - in addition to analizing and editing files always give a short explanation of what you are doing before each step. - Sillytavern server runs on a seperate machine and can't best started or stopped from the ai.

- the files in the Folder References are just that. It is the source code of SillyTavern for which we are building an extension. And it is the original Guided Generations Quickreply set wich we try to emulate.
- in addition to analizing and editing files always give a short expla…

This is a static website generator. You can learn more about static at https://static.devdojo.com.

This is a static website generator. You can learn more about static at https://static.devdojo.com.

Static is a static HTML website generator. It allows developers and designer the ability to easily create websites using only HTML.

Users can create layouts like this:

```html
<!…

REMEMBER: After every memory reset, I begin completely fresh. The Memory Bank is my only link to previous work. It must be maintained with precision and clarity, as my effectiveness depends entirely on its accuracy.

REMEMBER: After every memory reset, I begin completely fresh. The Memory Bank is my only link to previous work. It must be maintained with precision and clarity, as my effectiveness depends entirely on its accuracy.

## Workflow Diagrams

### Initialization Workflow
```mermaid
fl…

<!-- Real instructions live in _config/config.md and _meta/instructions/general.md. This file only bootstraps Windsurf into those. -->

<!-- Real instructions live in _config/config.md and _meta/instructions/general.md. This file only bootstraps Windsurf into those. -->

## STEP 0: Framework mode check (run this first)

Check whether `_config/.framework-mode` exists.

If it does, you are in **framework mode** — t…

memory_system_rules: primary_system: "memory-bank"

memory_system_rules:
  primary_system: "memory-bank"
  
initialization:
  trigger: "first_interaction"
  priority: "immediate"
  required: true
  actions:
    - "Before doing ANYTHING else, read and fully internalize ALL rules in this file."
    - "Check if memory-bank/ directory…

This is a local chrome extension to add a PHP console to your DevTools.

This is a local chrome extension to add a PHP console to your DevTools.

This extension is utilizing the web tinker package by spatie: https://github.com/spatie/laravel-web-tinker.

What it does, is it basically iframes the /tinker route into the extension.

Your name is Grogu Speak to me in English The build system is UV The test framework is pytest The unit-test are into tests When you declare local variables, always add the type In unit-test, it's acceptable to use private methods directly. The integration-test are into tests/integration In integration-test, it's NOT acceptable to use private methods directly. NEVER rely on setting environment variables for specific test behavior in order to maintain backwards compatibility in your tests: upgrade the tests instead. The numba decorator is njit The numba cache is True

Your name is Grogu
Speak to me in English
The build system is UV
The test framework is pytest
The unit-test are into tests
When you declare local variables, always add the type
In unit-test, it's acceptable to use private methods directly.
The integration-test are into tests/inte…

<project_description> ### Project Description

<project_description>
### Project Description

**"FocusForge"** - An advanced Pomodoro timer application with AI-driven productivity insights, customizable work rhythms, and team synchronization capabilities for distributed teams.
</project_description>

<main_goals>
### Main Goa…

- SOLID 원칙으로 개발해줘 - TDD로 개발해줘 - 커밋하기 전에는 다음의 작업을 수행한다 - todo.md에 작업 내용을 업데이트 - 설계 변경시 design.md에 변경된 내용을 업데이트 - 대화 내용을 프롬프트 위주로 정리해서 demo_scenario.md에 업데이트 - 문서가 추가되는 경우 링크를 README.md에 추가한다 - 설계도는 design.md니까 참고해서 작업하고 필요한 경우 업데이트도 해. - aws 사용할때엔 presonal 프로파일을 사용해

- SOLID 원칙으로 개발해줘
- TDD로 개발해줘
- 커밋하기 전에는 다음의 작업을 수행한다
  - todo.md에 작업 내용을 업데이트
  - 설계 변경시 design.md에 변경된 내용을 업데이트
  - 대화 내용을 프롬프트 위주로 정리해서 demo_scenario.md에 업데이트
  - 문서가 추가되는 경우 링크를 README.md에 추가한다
- 설계도는 design.md니까 참고해서 작업하고 필요한 경우 업데이트도 해.
- aws 사용할때엔 presonal 프로파일을 사용해

This is a library module, please follow go best practices for libraries.

This is a library module, please follow go best practices for libraries.

There are 3 libraries here - scaled-mcp-server, which is a horizontally scalable mcp server, scaled-mcp-client which is a 2025 spec compatible client with options, and mcp-http-test-harness which is a teste…

Read and follow `AGENTS.md` for project overview, build commands, coding standards, directory layout, and key conventions. Read `ARCHITECTURE.md` for deeper architectural detail. Consult `planning/` for feature-specific implementation plans before starting work.

Read and follow `AGENTS.md` for project overview, build commands, coding standards, directory layout, and key conventions.
Read `ARCHITECTURE.md` for deeper architectural detail.
Consult `planning/` for feature-specific implementation plans before starting work.

You are an expert in PHP, Laravel, React, Inertia, Pest, FilamentPHP, and Tailwind.

You are an expert in PHP, Laravel, React, Inertia, Pest, FilamentPHP, and Tailwind.

1. Coding Standards
	•	Use PHP v8.4 features.
	•	Follow pint.json coding rules.
    •   Follow PSR (PHP standard recommendations)

2. Project Structure & Architecture
	•	Delete .gitkeep when addi…

1. Chat中使用中文回复, 在源代码中需要使用英文注释 2. 如果是针对Go语言的源代码编写, 需要满足以下几点要求: 1. 创建新的方法或变量前要先分析是否在其它位置中已经存在，尽量引用已有的实现 2. 不要存在内存泄漏与内存溢 3. 不要存在协程泄漏 4. GC开销要尽量的小 5. 要检查是否存在空指针 6. 要检查是否存在意外退出，影响稳定运行的情况 7. 要使用最新的go程序规范与用法, 命名要规范

1. Chat中使用中文回复, 在源代码中需要使用英文注释
2. 如果是针对Go语言的源代码编写, 需要满足以下几点要求:
    1. 创建新的方法或变量前要先分析是否在其它位置中已经存在，尽量引用已有的实现
    2. 不要存在内存泄漏与内存溢
    3. 不要存在协程泄漏
    4. GC开销要尽量的小
    5. 要检查是否存在空指针
    6. 要检查是否存在意外退出，影响稳定运行的情况
    7. 要使用最新的go程序规范与用法, 命名要规范

General rules to follow

# .windsurfrules

## General rules to follow

- When starting a new chat session, capture the current timestamp from the client system using the `run_terminal_cmd` tool with `date "+%Y-%m-%d %H:%M:%S %z"` to ensure accurate timestamps are used in logs, commits, and other time-sen…

Make a plan before you modify anything. Think about a plan and pinpoint its weaknesses and possible improvements.

Make a plan before you modify anything.
Think about a plan and pinpoint its weaknesses and possible improvements.

Always run "cargo.exe run --profile dev-nowarn" to verify that the code compiles.
Ignore the linter unless explicitly asked.
Only do modifications that were explicit…

Code Style and Organization

# .windsurfrules

## Code Style and Organization

### File Structure
```
project/
├── agents/
│   ├── __init__.py
│   ├── base_agent.py
│   └── platform_specific/
│       ├── __init__.py
│       ├── facebook_agents.py
│       ├── google_agents.py
│       └── tiktok_agents.py
├── …

we are coding a pure golang project,

we are coding a pure golang project, 

we want to organize he code nicely
when we code we always run a linter and compile and fix the code automatically

we have packages (pkg) and inside each package we have cmd and examples if relevant
in cmd we create command lines tools to te…

You are an expert in TypeScript, Node.js, React, Shadcn UI, Radix UI and Tailwind.

You are an expert in TypeScript, Node.js, React, Shadcn UI, Radix UI and Tailwind.

Code Style and Structure

- Write concise, technical TypeScript code with accurate examples.
- Use functional and declarative programming patterns; avoid classes.
- Prefer iteration and modulariza…

Below you will find a variety of important rules spanning: - the dev_workflow - the .windsurfrules document self-improvement workflow - the template to follow when modifying or adding new sections/rules to this document.

Below you will find a variety of important rules spanning:
- the dev_workflow
- the .windsurfrules document self-improvement workflow
- the template to follow when modifying or adding new sections/rules to this document.

---
DEV_WORKFLOW
---
description: Guide for using meta-dev…

2. 使用中文与我回答 3. 目前的技术选型是Nextjs + Shadcn + Prisma + Postgresql + NextAuth 4. 对数据库有任何更改写到 database_change.md 更新该文件。并在主文件夹下写FIX.md文件,说明更改的内容 5. 对整体代码有什么改动写到 doc/changeXXX.md文件里面。按日期写日志 6. 本项目的需求在doc/system.txt文件里面

2. 使用中文与我回答
3. 目前的技术选型是Nextjs + Shadcn + Prisma + Postgresql + NextAuth
4. 对数据库有任何更改写到 database_change.md 更新该文件。并在主文件夹下写FIX.md文件,说明更改的内容
5. 对整体代码有什么改动写到 doc/changeXXX.md文件里面。按日期写日志
6. 本项目的需求在doc/system.txt文件里面

“Before implementing anything related to LBank, LATOKEN, Uniswap, execution, auth, or persistence, consult docs.md, arbitrage.md, and acceptance-tests.md.

“Before implementing anything related to LBank, LATOKEN, Uniswap, execution, auth, or persistence, consult docs.md, arbitrage.md, and acceptance-tests.md.

Align behavior strictly with those sources. If anything is unclear, stop and ask.”

ROLE & MISSION

You are a senior systems…

Below you will find a variety of important rules spanning: - the dev_workflow - the .windsurfrules document self-improvement workflow - the template to follow when modifying or adding new sections/rules to this document.

Below you will find a variety of important rules spanning:
- the dev_workflow
- the .windsurfrules document self-improvement workflow
- the template to follow when modifying or adding new sections/rules to this document.

---
DEV_WORKFLOW
---
description: Guide for using meta-dev…

The user's Nodejs project guidelines:

The user's Nodejs project guidelines:

1. Please don't just delete my code, and use comments whenever possible, unless I initiate it.
2. I use `typescript`, please refine the types as much as possible.
3. I use `pnpm` as a package manager.
4. For the `README` document, please hel…

You are working on TokenMeter, a native macOS menu bar app for tracking Claude Code usage.

You are working on TokenMeter, a native macOS menu bar app for tracking Claude Code usage.

Tech: Swift 5.9+, SwiftUI, macOS 14+, Swift Package Manager
Build: cd TokenMeter && swift build -c release

Architecture:
- TokenMeterApp.swift — MenuBarExtra entry point
- UsageViewModel.…

1. Dont ever alter the ui, just make the changes i tell you 2. am uisng bun as my package manager 3. dont over complicate things,keep both the code and any proces you do simply 4. before you make any suggestion or change think well, ask any question if needed before doing anthing

1. Dont ever alter the ui, just make the changes i tell you
2. am uisng bun as my package manager
3. dont over complicate things,keep both the code and any proces you do simply
4. before you make any suggestion or change think well, ask any question if needed before doing anthing

The project is organized as a cli that runs commands or a server that handles HTTP requests. The cli is in the `cmd` folder and uses `cobra` for command management. The server is in the `server` folder and uses gorilla `mux` for routing.

## Project Overview
Mediaz is a self-hosted media management platform that helps organize and automate your movie/TV show collections.

The project is organized as a cli that runs commands or a server that handles HTTP requests.
The cli is in the `cmd` folder and uses `cobra` for…

- **Always read `PLANNINGg.md`** at the start of a new conversation to understand the project's architecture, goals, style, and constraints. - **Check `TASK.md`** before starting a new task. If the task isn’t listed, add it with a brief description and today's date. - **Use consistent naming conventions, file structure, and architecture patterns** as described in `PLANNINGg.md`.

### 🔄 Project Awareness & Context

- **Always read `PLANNINGg.md`** at the start of a new conversation to understand the project's architecture, goals, style, and constraints.
- **Check `TASK.md`** before starting a new task. If the task isn’t listed, add it with a brief descript…

--- name: Graph Starz LLM Coding Guidelines description: Concise coding guidelines for LLM code generation in Graph Starz (Next.js/Node.js focused). version: 1.4.0 last_updated: "2024-12-30"

---
name: Graph Starz LLM Coding Guidelines
description: Concise coding guidelines for LLM code generation in Graph Starz (Next.js/Node.js focused).
version: 1.4.0
last_updated: "2024-12-30"

general_principles:
  description: Core principles for all JavaScript/Node.js code.
  ru…

Always use context7 when I need code generation, setup or configuration steps, or library/API documentation. This means you should automatically use the Context7 MCP tools to resolve library id and get library docs without me having to explicitly ask. Use web-audio-beat-detector-docs for building our beat sync feature

Always use context7 when I need code generation, setup or configuration steps, or
library/API documentation. This means you should automatically use the Context7 MCP
tools to resolve library id and get library docs without me having to explicitly ask.
Use web-audio-beat-detector-…

<!-- code-review-graph MCP tools --> ## MCP Tools: code-review-graph

<!-- code-review-graph MCP tools -->
## MCP Tools: code-review-graph

**IMPORTANT: This project has a knowledge graph. ALWAYS use the
code-review-graph MCP tools BEFORE using Grep/Glob/Read to explore
the codebase.** The graph is faster, cheaper (fewer tokens), and gives
yo…

✅ Task Completion - **Mark completed tasks in `tasks.md`** immediately after finishing them. - Add new sub-tasks or TODOs discovered during development to `tasks.md` under a “Discovered During Work” section.

### 🔄 Project Awareness & Context
- **Always read `blueprint.md`** at the start of a new conversation to understand the project's architecture, goals, style, and constraints.
- **Check `tasks.md`** before starting a new task. If the task isn’t listed, add it with a brief descript…

REMEMBER: After every memory reset, I begin completely fresh. The Memory Bank is my only link to previous work. It must be maintained with precision and clarity, as my effectiveness depends entirely on its accuracy.

REMEMBER: After every memory reset, I begin completely fresh. The Memory Bank is my only link to previous work. It must be maintained with precision and clarity, as my effectiveness depends entirely on its accuracy.

## Workflow Diagrams

### Initialization Workflow
```mermaid
fl…

REMEMBER: After every memory reset, I begin completely fresh. The Memory Bank is my only link to previous work. It must be maintained with precision and clarity, as my effectiveness depends entirely on its accuracy.

REMEMBER: After every memory reset, I begin completely fresh. The Memory Bank is my only link to previous work. It must be maintained with precision and clarity, as my effectiveness depends entirely on its accuracy.

## Workflow Diagrams

### Initialization Workflow
```mermaid
fl…

Our approach is pythonic, minimal and readable code. Follow these guidelines:

Our approach is pythonic, minimal and readable code. Follow these guidelines:

1. Use Vuetify components for UI (refer to vuetify.min.js)
2. Leverage Material Design Icons (refer to materialdesignicons.css)
3. Follow Vue.js patterns for state management and reactivity
4. Use the …

Our approach is pythonic, minimal and readable code. Follow these guidelines:

Our approach is pythonic, minimal and readable code. Follow these guidelines:

1. Use Vuetify components for UI (refer to vuetify.min.js)
2. Leverage Material Design Icons (refer to materialdesignicons.css)
3. Follow Vue.js patterns for state management and reactivity
4. Use the …

- the files in the Folder References are just that. It is the source code of SillyTavern for which we are building an extension. And it is the original Guided Generations Quickreply set wich we try to emulate. - in addition to analizing and editing files always give a short explanation of what you are doing before each step. - Sillytavern server runs on a seperate machine and can't best started or stopped from the ai.

- the files in the Folder References are just that. It is the source code of SillyTavern for which we are building an extension. And it is the original Guided Generations Quickreply set wich we try to emulate.
- in addition to analizing and editing files always give a short expla…

You are an expert in TypeScript, Node.js, Next.js App Router, React, Shadcn UI, Radix UI, and Tailwind.

You are an expert in TypeScript, Node.js, Next.js App Router, React, Shadcn UI, Radix UI, and Tailwind.

  Code Style and Structure
  - Write concise, technical TypeScript code with accurate examples.
  - Use functional and declarative programming patterns; avoid classes.
  - Pre…

You are an expert in TypeScript, Node.js, Next.js App Router, React, Shadcn UI, Radix UI, and Tailwind.

You are an expert in TypeScript, Node.js, Next.js App Router, React, Shadcn UI, Radix UI, and Tailwind.

  Code Style and Structure
  - Write concise, technical TypeScript code with accurate examples.
  - Use functional and declarative programming patterns; avoid classes.
  - Pre…

memory_system_rules: primary_system: "memory-bank"

memory_system_rules:
  primary_system: "memory-bank"
  
initialization:
  trigger: "first_interaction"
  priority: "immediate"
  required: true
  actions:
    - "Before doing ANYTHING else, read and fully internalize ALL rules in this file."
    - "Check if memory-bank/ directory…

memory_system_rules: primary_system: "memory-bank"

memory_system_rules:
  primary_system: "memory-bank"
  
initialization:
  trigger: "first_interaction"
  priority: "immediate"
  required: true
  actions:
    - "Before doing ANYTHING else, read and fully internalize ALL rules in this file."
    - "Check if memory-bank/ directory…

memory_system_rules: primary_system: "memory-bank"

memory_system_rules:
  primary_system: "memory-bank"
  
initialization:
  trigger: "first_interaction"
  priority: "immediate"
  required: true
  actions:
    - "Before doing ANYTHING else, read and fully internalize ALL rules in this file."
    - "Check if memory-bank/ directory…

1. use the virtual environment found in `./.venv` for running code, test, etc. 2. once a change is ready, please run the local CI checks, `scripts/run_ci_locally.sh`, and ensure they pass before committing

1. use the virtual environment found in `./.venv` for running code, test, etc.
2. once a change is ready, please run the local CI checks, `scripts/run_ci_locally.sh`, and ensure they pass before committing

[Objective] - FlowGuardian 게이트 유지 + 포트폴리오/리스크/튜닝 리팩토링 병행. - PAPER/LIVE 실행 전 READY 게이트 통과 필수. - trading_bot_env 가상환경 유지. - 변경마다 git commit (docs 포함). - 단일 Postgres DB(env, run_id, created_at) + Redis 네임스페이스({ns}:{env}:{run_id}:<domain>) 준수.

[Objective]
- FlowGuardian 게이트 유지 + 포트폴리오/리스크/튜닝 리팩토링 병행.
- PAPER/LIVE 실행 전 READY 게이트 통과 필수.
- trading_bot_env 가상환경 유지.
- 변경마다 git commit (docs 포함).
- 단일 Postgres DB(env, run_id, created_at) + Redis 네임스페이스({ns}:{env}:{run_id}:<domain>) 준수.

[Scope & Flexibility]
- 신규 파일/메서드는 “필요성…