Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 13 additions & 3 deletions .cursor/commands/scaffold.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,9 +26,19 @@ Read `ramp-kit/conventions/rules.yaml`. Blocking ids for this contribution:
SCHED001, SCHED002, SCHED003, REPRO001, DEVICE001, DEPR001, MUT001, TEST001,
TEST002.

Read root `AGENTS.md` (and `.ai/` only as that guide directs). The templates
already satisfy the overlay registry. Library CI (`make style` / `make quality`
/ copies / dummies) is also required before the PR.
Read root `AGENTS.md` and `.ai/` (library guide / review-rules / skills). Do
not overwrite them. Also read the reference source those files name. Optional
keyword search of this checkout's docs:

```bash
python3 ramp-kit/tools/docs_mcp_server.py --query "set_timesteps"
```

That CLI is a fallback, not a deliverable. Default `.cursor/mcp.json` has no
servers.

The templates already satisfy the overlay registry. Library CI (`make style` /
`make quality` / copies / dummies) is also required before the PR.

Stay inside `.cursorignore`. Do not read or copy
`ramp-kit/examples/candidate_scheduler/`.
Expand Down
8 changes: 3 additions & 5 deletions .cursor/commands/search-docs.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# /search-docs — library docs in THIS checkout (optional)
# /search-docs — optional keyword search of THIS checkout's docs

Usage: `/search-docs <query>`

Prefer `ramp-kit/conventions/rules.yaml` + the gate. MCP is stdio
`diffusers-docs` (Cloud dropdown: `diffusers-docs-mcp`). No Hub HTTP.
Prefer `ramp-kit/conventions/rules.yaml`, root `AGENTS.md`, `.ai/`, and the
reference source those files name. Default `.cursor/mcp.json` has no servers.

```bash
python3 ramp-kit/tools/docs_mcp_server.py --query $1
Expand All @@ -14,5 +14,3 @@ If `$1` is empty:
```bash
python3 ramp-kit/tools/docs_mcp_server.py --query "scheduler set_timesteps step SchedulerMixin register_to_config"
```

If the MCP tool `search_docs` is in your list, call that instead.
7 changes: 0 additions & 7 deletions .cursor/environment.json
Original file line number Diff line number Diff line change
@@ -1,13 +1,6 @@
{
"install": "if [ ! -d ramp-kit/.git ]; then git clone --depth 1 https://github.com/alex-16moro/diffuser_agent.git ramp-kit; fi && bash ramp-kit/.cursor/cloud-install.sh",
"start": "bash ramp-kit/.cursor/install-docs-mcp.sh",
"repositoryDependencies": [
"github.com/alex-16moro/diffuser_agent"
],
"mcpServerAllowlist": [
{
"name": "diffusers-docs",
"command": "diffusers-docs-mcp"
}
]
}
97 changes: 0 additions & 97 deletions .cursor/mcp-diffusers-docs.py

This file was deleted.

5 changes: 0 additions & 5 deletions .cursor/mcp-diffusers-docs.sh

This file was deleted.

13 changes: 1 addition & 12 deletions .cursor/mcp.json
Original file line number Diff line number Diff line change
@@ -1,12 +1 @@
{
"mcpServers": {
"diffusers-docs": {
"type": "stdio",
"command": "python3",
"args": ["-u", ".cursor/mcp-diffusers-docs.py"],
"env": {
"PYTHONUNBUFFERED": "1"
}
}
}
}
{"mcpServers":{}}
15 changes: 0 additions & 15 deletions .cursor/mcp.optional.json

This file was deleted.

5 changes: 3 additions & 2 deletions .cursor/rules/00-conventions.mdc
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,9 @@ code that violates a **block** rule will fail the build.
The first contribution is what `conventions/rules.yaml` checks. Copy the
templates (`/scaffold`) and stop at 0 blocking findings from
`tools/convention_check.py` on the new files. Do not add files the
registry does not scan. Docs search (`search_docs` / `/search-docs`) is
optional and is not a deliverable.
registry does not scan. Ground in this registry and, on the library,
`.ai/` plus reference source. Optional:
`python3 tools/docs_mcp_server.py --query "..."` — not a deliverable.

Do not pull in code or context from outside this repo's approved
boundaries (see `.cursorignore`).
Expand Down
7 changes: 3 additions & 4 deletions .cursor/skills/search-docs/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: search-docs
description: Optional docs CLI for this diffusers checkout. Prefer the gate; MCP is stdio search_docs.
description: Optional docs CLI for this diffusers checkout. Prefer AGENTS.md, .ai/, and the gate. Default mcp.json has no servers.
---

# Search this library's docs
Expand All @@ -10,6 +10,5 @@ python3 ramp-kit/tools/docs_mcp_server.py --query "<the question>"
```

Cite provenance (`diffusers checkout` vs bundled snapshot).
`ramp-kit/conventions/rules.yaml` is the gate.
`.cursor/mcp.json` is stdio `diffusers-docs` only (no Hub HTTP).
Cloud dropdown: `diffusers-docs-mcp`.
`ramp-kit/conventions/rules.yaml` is the gate. Root `AGENTS.md` and `.ai/`
are the library guide. Default `.cursor/mcp.json` has no servers.
11 changes: 5 additions & 6 deletions OVERLAY.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,13 +31,12 @@ The first contribution:

Do not copy `ramp-kit/examples/candidate_scheduler/`.

`.cursor/mcp.json` ships **stdio `diffusers-docs` only** (`python3 -u
.cursor/mcp-diffusers-docs.py`). Do not enable Hub HTTP MCP (OAuth). Cloud
dropdown: `diffusers-docs-mcp` (PATH shim from `install-docs-mcp.sh`) or the
same python3 command. The launcher finds `ramp-kit/tools/docs_mcp_server.py`
from `/agent` as well as the repo root.
Default `.cursor/mcp.json` is `{"mcpServers":{}}`. Ground in root `AGENTS.md`,
`.ai/`, and the reference source those files name. Optional keyword search:

Hub HTTP and extra servers stay in `.cursor/mcp.optional.json`.
```bash
python3 ramp-kit/tools/docs_mcp_server.py --query "set_timesteps"
```

## Demo (Cloud Agent)

Expand Down
Loading