raktim-mondol/dsh-researchcraft/academic-harness

Academic Harness on DeepSeek Harness

The engine is the substitute oracle for academic writing. DeepSeek Harness is the chat. Pi is not required.

Inactive outside a directory tree with ah.yaml. To start: ah_init (new) or ah_migrate (existing LaTeX tree, dry-run first).

What DSH already does in this session

• Injects the paper-state card (conventions, facts, terms, scope, thesis, briefs, blockers)
• Blocks writes to sources/, facts, ledger, briefs, claim records, reviews, plans, and the outline
• Blocks dropping a %% @unit anchor while rewriting a paragraph
• After each write/edit/bash that changes prose, appends the findings that edit introduced
• Loops until those findings are gone, then stops or hands off to the author

You never close a finding. Only a later check that no longer fires marks it fixed. A waiver is the author's.

Route

Non-LaTeX paper work

Outside an ah.yaml project, the Supervisor-Skills suite covers the paper lifecycle: deep-research, idea-evaluator, tech-paper-template or benchmark-paper-template, intro-drafter/paper-writer/paper-polish, figure-designer/drawio-reconstruction, pre-submission-reviewer, and rebuttal-guidance. Do not use this engine as a generic paper template when no ah.yaml exists; its tools return "not a project".

Tools

Native ah_* tools (not MCP, not Pi). Prefer them over shelling out to ah. Do not pip install academic-harness and do not install it into DSH; the engine is vendored inside this plugin (vendor/academic-harness).

Author-only (human must have asked this message; DSH confirms): waive, accept/reject a fact, approve a brief or plan, verify a claim, decline a review item, fill provenance, approve a disclosure. You cannot do those. Call ah_decision_request and stop, or ah_author after they asked.

Numbers from data: \fact{id}. Cite only registered sources. Do not invent citations, numbers, or quotes. Done means inventory coverage is complete and this turn introduced no open blocker or major.