docs: add ENG2-CONTINUE agent hand-off

[aram-devdocs]

Adds ENG2-CONTINUE.md — the entry-point/goal file for a coding agent to continue the ENG2 v2 rebuild (paste-in prompt + execution model + current state). Docs-only. 🤖 Generated with Claude Code

[claude]

Claude finished @aram-devdocs's task in 1m 9s —— View job

---

Claude finished the review

Todo list

• Gather context (AGENTS.md, changed file)
• Phase 1-2: Context & architecture validation
• Phase 3: Anti-pattern scan
• Phase 4: Quality assessment
• Phase 5: Security review (N/A — no code/FFI touched)
• Phase 6: Scope verification
• Phase 7: Post structured review

Summary

This PR adds a single new file, ENG2-CONTINUE.md (102 lines), a docs-only agent hand-off document for continuing the ENG2 v2 rebuild. No source, FFI, or SDK files are touched.

Verification performed

I cross-checked the concrete claims in the doc against the actual repo state rather than taking them at face value:

Claim in doc	Verified
docs/src/runbook/index.md, phase-index.md, perf-dod.md, testing-strategy.md, throne-sync.md, issue-template.md	✅ all exist
docs/src/runbook/phases/phase-0.md … phase-9.md	✅ all 10 present
tools/lint_layers.rs	✅ exists
AGENTS.md "55-line cap"	✅ scripts/check-agents-md.sh sets MAX_LINES=55; root AGENTS.md is 54 lines
"10 SDKs" / "10-SDK codegen parity"	✅ sdks/ has 10 language dirs (c, cpp, csharp, go, kotlin, lua, python, rust, swift, typescript)
goud_engine/tests/spec/ (spec-test convention referenced)	Directory doesn't exist yet — expected, since no ENG2 spec tests have been written yet; not a defect

I could not verify the referenced live GitHub state (issue #810, PRs #684/#685/#686/#706/#681, #677/#678/#679) from this sandbox (gh calls required approval I didn't have), so I can't confirm those numbers/statuses are currently accurate — see warning below.

Phase 2-6 (Architecture / Anti-Pattern / Security / Scope)

Not applicable — no Rust, FFI, or SDK code is touched, so there's nothing to check against the layer hierarchy, FFI safety checklist, or SDK parity rules. Comment-slop blocklist (.agents/rules/documentation-standards.md) also doesn't apply here since this isn't inline code documentation, but I checked it anyway for tone: no attribution lines, no phase/step-label narration, no AI filler — clean.

WARNINGS (non-blocking)

#

Issue

1

The "Current state (2026-07-07)" section hardcodes specific open PR numbers (#686, #706, #681) and their statuses (merge conflicts, failing CI). This is inherently a point-in-time snapshot that will go stale as soon as those PRs are resolved — a future agent reading this file could act on stale state. Not a blocker for a hand-off doc, but worth keeping in mind: the doc itself should probably be one of the first things the next agent re-verifies against live issue/PR state rather than trusting verbatim (which the doc's own instructions do direct it to do, so this is a minor internal consistency point).

Positive callouts

• Doc is well-structured: paste-in prompt is self-contained and machine-executable, with clear execution model, definition-of-done, and constraints.
• Every runbook/tooling file path referenced actually exists — no dead links.
• Correctly matches PR description (docs-only, single file).
• Encodes the repo's own guardrails (layer lint, SDK parity, clippy, AGENTS.md cap, spec-first TDD) accurately.

Verdict: APPROVED

Docs-only change, all verifiable file references check out, no scope creep, no architecture/security concerns applicable.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!