Диагностика и план правок README
documentation
readme-analyze-existing is a Claude Code skill that diagnoses an existing README against structured source-analysis output and produces an action list consumed by `readme-edit`. Each action belongs to one of six types — `[CUT]`, `[RELOCATE]`, `[RESTRUCTURE]`, `[REWRITE-HEADING]`, `[REORDER]`, `[ADD-CALLOUT]` — and includes the target line range, a one-sentence rationale, and replacement or destination details. The skill deliberately does not edit the README itself: separating diagnosis from application prevents the partial or inconsistent output that occurs when an agent edits as it diagnoses. Its anchoring-bias mitigation uses a two-step split — step 0(a)(i) derives a spine candidate from source alone before reading the README, and step 0(a)(ii) compares the existing README against that unbiased reference. The skill takes two arguments: the README path and the output path from `readme-analyze-source`.
- #readme
- #documentation-analysis
- #documentation-maintenance
- #structure