Skip to content

docs: self-healing harness design and evidence (en + ar) - #35

Merged
LinuxDevil merged 1 commit into
mainfrom
docs/self-healing-paper
Nov 9, 2026
Merged

LinuxDevil merged 1 commit into
mainfrom
docs/self-healing-paper

Conversation

@LinuxDevil

Copy link
Copy Markdown
Owner

What

  • New page self-healing-paper.mdx, "Self-healing harness: design and evidence", written in the structure of the Harness² paper: abstract, introduction, problem setting, method, system design, setup, results, analysis, limitations, related work, conclusion, appendix.
  • Two Mermaid diagrams: the cycle pipeline, and auto vs manual approval.
  • Formal Arabic version ar/self-healing-paper.mdx with the same headings and code blocks.
  • Nav: added after improve in the English and Arabic "Self-healing and improvement" groups.
  • Cross-links from improve.mdx and self-healing.mdx (en + ar), plus a "Live evidence (S29 and S30)" section on self-healing.mdx (en + ar).
  • self-healing-paper added to HAND_WRITTEN in the sync script. ar/translations.json re-recorded.

Evidence used

Archived runs in m3-notes (t7b, t7b2, e2e, s29, w0) and the SDK's docs/improve.md, docs/self-healing.md and examples/heal-benchmark on main. The page reports the S29 verdict as INCOMPLETE and lists limitations.

Note

self-healing.mdx and improve.mdx are generated from the SDK docs and are behind SDK main. The next sync will overwrite the hand-added note and links unless they also go into the SDK's docs/self-healing.md and docs/improve.md.

Checks run locally

  • npx mint validate (Node 22): passed
  • npx mint broken-links: no broken links
  • node scripts/check-translations.mjs: 78 pages, 0 problems, 0 stale
  • npm test: 3 passed

🤖 Generated with Claude Code

Adds a research-style page on the self-healing loop (design, setup,
results, ablations, limitations, related work) with Mermaid diagrams,
its formal Arabic version, nav entries, cross-links from self-healing and
improve, and the S29/S30 live-evidence note on self-healing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@LinuxDevil
LinuxDevil merged commit ddc44a4 into main Nov 9, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant