docs: update features and how it works

[raisedadead]

Summary

This is a comprehensive restructuring and expansion of the README to improve clarity, organization, and user guidance. The changes reorganize content into logical sections with better visual hierarchy and add more detailed explanations of features, workflows, and configuration options.

Key Changes

• Improved introduction: Clarified the dual CLI/TUI nature and core value proposition in the opening paragraphs
• Enhanced "Why worktrees?" section: Replaced table format with narrative explanation and ASCII diagram showing the directory structure
• Reorganized commands section: Split into separate tables for main commands, workflows, and common flags with clearer descriptions
• New dedicated sections:
  • Terminal UI — detailed keybindings and feature overview
  • Workflows — comprehensive table of workflow flags with branch templates and descriptions
  • Configuration — hierarchical config explanation with example TOML
  • Hooks — new dedicated section covering bundled hooks, setup, management, and custom hooks
  • Shell completions — moved to prominent section with setup instructions
  • JSON output — new section documenting machine-readable output format
• Improved documentation links: Reorganized and clarified cross-references to docs
• Development section: Simplified and moved to end with clearer command descriptions
• Formatting improvements:
  • Consistent use of em-dashes instead of hyphens
  • Better visual separation between sections
  • Improved code block formatting
  • Clearer emphasis on optional vs required components

Notable Details

• Added practical examples throughout (e.g., wt add --bugfix --issue 42)
• Expanded hook system documentation with environment variables and protocol reference
• Clarified configuration hierarchy and precedence
• Added JSON output envelope example for scripting use cases
• Improved navigation guidance (e.g., TUI keybindings, shell wrapper behavior)

https://claude.ai/code/session_01QoLnj9wswsduNCCcCoowhU