docs(architecture): align Studio docs with current boundaries

.github/copilot-instructions.md

@@ -18,12 +18,16 @@
 3. Run relevant tests/lint and verify startup path when behavior changes.
 
 ## Key paths
-- `src/sage/studio/cli.py`, `chat_manager.py`, `config/backend/api.py`, `frontend/src/`.
+- `src/sage/studio/cli.py`
+- `src/sage/studio/api/app.py`
+- `src/sage/studio/application/studio_manager.py`
+- `src/sage/studio/services/`
+- `src/sage/studio/frontend/src/`
 
 ## Polyrepo coordination (mandatory)
 
 - This repository is an independent SAGE sub-repository and is developed/released independently.
-- Do not assume sibling source directories exist locally in `intellistream/SAGE`.
+- Do not assume sibling source directories exist locally in the SAGE umbrella repository.
 - For cross-repo rollout, publish this repo/package first, then bump the version pin in `SAGE/packages/sage/pyproject.toml` when applicable.
 - Do not add local editable installs of other SAGE sub-packages in setup scripts or docs.
 

.github/workflows/ci-test.yml

@@ -17,6 +17,9 @@ on:
     paths:
       - 'src/**'
       - 'tests/**'
+      - 'docs/**'
+      - 'README.md'
+      - 'CONTRIBUTING.md'
       - 'pyproject.toml'
       - '.github/workflows/ci-test.yml'
 
@@ -27,6 +30,9 @@ on:
     paths:
       - 'src/**'
       - 'tests/**'
+      - 'docs/**'
+      - 'README.md'
+      - 'CONTRIBUTING.md'
       - 'pyproject.toml'
       - '.github/workflows/ci-test.yml'
 

CONTRIBUTING.md

@@ -8,28 +8,28 @@ SAGE Studio is part of the SAGE ecosystem. For development:
 
 1. **Clone the repository**:
 ```bash
-git clone https://github.com/intellistream/sage-studio.git
+git clone https://github.com/SAGE-Research/sage-studio.git
 cd sage-studio
 ```
 
 2. **Install dependencies**:
 ```bash
-pip install -e ".[dev,full]"
+python -m pip install -e ".[dev,full]"
 ```
 
 3. **Install SAGE core dependencies** (if needed):
 ```bash
-pip install isage-common isagellm
+python -m pip install isage-common isagellm
 ```
 
 ## Architecture
 
 SAGE Studio is built on top of SAGE's inference framework and follows the SAGE architecture:
 
 - **Frontend**: React + TypeScript + Vite
-- **Backend**: FastAPI (integrated with sage-llm-gateway)
-- **Backend**: FastAPI (Studio backend + Gateway integration)
-- **Integration**: Uses SAGE Control Plane for LLM orchestration
+- **Backend**: FastAPI application in `sage.studio.api.app`
+- **Services**: visual flow registry, construction, persistence, and execution
+- **Integration**: SAGE and SageLLM are consumed through their public package APIs
 
 ## Docs Consistency Checklist
 
@@ -78,9 +78,9 @@ We follow Conventional Commits:
 
 ## Community
 
-- Main SAGE Repository: https://github.com/intellistream/SAGE
+- SAGE Research organization: https://github.com/SAGE-Research
 - Documentation: https://intellistream.github.io/sage-docs/
-- Issues: https://github.com/intellistream/sage-studio/issues
+- Issues: https://github.com/SAGE-Research/sage-studio/issues
 
 ## License