Feat/structure polishing

[RomanEmreis]

Summary

• Updated project docs (README.md, AGENTS.md, CLAUDE.md) to match current HQ commands, runtime files, agent adapter layout, and reset/check behavior.
• Added small performance improvements:
  • cache selected spec/milestone display resolution in the HQ state watcher;
  • avoid extra TUI transcript cloning;
  • keep only the needed tail lines when building check failure summaries.
• Improved TUI status refresh so periodic state updates redraw only the status line instead of repainting the input prompt.

Type

• Bug fix
• Feature
• Enhancement
• Performance
• Documentation
• Refactor
• Security
• Breaking change

Workflow impact (if applicable)

Does this change affect the Supervisor → Executor → Reviewer flow?

• No impact
• Minor change (does not alter lifecycle semantics)
• Changes behavior of an existing step
• Introduces new state/transition

Checklist

• I added/updated tests where it makes sense
• I updated docs/examples if needed
• This change is backwards-compatible (or clearly marked as breaking)
• I ran formatting/lints locally (if applicable)

Notes for reviewers

Anything you'd like reviewers to pay extra attention to?