[docs] Consolidate developer specifications into instructions file (v9.4)

[github-actions]

Developer Documentation Consolidation

This PR consolidates markdown specifications from the scratchpad/ directory into the unified scratchpad/dev.md file (v9.3 → v9.4) and applies tone fixes to spec sources.

Summary

• Spec files analyzed: 64 (62 root spec files + agents/ + mods/ subdirectories)
• Tone issues fixed: 2 in scratchpad/mdflow.md
• New spec files since v9.3: 0
• Mermaid diagrams added: 0 (existing diagrams in dev.md retained)
• Files modified: 2 (scratchpad/mdflow.md, scratchpad/dev.md)

Tone Adjustments Made

scratchpad/mdflow.md

• Line 263 — replaced promotional framing with mechanism-focused description:

  • Before: **Strength**: Context gathering is a first-class feature, not an afterthought.
  • After: **Strength**: Context gathering is built into the core syntax through declarative \imports:` resolution.`

• Line 301 — replaced anthropomorphic phrasing with concrete runtime description:

  • Before: **Strength**: Workflows are first-class GitHub citizens, not external scripts.
  • After: **Strength**: Workflows compile to native GitHub Actions YAML and run inside the GitHub Actions runtime, not as external scripts.

Files Modified

• scratchpad/mdflow.md — 2 tone fixes
• scratchpad/dev.md — version bumped 9.3 → 9.4, last-updated date 2026-05-08 → 2026-05-09, document history extended with v9.4 entry

Validation

• Markdown structure preserved
• Existing Mermaid diagrams unchanged
• Code-fence language tags unchanged
• Document history continues unbroken from v9.3
• Coverage statistic remains 63 spec files (no new files since v9.3)

Review Notes

Please review:

1. The two replaced sentences in scratchpad/mdflow.md (sections "Context Gathering" and "GitHub Native Integration") for accuracy and tone
2. The v9.4 entry appended to the document history block at the bottom of scratchpad/dev.md

References

• Workflow run: §25602801119

Generated by Developer Documentation Consolidator · ● 15.8M · ◷

• expires on May 11, 2026, 2:02 PM UTC