nadvolod

AGENTS.md

This file is the operating contract for any agent or engineer making changes in this repo.

The goal is simple: ship fast, prove correctness, protect production, and save developer time.

If a rule here conflicts with common sense, surface the conflict in the PR instead of pretending not to notice it.

Core Principles

nadvolod

Clean Code — Patterns & Anti-Patterns (LLM Coding Assistant Guidelines)

Based on Clean Code by Robert C. Martin (summarized). Use this as a checklist when proposing or reviewing code.

---

✅ Core Principles (Patterns)

• Expressive naming
• Use intention-revealing, precise names (elapsedMs, not d).

nadvolod

Vision Board Bliss - Requirements Document

Overview

Vision Board Bliss is a web-based application that allows users to create, manage, and track personal goals through visual vision boards. The application combines goal management with achievement tracking and social sharing capabilities.

Core Features

1. User Authentication & Management

• Sign Up/Login: Email-based authentication via Supabase Auth
• User Sessions: Persistent authentication with secure session management

nadvolod

test('XPath as syntax vs locator strategy', async ({ page }) => {
  await page.goto('https://example.com/app');

  // ✅ Test ID strategy - using XPath syntax
  await page.locator('//button[@data-testid="submit-order"]').click();
  
  // ✅ Test ID strategy - using CSS syntax  
  await page.locator('[data-testid="submit-order"]').click();
  
  // ✅ Accessibility strategy - using XPath syntax

nadvolod

Project Development Guidelines

Automated Testing Guidelines

Test Scope

• Only create positive tests unless explicitly requested to add negative tests or edge cases
• Focus on happy path scenarios that verify features work as expected
• One positive test per feature is sufficient unless more comprehensive testing is specifically requested

Test Execution

nadvolod

// ❌ duplicate test name
for (const user of testUsers) {
  test(`GET users`, async({request}) => {
    const response = await request.get(`https://jsonplaceholder.typicode.com/posts/${user.id}`)
    // assertions here
  })
}

// ✅ each test within a describe block has a unique name
for (const user of testUsers) {

nadvolod

// Data-driven test that runs once for each data entry
test.describe('Login functionality', () => {
    test(`Login as ${user.username}`, async ({ page }) => {
      // Navigate to login page
      await page.goto('https://example.com/login');
      
      // Fill the form
      //{ username: 'standardUser', password: 'secret1', expectedPage: '/dashboard' }
      //{ username: 'adminUser', password: 'admin123', expectedPage: '/admin' },
      await page.fill('input[name="username"]', user.username);

nadvolod

(base) nikks-mbp:platform nikolay$ pnpm create wdio@latest .

                 -:...........................-:.
                 +                              +
              `` +      `...`        `...`      + `
            ./+/ +    .:://:::`    `::///::`  ` + ++/.
           .+oo+ +    /:+ooo+-/    /-+ooo+-/ ./ + +oo+.
           -ooo+ +    /-+ooo+-/    /-+ooo+-/ .: + +ooo.
            -+o+ +    `::///:-`    `::///::`    + +o+-
             ``. /.     `````        `````     .: .``

nadvolod

          <AccordionEntry label="Error" variant="error">
            <div className="whitespace-pre-wrap break-words">
              {testResult.error.message}
            </div>
          </AccordionEntry>

nadvolod

# Status - quick overview
git config --global alias.st status
git config --global alias.s "status -s"

# Committing
git config --global alias.co commit
git config --global alias.cm "commit -m"
git config --global alias.ca "commit --amend"

# Branch management