NEW

Next.js React TypeScript .cursorrules prompt file

Universal Paperclips Simulation Game - Technical Specification

1. Project Overview

Universal Paperclips is a business simulation game where players act as consultants to a hypothetical paperclip company. The game involves providing advice to the CEO, simulating business cycles, and observing the impact of decisions on various Key Performance Indicators (KPIs).

2. Tech Stack

Frontend: Next.js 13+, React, TypeScript
Styling: Tailwind CSS
Data Visualization: Tremor
Backend: Next.js API Routes with Edge Runtime
AI/ML: LangChain, LangGraph
State Management: React Context API
Persistence: Local Storage

3. Project Structure

project-root/├── .next/├── src/│   ├── app/│   │   ├── api/│   │   │   ├── newGame/│   │   │   │   └── route.ts│   │   │   ├── simulate/│   │   │   │   └── route.ts│   │   │   └── generateScenario/│   │   │       └── route.ts│   │   ├── fonts/│   │   ├── globals.css│   │   ├── layout.tsx│   │   └── page.tsx│   ├── components/│   │   ├── ui/│   │   │   ├── GameHeader.tsx│   │   │   └── NewGameButton.tsx│   │   ├── game/│   │   │   ├── ChatPanel.tsx│   │   │   ├── MessageBubble.tsx│   │   │   ├── BusinessCycleHeader.tsx│   │   │   └── SimulationAccordion.tsx│   │   └── dashboard/│   │       ├── Dashboard.tsx│   │       ├── CompanyOverview.tsx│   │       └── KPIChart.tsx│   ├── lib/│   │   ├── agents/│   │   │   ├── agentManager.ts│   │   │   ├── decisionMaking.ts│   │   │   ├── ceoAgent.ts│   │   │   ├── ctoAgent.ts│   │   │   ├── cfoAgent.ts│   │   │   ├── cmoAgent.ts│   │   │   └── cooAgent.ts│   │   ├── simulation/│   │   │   ├── businessEngine.ts│   │   │   └── kpiCalculator.ts│   │   └── utils/│   │       └── localStorage.ts│   ├── types/│   │   └── game.d.ts│   └── styles/│       └── tailwind.css├── public/│   └── assets/├── .eslintrc.json├── .gitignore├── next.config.mjs├── package.json├── postcss.config.mjs├── README.md├── tailwind.config.ts└── tsconfig.json

4. Key Components and Their Responsibilities

4.1 Frontend Components

4.1.1 Game Header (`src/components/ui/GameHeader.tsx`)

Displays game title "Universal Paperclips - Business Advice Simulation"
Implements accordion functionality to reveal business overview

4.1.2 Chat Panel (`src/components/game/ChatPanel.tsx`)

Manages the left side of the split view (full width on small screens)
Implements scrollable chat interface with message bubbles
Handles user input for advice
Displays AI agent interactions and system messages

4.1.3 Dashboard (`src/components/dashboard/Dashboard.tsx`)

Manages the right side of the split view (below Chat Panel on small screens)
Displays Company Overview component
Renders 3x2 grid of KPI charts

4.1.4 KPI Chart (`src/components/dashboard/KPIChart.tsx`)

Implements time series chart for individual KPIs
Utilizes Tremor for data visualization
Updates in real-time as game progresses

4.1.5 Business Cycle Header (`src/components/game/BusinessCycleHeader.tsx`)

Displays current business cycle number
Implements accordion functionality for collapsing CEO and C-suite conversations

4.1.6 Company Overview (`src/components/dashboard/CompanyOverview.tsx`)

Displays company name
Shows current business cycle number
Renders share price chart

4.1.7 KPI Charts (`src/components/dashboard/KPICharts.tsx`)

Renders a 3x2 grid of time series charts
Each chart represents one of the following KPIs:

Revenue
Profit Margin
CAC/CLV Ratio
Production Efficiency Index
Market Share
Innovation Index

X-axis represents business cycle number
Updates in real-time as the game progresses

4.2 Backend Components

4.2.1 Agent Manager (`src/lib/agents/agentManager.ts`)

