dsh-dev-standards

Scaffold and enforce a full, deepseek-harness-style development standard in any project: AGENTS.md standing orders, a decision-record (ADR) lifecycle, a documentation hierarchy, a prose standard (contracts, not reasoning transcripts), test tiers, and machine-checked gates.

This repository is both a Codex/dsh skill (SKILL.md) and a scaffold kit (scripts/) that injects the standard into a target repository.

Install

• Codex: clone or copy this folder to ~/.codex/skills/dsh-dev-standards (a junction works too) so Codex auto-discovers it.
• dsh: ~/.agents/skills is the user-level skill root; place the folder there. For project-scoped availability, copy or junction it into <project>/.agents/skills/dsh-dev-standards.
• Cursor: Cursor does not load skills; it reads AGENTS.md per project, so use the scaffolded files.

Use

Ask Codex "set up development standards in this project", or run:

node scripts/scaffold.mjs --target <project-root> --name "<Project Name>"

The scaffold creates:

• AGENTS.md — standing orders
• docs/AGENTS.md — documentation standard; docs/testing.md — test tiers
• decisions/ — proposed/ implemented/ rejected/ archived/ with per-lifecycle TEMPLATE.md
• scripts/check-md-links.mjs and scripts/verify-adr-format.mjs — machine-checked gates

Wire the gates into pre-push or CI:

node scripts/check-md-links.mjs
node scripts/verify-adr-format.mjs

Every non-trivial change in the project carries a decision record, a doc update, and test/snapshot evidence; prose states contracts, not reasoning transcripts.

Layout

• SKILL.md — trigger description and workflow
• assets/templates/ — scaffold templates with {{PROJECT_NAME}} placeholders
• references/ — the six meta-principles, ADR rules, prose standard, engineering rules, testing and gates, review process
• scripts/ — scaffold.mjs, check-md-links.mjs, verify-adr-format.mjs

Update

This repository is the source of truth. Edit the skill here, then git add -A, git commit, git push. Installed copies (the Codex junction, the dsh-goldfinger copy) must be synced or re-cloned.