docs(agents): clarify Superset workspace context

[saddlepaddle]

Summary

• Add a one-line note to AGENTS.md explaining that agents run inside an isolated Superset workspace (git-worktree copy of the repo), so "workspace" in user messages refers to this — not editor workspaces.

Test plan

• AGENTS.md renders cleanly

---

Summary by cubic

Clarifies that agents run inside an isolated Superset workspace (git-worktree copy of the repo), not an editor workspace, and front-loads verbs in the superset skill description for clearer intent and better trigger matching.

^{Written for commit 10b8cb7. Summary will update on new commits.}

Summary by CodeRabbit

• Documentation
  • Clarified that "workspace" refers to the isolated Superset git-worktree context in AGENTS docs.
  • Reworded the Superset skill description for improved clarity; workflow and usage details unchanged.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 9e402fd4-acce-4a45-bcbe-2f745baa2b3b

📥 Commits

Reviewing files that changed from the base of the PR and between 84e6472 and 10b8cb7.

📒 Files selected for processing (1)

• skills/superset/SKILL.md

✅ Files skipped from review due to trivial changes (1)

• skills/superset/SKILL.md

---

📝 Walkthrough

Walkthrough

This PR clarifies "workspace" in AGENTS.md as an isolated git-worktree copy of the repo and updates the description frontmatter sentence in skills/superset/SKILL.md.

Changes

Workspace & Skill Documentation

Layer / File(s)	Summary
Workspace Clarification AGENTS.md	Inserted definition of "workspace" as an isolated git-worktree copy of the repo under the Superset Monorepo Guide.
Skill Frontmatter skills/superset/SKILL.md	Replaced the description frontmatter line with a new sentence describing creating workspaces, spawning agents, scheduling automations, and managing Superset via the superset CLI.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~1 minute

Poem

I nibble on docs in a quiet burrow,
Clarifying "workspace" so none shall sorrow,
A skill's description trimmed and bright,
Worktrees tidy, instructions light,
Hooray for clear guides on this soft night! 🐰✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main change: adding clarification about Superset workspace context to the AGENTS.md documentation.
Description check	✅ Passed	The description includes a clear summary of changes and a test plan, but deviates from the template structure by omitting required sections like 'Related Issues' and 'Type of Change'.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch add-superset-workspace-no

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[greptile-apps]

Greptile Summary

This PR adds a one-line context note to AGENTS.md clarifying that the agent is executing inside an isolated git-worktree copy of the repo, and that "workspace" in user messages refers to this environment — not VS Code or other editor workspaces.

• The new sentence is placed immediately after the top-level heading, making it the first thing an agent reads, which is appropriate given its role as a disambiguation note.
• No code, configuration, or functional behavior is changed; the edit is purely additive documentation.

Confidence Score: 5/5

Documentation-only change; safe to merge.

The change adds a single clarifying sentence to AGENTS.md with no impact on any code path, configuration, or runtime behavior. There is nothing here that could introduce a regression.

No files require special attention.

Important Files Changed

Filename	Overview
AGENTS.md	Adds a single clarifying sentence after the H1 header explaining that agents run in an isolated git-worktree and that "workspace" refers to that environment, not editor workspaces.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["Agent reads AGENTS.md"] --> B["Sees workspace clarification note"]
    B --> C{"User message contains 'workspace'?"}
    C -- Yes --> D["Interprets as git-worktree copy of repo"]
    C -- No --> E["Proceeds normally"]
    D --> F["Correct context applied"]

Loading

_{Reviews (1): Last reviewed commit: "docs(agents): clarify Superset workspace..." | Re-trigger Greptile}

[cubic-dev-ai]

No issues found across 1 file

[github-actions]

🚀 Preview Deployment

🔗 Preview Links

Service	Status	Link
Database (Neon)	✅	View Branch
API (Vercel)	✅	Open Preview
Web (Vercel)	✅	Open Preview
Marketing (Vercel)	✅	Open Preview
Admin (Vercel)	✅	Open Preview
Docs (Vercel)	✅	Open Preview

---

Preview updates automatically with new commits