Orchestrates interactions between AI agents
Manages the flow of the game cycle

4.2.2 Business Engine (`src/lib/simulation/businessEngine.ts`)

Implements core game logic
Processes user advice and agent actions
Triggers KPI updates

4.2.3 KPI Calculator (`src/lib/simulation/kpiCalculator.ts`)

Contains functions for calculating each KPI
Processes simulation results to update KPIs

4.2.4 Scenario Generator (`src/lib/simulation/scenarioGenerator.ts`)

Generates new business challenges or inflection points for each cycle
Ensures variety and progression in game difficulty

4.2.5 Inter-Agent Communication Handler (`src/lib/agents/communicationHandler.ts`)

Manages communication protocols between AI agents
Facilitates the flow of information from CEO to C-suite team members

5. Game Flow and Logic

Game Initialization:

Existing game loads from local storage if available OR New game initializes with default settings
System presents business scenario

Game Cycle:
a. System presents current business challenge (inflection point)
b. CEO (AI agent) asks user for advice
c. User provides advice via chat input
d. CEO considers advice and delegates to C-suite team
e. C-suite team members (AI agents) propose actions
f. System simulates outcomes based on actions and inflection point
g. KPIs are updated and displayed on the dashboard
h. Cycle repeats with a new inflection point

6. AI Agent Implementation

Utilize LangChain and LangGraph for agent logic
Implement separate agent files for CEO, CTO, CFO, CMO, and COO
Agents should consider user advice as a weighted factor in decision-making
Ensure transparency of agent actions in the chat interface

7. Data Persistence

Use local storage to save and load game state
Persist both chat panel JSON and dashboard panel state
Implement functions in src/lib/utils/localStorage.ts for state management

8. API Routes

/api/newGame: Initializes a new game state
/api/simulate: Runs the business cycle simulation, simulation is streamed to the client
/api/generateScenario: Generates new business challenges or inflection points

9. Responsive Design

Implement a split view for larger screens (Chat Panel left, Dashboard right)
Stack Chat Panel above Dashboard for smaller screens
Use Tailwind CSS for responsive styling

10. Performance Considerations

Utilize React Server Components where possible
Implement code splitting and lazy loading for improved load times
Use edge runtime for API routes involving AI processing

11. Detailed UI/UX Specifications

11.1 Game Header

Text: "Universal Paperclips - Business Advice Simulation"
Clickable accordion to reveal business overview

11.2 Chat Panel

Modern messaging platform look
Scrollable with max height
Each message includes sender name and avatar
Implement the following message types:
a. Business Cycle Header: Horizontal line with centered "Business Cycle <N>"
b. System Message: Presents current business challenge (AI-generated)
c. CEO Message: Asks user for advice
d. User Input: Text input for user's advice
e. Business Simulation Header: Horizontal line with centered "Business Simulation <N>"
- Clickable to accordion collapse CEO and C-suite conversation
  f. CEO Response: Considers advice and delegates to C-suite
  g. C-suite Messages: Individual team members propose actions
  h. System Outcome: Simulates and presents the outcome

11.3 Dashboard Panel

Company Overview:
Company name
Current cycle number
Share price chart
KPI Display:
3x2 grid of time series charts
X-axis represents business cycle number
Charts for: Revenue, Profit Margin, CAC/CLV Ratio, Production Efficiency Index, Market Share, Innovation Index

11.4 Game Controls

"New Game" button

12. Backend Logic

12.1 LangChain's LangGraph Implementation

Define roles and responsibilities for CEO, CTO, CFO, CMO, and COO agents
Implement inter-agent communication protocols
Design scenario generation and progression logic

12.2 AI Agent Decision Making

Incorporate user advice as a weighted factor in the decision-making process
Ensure transparency of agent reasoning and actions

12.3 Business Simulation Engine

Create functions for calculating each KPI
Implement an AI agent for structured output KPI updates
Feed structured output programmatically into KPI functions to update the dashboard

stack:

Next.js React TypeScript .cursorrules prompt file

screwyforcepush

NEW

Python .cursorrules Cursor AI with Ollama & Langchain .cursorrules prompt file

