@firefly0621/dsh-always-apply

English | 中文

Opt-in Cordis consumer that loads Cursor-aligned project rules from .dsh/rules/**/*.mdc and injects them into the system prompt. Cordis plugin name: rules. Prompt section: rules:project.

This package does not read skills or depend on ctx.skills. Mount it when you want project rules; install with:

dsh plugin --profile web add @firefly0621/dsh-always-apply

Or insert the shipped cordis.patch.yml into a custom base. The browser Settings「规则」panel (@firefly0621/dsh-client-ui-settings-rules) is a dependency of this package, so one install brings the host plugin and the settings page together.

Rule files

Place .mdc files under <session cwd>/.dsh/rules/ (override with Config rulesDir). Each file needs YAML frontmatter:

| alwaysApply | globs | Type | |---|---|---| | true | * | Always Apply — full body every assemble | | false | non-empty | Specific Files — body when an in-context path matches | | false | empty | Inactive — stored on disk but not auto-attached |

Only alwaysApply: true classifies as Always Apply. alwaysApply: false without globs is never treated as always.

---
alwaysApply: true
description: Repo-wide constraints
---

Keep rules short and actionable.

Bodies must not contain complete {{...}} prompt-variable groups (skipped with a warning).

Behavior

On every system-prompt/assemble:

1. Skip agentless assemblies and subagent sessions by default (skipSubagent).
2. Load .mdc rules from the resolved rules root (cached; invalidated on Settings write/delete and on external edits when watchRules is enabled).
3. Auto-attach Always bodies and Specific bodies whose globs match v1 in-context paths (tool read/write/edit file_path values ∪ path tokens in user message text).
4. Honor maxTotalBytes for the complete auto-attached section text (drop Specific before Always when over budget).

Also registers:

• projectRules Typert remote — list / read / write / delete for Settings and host callers.

Config

| Field | Default | Meaning | |---|---|---| | rulesDir | .dsh/rules | Relative directory under the session workspace root; absolute paths and .. are rejected. | | skipSubagent | true | Skip subagent-origin sessions. | | maxTotalBytes | 100000 | UTF-8 length of the complete auto-attached section text (reminder + bodies + framing as rendered). | | watchRules | true | Watch each accessed rules root and invalidate the cache on external .mdc edits (debounced). | | watchDebounceMs | 100 | Watcher debounce window in milliseconds before cache invalidation. | | defaultWorkspaceRoot | (empty) | Absolute workspace root used when no session workspace is available. Enables the Settings UI to manage rules without an active session. Must be an absolute path. |

Model Experience

Project rules section

What the model sees

When non-empty: a rules:project system-prompt section with a short reminder and <auto_attached_rules> / <rule_content> blocks for all auto-attached rules (Always and matching Specific).

Token effect

One section re-sent each request while rules and in-context matches stay within budget.

KV Cache effect

Prefix reuse holds while the rendered section text is unchanged; a rules-file write, delete, or Specific match set change recomposes the section.

Known Limitations and Deferred Work

• Opt-in only — product defaults do not mount this plugin.
• No .cursor/rules import — storage is .dsh/rules only.
• In-context paths are incomplete vs Cursor IDE — no open-editor inventory on the web host; Specific matching uses tool-touched paths and user-text path tokens only.
• A complete persona replaces every section — presets with a complete persona suppress this section for that agent.
• Typert client artifacts — the gateway registers at runtime; web Settings must compose a client that can call projectRules once the remote is on the host API surface.