docs(issue-222): align skill-surface docs and final outcomes

[graysurf]

Summary

• Completes issue Plan: Repo-wide Skill Review, Simplification, and Docs Alignment #222 docs-finalization lane work by aligning root/runbook/testing docs to the final skill entrypoint surface.
• Publishes the final outcomes artifact with retained/removed entrypoint decisions and explicit migration mapping.

Scope

• Updated README.md, docs/runbooks/agent-docs/PROJECT_DEV_WORKFLOW.md, and docs/testing/script-smoke.md for current command/path and entrypoint guidance.
• Added docs/plans/skills-review-final-outcomes.md with final outcomes, removed entrypoints, and migration mapping.
• Updated CHANGELOG.md with a v2.3.8 entry for the documentation/final-outcome changes.
• Excluded: script/runtime behavior changes outside documentation and release notes.

Testing

• scripts/check.sh --docs (pass)
• scripts/check.sh --markdown (pass)
• rg -n "scripts/check.sh --all|scripts/ci/stale-skill-scripts-audit.sh --check" README.md DEVELOPMENT.md docs/testing/script-smoke.md (pass)
• bash -lc 'rg -n "(?i)\b(in progress|wip)\b" README.md skills/README.md docs/testing/script-smoke.md && exit 1 || exit 0' (pass)
• rg -n "^## (Final Outcomes|Removed Entrypoints|Migration Mapping)$" docs/plans/skills-review-final-outcomes.md (pass)
• rg -n "^\| .*\| (keep|merge|remove) \| .*\|$" docs/plans/skills-review-final-outcomes.md (pass)
• bash -lc 'rg -n "(?i)\b(sprint|in progress|wip)\b" docs/plans/skills-review-final-outcomes.md && exit 1 || exit 0' (pass)
• scripts/check.sh --all (pass)
• bash scripts/ci/stale-skill-scripts-audit.sh --check (pass)
• scripts/test.sh -m script_smoke (pass)

Issue

• Plan: Repo-wide Skill Review, Simplification, and Docs Alignment #222

[graysurf]

Decision

• Decision: merge
• Task lane: subagent-s4-t1 / issue/s4-t1-align-root-runbook-docs-to-final-skill-surface / issue-s4-t1 / per-sprint / docs(issue-222): align skill-surface docs and final outcomes #229

Review Scope

• Scope baseline: docs/plans/skills-repo-review-simplification-plan.md (Task 4.1, Task 4.2, Task 4.3, Task 4.4) + dispatch record /Users/terry/.agents/out/plan-issue-delivery/graysurf__agent-kit/issue-222/sprint-4/manifests/dispatch-S4T1.json
• PR reviewed: docs(issue-222): align skill-surface docs and final outcomes #229
• Scope exclusions checked: yes (evidence: PR is docs/changelog/outcomes artifact only; no workflow/tool/automation script runtime behavior changes)

Hard Gates

• PR linkage + lane facts: pass (evidence: issue Plan: Repo-wide Skill Review, Simplification, and Docs Alignment #222 rows S4T1/S4T2/S4T3/S4T4 all map to branch issue/s4-t1-align-root-runbook-docs-to-final-skill-surface and PR docs(issue-222): align skill-surface docs and final outcomes #229)
• PR body hygiene: pass (evidence: gh pr view 229 body includes Summary/Scope/Testing/Issue sections with Plan: Repo-wide Skill Review, Simplification, and Docs Alignment #222)
• Validation evidence present: pass (evidence: PR testing section lists docs/markdown/full-check/smoke/stale-audit and outcomes-doc regex guards)
• CI/check status: pass (evidence: gh pr checks 229 --json name,state,link reports SUCCESS for pytest, shell-and-contracts, and API test matrix)

Task Fidelity

• Scope verdict: pass (evidence: diff implements sprint-4 docs finalization outcomes in README.md, docs/runbooks/agent-docs/PROJECT_DEV_WORKFLOW.md, docs/testing/script-smoke.md, docs/plans/skills-review-final-outcomes.md, and CHANGELOG.md)

Correctness

• Correctness verdict: pass (evidence: final outcomes artifact includes explicit keep/remove/migration mapping tables; follow-up commit ee1bd46 resolves markdown line-length contract without changing semantic outcomes)

Integration Readiness

• Integration verdict: pass (evidence: PR mergeable CLEAN against plan/issue-222, checks green, and merge completes all remaining plan tasks for close-plan readiness)

Evidence Links

• Diff refs: CHANGELOG.md, README.md, docs/plans/skills-review-final-outcomes.md, docs/runbooks/agent-docs/PROJECT_DEV_WORKFLOW.md, docs/testing/script-smoke.md
• Validation refs: gh pr view 229 --json body,files; gh pr checks 229 --json name,state,link
• CI refs: pytest https://github.com/graysurf/agent-kit/actions/runs/22647768848/job/65639831042; shell-and-contracts https://github.com/graysurf/agent-kit/actions/runs/22647768848/job/65639831037
• Residual risk: low; outcomes artifact is point-in-time and must be updated when future entrypoint removals/retentions change.