docs(skills): order declarations by reach

[mpyw]

Summary

• Skill: declscope-authoring gains an "Order by reach" section. Within each sequence a file already has, declarations go from the widest reach to the narrowest: other packages, other files of the package, then the namespace. Scope decides the reach, not the case of the first letter.
  • The order of kinds, and each type's grouping with its constructors and methods, stay as they are. Within each reach, the existing order stays.
  • A private helper may stay right after its users when they sit next to each other. Fields have no such exception.
  • When a change moves a declaration to another reach, the declaration moves too by default, and the report says so.
  • Nothing is reordered where the order is observable. The list gains iota, const specs with the expression omitted, var initializers with side effects, and init functions.
  • The repository's linters (decorder, funcorder) take precedence. Test files and generated files are out of scope. declscope does not check this order.
• Code: the repository's own declarations and fields are reordered to match, in 10 files. Only declarations move. No logic changes.

Verification

• A throwaway AST checker that applies the rule above reports nothing after the reorder. It reported 39 inversions before.
• mise x -- ./test_all.sh passes. Coverage is 99.0% in total. The spec stage was not run locally, since fslc was not on PATH.

🤖 Generated with Claude Code

[codecov]

Codecov Report

❌ Patch coverage is 96.96970% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 99.02%. Comparing base (cde3133) to head (d1a8b6b).

Files with missing lines	Patch %	Lines
cmd/declscope/load.go	90.00%	1 Missing ⚠️
internal/ignore.go	87.50%	1 Missing ⚠️

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #188   +/-   ##
=======================================
  Coverage   99.02%   99.02%           
=======================================
  Files          50       50           
  Lines        4214     4214           
=======================================
  Hits         4173     4173           
  Misses         41       41           

Flag	Coverage Δ
unittests	99.02% <96.96%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.