refactor: rewrite AGENTS.md around DevSpace’s product model

[Waishnav]

Summary

• Reframe the repo guidance around DevSpace as a local development execution layer for MCP hosts.
• Add a clearer product model, glossary, and security boundaries to keep terminology and responsibilities consistent.
• Expand operational guidance for diagnosing the right layer, verifying the real path, and tracing affected contracts.

Testing

• Not run (not requested)

Summary by CodeRabbit

• Documentation
  • Reorganized contributor guidance with product principles, terminology, and security boundaries.
  • Added troubleshooting guidance for diagnosing the correct layer and verifying real-world behavior.
  • Documented key project contracts, code locations, pull request practices, and design principles.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 330996ba-9b18-4aa5-b826-54513b78134c

📥 Commits

Reviewing files that changed from the base of the PR and between 8cd2fba and 781f2b1.

📒 Files selected for processing (1)

• AGENTS.md

---

📝 Walkthrough

Walkthrough

AGENTS.md was comprehensively rewritten to document DevSpace’s product model, terminology, security boundaries, debugging workflow, affected-contract checklist, contribution process, code locations, and project conventions.

Changes

Repository Guidance Rewrite

Layer / File(s)	Summary
Product model and security contracts AGENTS.md	Defines DevSpace principles and glossary terms, and clarifies filesystem containment, shell authority, path validation, and credential boundaries.
Debugging and affected-contract procedures AGENTS.md	Adds guidance for diagnosing the correct layer, verifying real execution paths, and auditing affected contracts across system boundaries.
Contribution and project conventions AGENTS.md	Documents pull request expectations, code locations, boundary-first navigation, and project taste principles.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Poem

A rabbit hops through docs anew,
With glossary leaves and guidance dew.
Boundaries marked, paths checked twice,
PR carrots arranged precise—
One tidy burrow, clear and nice.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/refactor-devspace-agentsmd

---

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.}

[greptile-apps]

Greptile Summary

Rewrites repository guidance to describe DevSpace’s product model and operating principles.

• Defines core concepts and a consistent glossary for workspaces, roots, tool surfaces, subagents, artifacts, and review checkpoints.
• Documents security boundaries, diagnostic layers, verification paths, affected contracts, contribution practices, and code ownership.

Confidence Score: 5/5

The documentation-only change appears safe to merge.

The revised guidance is consistent with the inspected workspace concepts and introduces no executable behavior or concrete misleading contract that requires correction.

Important Files Changed

Filename	Overview
AGENTS.md	Reorganizes contributor guidance around the product model, terminology, security boundaries, operational verification, and repository structure without changing executable behavior.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
    Host[MCP host] -->|workspace-scoped requests| Server[DevSpace MCP server]
    Server --> Boundary[Approved roots and workspace state]
    Server --> Adapter[Pi adapter]
    Adapter --> Tools[Files, search, shell, Git, processes]
    Server --> Workers[Bounded subagents]
    Server --> Outputs[Artifacts, widgets, review checkpoints]

Loading

_{Reviews (1): Last reviewed commit: "Refine AGENTS guidance for DevSpace arch..." | Re-trigger Greptile}