dsh-always-apply

description: "Opt-in project-rules consumer that loads Cursor-aligned .dsh/rules files into the rules:project system-prompt section." kind: "package-bundle"

@firefly0621/dsh-always-apply

English | 中文

Summary

Opt-in project-rules consumer: loads Cursor-aligned .dsh/rules/**/*.mdc files into the rules:project system-prompt section.

Table of Contents

• Summary
• Model Experience
• Known Limitations and Deferred Work
• Dev Note

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. That patch also inserts the browser Settings「规则」panel (@firefly0621/dsh-client-ui-settings-rules); that client package is a dependency of this host plugin so one install resolves both Loader rows.

Rule files

Place .mdc files under /.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.

Version compatibility

This bundle declares peerDependencies on @deepseek-ai/dsh-* packages. DSH checks those ranges against the running runtime at install and profile startup; an incompatible pair is refused unless the profile grants an exact package@version × dsh-version exemption. Source-workspace workspace:* peers mean the matching DSH release; packed manifests substitute that exact version. See the plugin manager's compatibility reference for version-exemptions, allow-version, and the crash/data-loss risk.

Model Experience

Project rules section

What the model sees

When non-empty: a rules:project system-prompt section with a short reminder and ` / ` 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

• No runtime invariant companion is published; this package listens on system-prompt/assemble and derives injection from on-disk .mdc rules, with no independently observable durable relation beyond that consumer behavior.
• 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.

Dev Note

The package owns rule discovery, matching, and prompt rendering. The Settings page is a separate client package that edits the same files through the host remote API.