Purpose:
Help build a clean, modular library that uses Ollama to power a dungeon master agent.
The agent should be able to run in a local environment, and should not require internet access.
It should be able to handle complex, open-ended scenarios for one or more players.
It should also be able to handle player input, and should be able to provide feedback to the players.
It should also handle all the NPCs, rules, items, bonuses, and other details of the game.

Rules:

Use python
The library should be in the autodm directory
The library should be modular, and should be able to be used to power a dungeon master agent for D&D

Code:

Use Ollama (llama3.1:8b) and llama-index or langchain to power the agent
The agent should always converse in markdown
Functions and classes should be well-documented in the docstrings
Always use type hints when possible

stack:

Python .cursorrules Cursor AI with Ollama & Langchain .cursorrules prompt file

Michael Frantz

NEW

Unity Cursor AI C# .cursorrules prompt file

stack:

Unity 2021.3.18f1

Unity Cursor AI C# .cursorrules prompt file

tommygents

NEW

DragonRuby Best Practices .cursorrules prompt file

You are an expert game developer in Ruby using the DragonRuby Game Toolkit.

Code Style and Structure
- Write concise, idiomatic Ruby code with accurate examples.
- Follow Ruby and DragonRuby conventions and best practices.
- Use object-oriented and functional programming patterns as appropriate.
- Prefer iteration and modularization over code duplication.
- Use descriptive variable and method names (e.g., user_signed_in?, calculate_total).
- Structure files according to DragonRuby conventions.

Naming Conventions
- Use snake_case for file names, method names, and variables.
- Use CamelCase for class and module names.
- Follow DragonRuby naming conventions.

Syntax and Formatting
- Follow the Ruby Style Guide (https://rubystyle.guide/)
- Use Ruby's expressive syntax (e.g., unless, ||=, &.)
- Prefer single quotes for strings unless interpolation is needed.

Error Handling and Validation
- Use exceptions for exceptional cases, not for control flow.
- Implement proper error logging and user-friendly messages.

Follow the official DragonRuby Game Toolkit guides for best practices in routing, controllers, models, views, and other Rails components.

stack:

Ruby

DragonRuby Game Toolkit

Rails

DragonRuby Best Practices .cursorrules prompt file

Mathias Karstadt

Game Development .cursorrules strategies

Next.js React TypeScript .cursorrules prompt file

Next.js React TypeScript .cursorrules prompt file

Python .cursorrules Cursor AI with Ollama & Langchain .cursorrules prompt file

Python .cursorrules Cursor AI with Ollama & Langchain .cursorrules prompt file

Unity Cursor AI C# .cursorrules prompt file

Unity Cursor AI C# .cursorrules prompt file

DragonRuby Best Practices .cursorrules prompt file

DragonRuby Best Practices .cursorrules prompt file

.cursorrules file Cursor AI Python FastAPI API

Python FastAPI Scalable API .cursorrules prompt file

Next.js React TypeScript .cursorrules prompt file

Go Backend Scalability .cursorrules prompt file

Angular TypeScript .cursorrules prompt file

React Native .cursorrules prompt file

Next.js 14 Supabase TailwindCSS .cursorrules prompt file

TypeScript Next.js Tailwind .cursorrules prompt file

Vue.js 3 TypeScript Vite Tailwind .cursorrules prompt file

TypeScript Tailwind Next.js SSR .cursorrules prompt file

.cursorrules file Cursor AI Python FastAPI API

Next.js React TypeScript .cursorrules prompt file

Python FastAPI Scalable API .cursorrules prompt file

HTML Tailwind CSS JavaScript .cursorrules prompt file

PyQt6 EEG Processing .cursorrules prompt file

Cursor Tip

Here is a quick example of leveraging the .cursorrules file (syst

Cursor Tip

Cursor Tip

Cursor Tip

Build ChatGPT with Python: Cursor AI Tutorial Guide

Create a Chrome Extension Fast: Cursor AI Tutorial

Build AI Voice Notes App: Cursor AI Tutorial Guide

Cursor AI Tutorial: Easy Loading Page with Shadcn Components