dsh-architecture-mentor

An installable DSH agent preset that turns real engineering work into adaptive architecture-learning experiences. The workspace is not a course: it is a mentor with persistent state, evidence-gated capability calibration, and a lean set of strategy and state skills.

Status: V1 implemented. npm stable 0.1.4 published. Pilot validation deferred by the owner.

What is included

• One-command installer (scripts/install.mjs) that copies preset/ into the DSH user preset root.
• A preset composition (preset/agent.cordis.yml) trimmed from DSH standard.
• Workspace templates with five long-term memory record types, mentoring contract, and derived views.
• Six mentor skills: mentor-workspace-init plus five strategy/state skills.
• Same-source identity generation for the L0 persona and the workspace AGENTS.md.

Quick start

Install from npm (published)

npm exec --yes --package=dsh-architecture-mentor -- architecture-mentor-install

Or install globally:

npm i -g dsh-architecture-mentor
architecture-mentor-install

Install from source

# From this repository
node scripts/install.mjs

Then start a DSH session, select the preset named 架构导师, and let mentor-workspace-init initialize a learning workspace.

Updating an installed preset

npm exec --yes [email protected] -- architecture-mentor-install

The installer compares preset/VERSION with the installed preset. If the package is newer, it backs up the old preset and replaces it; if versions match, it is a no-op. To force a refresh from the same version, remove ~/.dsh/.agent-presets/architecture-mentor first.

Repository layout

| Path | Purpose | | --- | --- | | docs/architecture-mentor/ | Current design baselines (what should be). | | .agents/notes/ | Decision and implementation records (what was done and why). | | .agents/skills/ | Local maintenance skills for doc and program rot. | | preset/ | The installable agent preset. | | scripts/ | Installer, smoke test, and identity generator. |

For Chinese documentation, see README-zh.md.