Prompt Profiles for Coding Agents and IDE AI Tools

Starting state:
Express 4.x REST API. No authentication. All routes are currently public.
Files: /src/routes/users.ts, /src/routes/products.ts, /src/routes/public.ts

Target state:
JWT authentication applied to all /api/* routes.
/src/routes/public.ts and /health endpoint remain unauthenticated.
No new npm packages installed.

Allowed actions:
- Edit files in /src/middleware/ and /src/routes/ only
- Create /src/middleware/auth.ts if it does not exist

Forbidden actions:
- Do not modify /src/routes/public.ts
- Do not install packages
- Do not run database migrations
- Do not edit test files

Stop conditions:
- Stop before applying middleware to any route file; show me the middleware first
- Stop if any existing test fails after your changes

Only make changes directly requested.

File: src/components/UserProfile.tsx
Function: renderAvatarSection()
Current behavior: Renders a static placeholder image when user.avatar is null
Desired change: Fetch avatar from /api/users/{id}/avatar; show skeleton loader during fetch
Do not touch: Authentication logic, props interface, CSS classes
Language/version: TypeScript 5.x / React 18
Done when: Avatar loads from API on mount; skeleton shows during loading state; null avatar still renders placeholder

Starting state:
Next.js 14 app. /app/api/contact/route.ts exists but returns a 501 stub.
No email service configured.

Target state:
/app/api/contact/route.ts sends form submissions via Resend API.
Environment variable RESEND_API_KEY already exists in .env.local.

File scope:
- Edit: /app/api/contact/route.ts only
- Read: /app/contact/page.tsx (do not edit)

Stop conditions:
- Stop if RESEND_API_KEY is not found in process.env
- Stop before installing any new package

Ask before running terminal commands.

def calculate_compound_interest(
    principal: float,
    annual_rate: float,
    compounds_per_year: int,
    years: int
) -> float:
    """
    Calculate compound interest.

    Args:
        principal: Initial investment amount in dollars. Must be > 0.
        annual_rate: Annual interest rate as a decimal (e.g., 0.05 for 5%). Must be >= 0.
        compounds_per_year: Number of compounding periods per year. Must be >= 1.
        years: Number of years to compound. Must be >= 0.

    Returns:
        Final amount after compound interest as a float.

    Raises:
        ValueError: If principal <= 0 or compounds_per_year < 1 or years < 0.

    Example:
        >>> calculate_compound_interest(1000, 0.05, 12, 10)
        1647.01
    """
    # Copilot suggestion triggers here

Task: Research the top 5 open-source vector databases by GitHub stars (current).
Artifact: Return a markdown table with columns: Name, Stars, License, Embedding Support, Managed Cloud Option.
Autonomy: Search the web to find current data. Do not make assumptions about star counts — use live data only.
Stop: If any source is ambiguous or paywalled, note it in the table and move on.

Build a single-page contact form component.

Stack: React 18 + TypeScript + Tailwind CSS
Fields: Name (text), Email (email), Message (textarea), Submit button
Validation: All fields required; email format check; show inline error messages
On submit: POST to /api/contact — show success message or error message from response

Do NOT scaffold:
- Authentication
- Database or ORM
- Backend API route
- Routing or navigation
- Testing setup
- Deployment configuration

Deliverable: A single ContactForm.tsx component file only.

Starting state:
GitHub repo: org/backend-api, branch: main
Function: process_payment() in /src/payments/processor.py
Current issue: No retry logic on Stripe API timeout (raises exception on first failure)

Target state:
process_payment() retries up to 3 times on stripe.error.Timeout with exponential backoff (1s, 2s, 4s).
All existing tests pass. New unit tests cover retry behavior.

Filesystem scope:
- Read/write: /src/payments/processor.py, /tests/test_processor.py only
- Read only: /src/payments/stripe_client.py

Forbidden actions:
- Do not modify any file outside the listed scope
- Do not change function signatures or return types
- Do not install new packages
- Do not push to any branch; deliver a local diff only
- Do not modify environment configuration

Deliverable: A unified diff file ready for pull request review.