Cursor AI Assistant Rules for SurrealPilot Project
@alfgago/surreal-pilot
•
JavaScript development with testing and API development
prpm install @alfgago/surreal-pilot%0A-%20%20%20**Test%20structure**%3A%20Create%20comprehensive%20flow%20tests%20that%20don't%20require%20manual%20interaction%0A%0A%23%23%20%F0%9F%A4%96%20AI%20Agent%20Testing%0A%0A-%20%20%20**Claude%20Sonnet%204**%3A%20Current%20model%20is%20%60claude-sonnet-4-20250514%60%20(updated%20from%20%60claude-3-5-sonnet-20241022%60)%0A-%20%20%20**Agent%20configuration**%3A%20Both%20PlayCanvas%20and%20Unreal%20agents%20use%20Claude%20Sonnet%204%0A-%20%20%20**Testing%20approach**%3A%20Always%20verify%20API%20key%20availability%20before%20running%20full%20flow%20tests%0A-%20%20%20**Expected%20behavior**%3A%20Agents%20are%20configured%20via%20Vizra%20ADK%2C%20not%20Prism%20directly%0A%0A%23%23%20%F0%9F%A7%AA%20Testing%20Best%20Practices%0A%0A-%20%20%20**Headless%20automation**%3A%20All%20automated%20tests%20should%20run%20without%20requiring%20user%20interaction%0A-%20%20%20**API%20verification%20first**%3A%20Check%20%60%2Fapi%2Fproviders%60%20endpoint%20before%20running%20complex%20UI%20tests%0A-%20%20%20**Environment%20checks**%3A%20Verify%20API%20keys%20are%20configured%20before%20testing%20AI%20features%0A-%20%20%20**Screenshot%20strategy**%3A%20Take%20screenshots%20at%20each%20major%20step%20for%20debugging%20and%20verification%0A-%20%20%20**Error%20handling**%3A%20Always%20include%20proper%20error%20handling%20and%20informative%20console%20output%0A%0A%23%23%20%F0%9F%93%81%20File%20Structure%20Awareness%0A%0A-%20%20%20**Agents%20location**%3A%20%60app%2FAgents%2F%60%20(PlayCanvasAgent.php%2C%20UnrealAgent.php)%0A-%20%20%20**Enhanced%20agents**%3A%20%60app%2FAgents%2FEnhanced%2F%60%20(expert%20versions%20with%20more%20knowledge)%0A-%20%20%20**Knowledge%20base**%3A%20%60storage%2Fknowledge-base%2F%60%20(training%20data%20for%20agents)%0A-%20%20%20**Test%20results**%3A%20%60test-results%2F%60%20(screenshots%20and%20reports)%0A-%20%20%20**Puppeteer%20tests**%3A%20%60tests%2FPuppeteer%2F%60%20(UI%20automation%20tests)%0A%0A%23%23%20%F0%9F%94%A7%20Environment%20Configuration%0A%0A-%20%20%20**Laragon%20URL**%3A%20%60http%3A%2F%2Fsurreal-pilot.local%2F%60%20(not%20localhost)%0A-%20%20%20**Filament%20panel**%3A%20%60%2Fcompany%60%20route%20for%20admin%20access%0A-%20%20%20**API%20endpoints**%3A%20%60%2Fapi%2Fproviders%60%2C%20%60%2Fapi%2Fassist%60%2C%20%60%2Fapi%2Fchat%60%0A-%20%20%20**Storage%20check**%3A%20%60storage%2F%60%20directory%20for%20generated%20games%0A-%20%20%20**Package%20management**%3A%20Playwright%20in%20main%20project%2C%20Puppeteer%20in%20%60mcp-servers%2Fpuppeteer-mcp%2F%60%0A%0A%23%23%20%F0%9F%8E%AE%20Game%20Generation%20Testing%0A%0A-%20%20%20**Test%20prompts**%3A%20Use%20detailed%20game%20specifications%20with%20technical%20requirements%0A-%20%20%20**Expected%20output**%3A%20HTML5%20games%20with%20Canvas%2C%20JavaScript%2C%20physics%2C%20controls%0A-%20%20%20**Storage%20verification**%3A%20Check%20%60storage%2Ftest_build_*%2F%60%20for%20generated%20files%0A-%20%20%20**Screenshots**%3A%20Capture%20AI%20responses%20and%20any%20generated%20game%20previews%0A%0A%23%23%20%F0%9F%92%BB%20PowerShell%20Compatibility%0A%0A-%20%20%20**Command%20chaining**%3A%20Use%20%60%3B%60%20instead%20of%20%60%26%26%60%20for%20PowerShell%0A-%20%20%20**Directory%20changes**%3A%20Use%20separate%20commands%3A%20%60cd%20directory%60%20then%20%60command%60%0A-%20%20%20**Error%20handling**%3A%20Be%20aware%20of%20PowerShell-specific%20error%20messages%20and%20syntax%0A%0A%23%23%20%F0%9F%9A%A8%20Automation%20Reminders%0A%0A-%20%20%20**NEVER%20use%20%60--headed%60%20by%20default**%20-%20only%20when%20user%20explicitly%20requests%20visual%20debugging%0A-%20%20%20**ALWAYS%20run%20tests%20that%20complete%20automatically**%20without%20waiting%20for%20manual%20input%0A-%20%20%20**USE%20screenshots%20extensively**%20since%20headless%20mode%20doesn't%20show%20visual%20feedback%0A-%20%20%20**VERIFY%20API%20availability**%20before%20running%20complex%20AI%20interaction%20tests%0A-%20%20%20**HANDLE%20authentication%20flows**%20programmatically%20in%20tests%0A%0A%23%23%20%F0%9F%93%8A%20Testing%20Output%0A%0A-%20%20%20**Console%20logging**%3A%20Provide%20detailed%20step-by-step%20progress%20updates%0A-%20%20%20**Screenshot%20naming**%3A%20Use%20descriptive%20names%20like%20%60claude-01-homepage.png%60%0A-%20%20%20**Test%20reports**%3A%20Generate%20JSON%20reports%20with%20detailed%20results%0A-%20%20%20**Success%20metrics**%3A%20Track%20completion%20rates%2C%20API%20responses%2C%20generated%20content%0A%0A%23%23%20%F0%9F%94%84%20Common%20Test%20Patterns%0A%0A%60%60%60javascript%0A%2F%2F%20Correct%20headless%20test%20pattern%0Atest(%22should%20test%20feature%20automatically%22%2C%20async%20(%7B%20page%20%7D)%20%3D%3E%20%7B%0A%20%20%20%20await%20page.goto(%22http%3A%2F%2Fsurreal-pilot.local%2F%22)%3B%0A%20%20%20%20await%20page.screenshot(%7B%20path%3A%20%22test-results%2Fstep.png%22%20%7D)%3B%0A%20%20%20%20%2F%2F%20...%20automated%20assertions%0A%7D)%3B%0A%0A%2F%2F%20Avoid%3A%20Manual%20interaction%20tests%20that%20require%20user%20input%0A%2F%2F%20Avoid%3A%20--headed%20flag%20unless%20debugging%0A%2F%2F%20Avoid%3A%20Timeouts%20without%20proper%20error%20handling%0A%60%60%60%0A%0A%23%23%20%F0%9F%8E%AF%20Success%20Criteria%0A%0A-%20%20%20Tests%20run%20completely%20automatically%0A-%20%20%20No%20manual%20intervention%20required%0A-%20%20%20Clear%20visual%20documentation%20via%20screenshots%0A-%20%20%20Comprehensive%20error%20reporting%0A-%20%20%20Proper%20headless%20operation%20by%20default%0A){kind=link}
%0A-%20%20%20**Test%20structure**%3A%20Create%20comprehensive%20flow%20tests%20that%20don't%20require%20manual%20interaction%0A%0A%23%23%20%F0%9F%A4%96%20AI%20Agent%20Testing%0A%0A-%20%20%20**Claude%20Sonnet%204**%3A%20Current%20model%20is%20%60claude-sonnet-4-20250514%60%20(updated%20from%20%60claude-3-5-sonnet-20241022%60)%0A-%20%20%20**Agent%20configuration**%3A%20Both%20PlayCanvas%20and%20Unreal%20agents%20use%20Claude%20Sonnet%204%0A-%20%20%20**Testing%20approach**%3A%20Always%20verify%20API%20key%20availability%20before%20running%20full%20flow%20tests%0A-%20%20%20**Expected%20behavior**%3A%20Agents%20are%20configured%20via%20Vizra%20ADK%2C%20not%20Prism%20directly%0A%0A%23%23%20%F0%9F%A7%AA%20Testing%20Best%20Practices%0A%0A-%20%20%20**Headless%20automation**%3A%20All%20automated%20tests%20should%20run%20without%20requiring%20user%20interaction%0A-%20%20%20**API%20verification%20first**%3A%20Check%20%60%2Fapi%2Fproviders%60%20endpoint%20before%20running%20complex%20UI%20tests%0A-%20%20%20**Environment%20checks**%3A%20Verify%20API%20keys%20are%20configured%20before%20testing%20AI%20features%0A-%20%20%20**Screenshot%20strategy**%3A%20Take%20screenshots%20at%20each%20major%20step%20for%20debugging%20and%20verification%0A-%20%20%20**Error%20handling**%3A%20Always%20include%20proper%20error%20handling%20and%20informative%20console%20output%0A%0A%23%23%20%F0%9F%93%81%20File%20Structure%20Awareness%0A%0A-%20%20%20**Agents%20location**%3A%20%60app%2FAgents%2F%60%20(PlayCanvasAgent.php%2C%20UnrealAgent.php)%0A-%20%20%20**Enhanced%20agents**%3A%20%60app%2FAgents%2FEnhanced%2F%60%20(expert%20versions%20with%20more%20knowledge)%0A-%20%20%20**Knowledge%20base**%3A%20%60storage%2Fknowledge-base%2F%60%20(training%20data%20for%20agents)%0A-%20%20%20**Test%20results**%3A%20%60test-results%2F%60%20(screenshots%20and%20reports)%0A-%20%20%20**Puppeteer%20tests**%3A%20%60tests%2FPuppeteer%2F%60%20(UI%20automation%20tests)%0A%0A%23%23%20%F0%9F%94%A7%20Environment%20Configuration%0A%0A-%20%20%20**Laragon%20URL**%3A%20%60http%3A%2F%2Fsurreal-pilot.local%2F%60%20(not%20localhost)%0A-%20%20%20**Filament%20panel**%3A%20%60%2Fcompany%60%20route%20for%20admin%20access%0A-%20%20%20**API%20endpoints**%3A%20%60%2Fapi%2Fproviders%60%2C%20%60%2Fapi%2Fassist%60%2C%20%60%2Fapi%2Fchat%60%0A-%20%20%20**Storage%20check**%3A%20%60storage%2F%60%20directory%20for%20generated%20games%0A-%20%20%20**Package%20management**%3A%20Playwright%20in%20main%20project%2C%20Puppeteer%20in%20%60mcp-servers%2Fpuppeteer-mcp%2F%60%0A%0A%23%23%20%F0%9F%8E%AE%20Game%20Generation%20Testing%0A%0A-%20%20%20**Test%20prompts**%3A%20Use%20detailed%20game%20specifications%20with%20technical%20requirements%0A-%20%20%20**Expected%20output**%3A%20HTML5%20games%20with%20Canvas%2C%20JavaScript%2C%20physics%2C%20controls%0A-%20%20%20**Storage%20verification**%3A%20Check%20%60storage%2Ftest_build_*%2F%60%20for%20generated%20files%0A-%20%20%20**Screenshots**%3A%20Capture%20AI%20responses%20and%20any%20generated%20game%20previews%0A%0A%23%23%20%F0%9F%92%BB%20PowerShell%20Compatibility%0A%0A-%20%20%20**Command%20chaining**%3A%20Use%20%60%3B%60%20instead%20of%20%60%26%26%60%20for%20PowerShell%0A-%20%20%20**Directory%20changes**%3A%20Use%20separate%20commands%3A%20%60cd%20directory%60%20then%20%60command%60%0A-%20%20%20**Error%20handling**%3A%20Be%20aware%20of%20PowerShell-specific%20error%20messages%20and%20syntax%0A%0A%23%23%20%F0%9F%9A%A8%20Automation%20Reminders%0A%0A-%20%20%20**NEVER%20use%20%60--headed%60%20by%20default**%20-%20only%20when%20user%20explicitly%20requests%20visual%20debugging%0A-%20%20%20**ALWAYS%20run%20tests%20that%20complete%20automatically**%20without%20waiting%20for%20manual%20input%0A-%20%20%20**USE%20screenshots%20extensively**%20since%20headless%20mode%20doesn't%20show%20visual%20feedback%0A-%20%20%20**VERIFY%20API%20availability**%20before%20running%20complex%20AI%20interaction%20tests%0A-%20%20%20**HANDLE%20authentication%20flows**%20programmatically%20in%20tests%0A%0A%23%23%20%F0%9F%93%8A%20Testing%20Output%0A%0A-%20%20%20**Console%20logging**%3A%20Provide%20detailed%20step-by-step%20progress%20updates%0A-%20%20%20**Screenshot%20naming**%3A%20Use%20descriptive%20names%20like%20%60claude-01-homepage.png%60%0A-%20%20%20**Test%20reports**%3A%20Generate%20JSON%20reports%20with%20detailed%20results%0A-%20%20%20**Success%20metrics**%3A%20Track%20completion%20rates%2C%20API%20responses%2C%20generated%20content%0A%0A%23%23%20%F0%9F%94%84%20Common%20Test%20Patterns%0A%0A%60%60%60javascript%0A%2F%2F%20Correct%20headless%20test%20pattern%0Atest(%22should%20test%20feature%20automatically%22%2C%20async%20(%7B%20page%20%7D)%20%3D%3E%20%7B%0A%20%20%20%20await%20page.goto(%22http%3A%2F%2Fsurreal-pilot.local%2F%22)%3B%0A%20%20%20%20await%20page.screenshot(%7B%20path%3A%20%22test-results%2Fstep.png%22%20%7D)%3B%0A%20%20%20%20%2F%2F%20...%20automated%20assertions%0A%7D)%3B%0A%0A%2F%2F%20Avoid%3A%20Manual%20interaction%20tests%20that%20require%20user%20input%0A%2F%2F%20Avoid%3A%20--headed%20flag%20unless%20debugging%0A%2F%2F%20Avoid%3A%20Timeouts%20without%20proper%20error%20handling%0A%60%60%60%0A%0A%23%23%20%F0%9F%8E%AF%20Success%20Criteria%0A%0A-%20%20%20Tests%20run%20completely%20automatically%0A-%20%20%20No%20manual%20intervention%20required%0A-%20%20%20Clear%20visual%20documentation%20via%20screenshots%0A-%20%20%20Comprehensive%20error%20reporting%0A-%20%20%20Proper%20headless%20operation%20by%20default%0A){kind=link}
0 total downloads
💡 Suggested Test Inputs
Loading suggested inputs...
🎯 Community Test Results
Loading results...
📦 Package Info
- Format
- cursor
- Type
- rule
- Category
- testing
🔗 Links
- Repository
- https://github.com/alfgago/surreal-pilot