Skip to content

docs(repo): add Cursor Cloud specific instructions to AGENTS.md#59

Closed
Gsbreddy wants to merge 1 commit into
mainfrom
cursor/env-setup-agents-md-9058
Closed

docs(repo): add Cursor Cloud specific instructions to AGENTS.md#59
Gsbreddy wants to merge 1 commit into
mainfrom
cursor/env-setup-agents-md-9058

Conversation

@Gsbreddy
Copy link
Copy Markdown
Collaborator

Summary

Adds a ## Cursor Cloud specific instructions section to AGENTS.md with non-obvious caveats for future Cloud Agent sessions.

Why

Future Cursor Cloud agents need to know how to run lint/tests/build/serve without re-discovering environment-specific gotchas every session (e.g. Playwright requiring FLIGHTDECK_E2E_PYTHON, flightdeck serve needing an initialized workspace).

Changes

  • Added service table (CLI, HTTP server, web dev server)
  • Added quick-reference commands for lint, test, smoke, web build, and Playwright e2e
  • Documented non-obvious caveats:
    • Playwright e2e needs FLIGHTDECK_E2E_PYTHON pointed at the venv Python
    • flightdeck serve requires a flightdeck.yaml workspace
    • PostgreSQL tests are auto-skipped without env var
    • Static bundle is committed and must be rebuilt after web/ changes

Validation

  • uv sync --frozen --extra dev
  • uv run python -m ruff check src tests
  • uv run python -m pytest
  • uv run flightdeck-quickstart-verify
  • uv run flightdeck --help
  • cd web && npm ci && npm run build && cd .. && git diff --exit-code src/flightdeck/server/static/
  • cd web && FLIGHTDECK_E2E_PYTHON=/workspace/.venv/bin/python npm run test:e2e

Schema / Storage Impact

  • None

Risk

Docs-only change, no code impact.

Review

  • Requested review from maintainers
  • PR is small and scoped

Notes

All verification commands pass: 139 pytest tests (83% coverage), 18 Playwright e2e tests, ruff clean, quickstart smoke OK.

Open in Web Open in Cursor 

Co-authored-by: Gottam Sai Bharath <Gsbreddy@users.noreply.github.com>
@Gsbreddy Gsbreddy marked this pull request as ready for review May 26, 2026 17:17
@Gsbreddy Gsbreddy added the duplicate This issue or pull request already exists label Jun 1, 2026
@Gsbreddy Gsbreddy closed this Jun 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

duplicate This issue or pull request already exists

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants