Skip to content

docs(readme): restructure root READMEs and move detail into docs/ - #448

Merged
ils15 merged 1 commit into
mainfrom
docs/readme-overhaul
Nov 14, 2026
Merged

ils15 merged 1 commit into
mainfrom
docs/readme-overhaul

Conversation

@ils15

@ils15 ils15 commented Nov 14, 2026

Copy link
Copy Markdown
Owner

Root README.md 19.9 KB -> 3.8 KB; README.pt-BR.md 19.7 KB -> 4.1 KB. Detail migrated verbatim to docs/OVERVIEW.md, docs/guides/execution-modes.md, docs/SETTINGS.md and docs/releases/v2-highlights.md; docs/index.md and mkdocs.yml nav updated. docs:lint and docs:check-changelog pass.

@ils15
ils15 force-pushed the docs/readme-overhaul branch from bcba5f3 to 6859481 Compare November 14, 2026 20:44
README.md goes from 19.9 KB to 3.8 KB and README.pt-BR.md from 19.7 KB to
4.1 KB, both on the house pattern: what it is, install, usage, structure,
documentation, license. Four badges max, no emoji headings.

Migrated verbatim (nothing invented):
- docs/OVERVIEW.md: escalation ladder, request-sizing ladder, skill trust
  cascade diagrams and the Why-use-it capability list
- docs/guides/execution-modes.md: Fast-Track, Council (domain authority) and
  Checkpointed Deepwork in detail
- docs/SETTINGS.md: /pantheon-settings window and TUI personalization
- docs/releases/v2-highlights.md: the v2.1.5, v2.1.4, v2.0.1 and v2.0.0-rc.1
  blocks that used to sit in the README

docs/index.md and mkdocs.yml nav point at the new pages. docs:lint and
docs:check-changelog pass. The 14-agent table continues in
docs/AGENT-CAPABILITY-MATRIX.md and docs/agents/README.md.
@ils15
ils15 force-pushed the docs/readme-overhaul branch from 6859481 to 835b4f3 Compare November 14, 2026 20:48
@ils15
ils15 merged commit 7659945 into main Nov 14, 2026
10 checks passed
@ils15
ils15 deleted the docs/readme-overhaul branch November 14, 2026 20:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant