documentation: add ADR-020 console thinking indicator and implementation plans #299

Merged
david merged 1 commit from documentation/2026-08-21/console-thinking-indicator-and-implementation-plans into main 2026-08-21 02:39:00 +00:00
Owner

What these docs are for

Documents the console-output redesign (full thinking → compact indicator) and adds step-by-step implementation plans for a batch of completed/decided features.

New: ADR-020 — Console thinking indicator

  • docs/adr/020-console-thinking-indicator.md — replaces full model-thinking streaming with a two-line indicator: [HH:mm <stage>] [Thinking....] at block start, thinking done (<size>, <duration>) at block end. Deltas are suppressed (counted only); hard switch, no flag or config restores full thinking.

Amended to match ADR-020

  • docs/adr/011-console-output-live-streaming.md — decision items 2 and 4 marked as amended by ADR-020, with inline amendment notes.
  • docs/design-console-output.md — goals, chunk-state-machine table, and thinking-block rendering section updated to the indicator model.
  • AGENTS.md — ADR cross-reference now cites ADR-011 (chunk-model renderer, TTY-gated color) as amended by ADR-020.

New implementation plans (docs/implementation-plan-*.md)

Step-by-step engineering plans for: console output, enforced bash timeouts, gitignore preflight, --list-models, model banner, per-run --model override, no-code-change handling, and required PILOOP_MODEL.

No code changes — documentation only.

## What these docs are for Documents the console-output redesign (full thinking → compact indicator) and adds step-by-step implementation plans for a batch of completed/decided features. ### New: ADR-020 — Console thinking indicator - `docs/adr/020-console-thinking-indicator.md` — replaces full model-thinking streaming with a two-line indicator: `[HH:mm <stage>] [Thinking....]` at block start, `thinking done (<size>, <duration>)` at block end. Deltas are suppressed (counted only); hard switch, no flag or config restores full thinking. ### Amended to match ADR-020 - `docs/adr/011-console-output-live-streaming.md` — decision items 2 and 4 marked as amended by ADR-020, with inline amendment notes. - `docs/design-console-output.md` — goals, chunk-state-machine table, and thinking-block rendering section updated to the indicator model. - `AGENTS.md` — ADR cross-reference now cites ADR-011 (chunk-model renderer, TTY-gated color) as amended by ADR-020. ### New implementation plans (`docs/implementation-plan-*.md`) Step-by-step engineering plans for: console output, enforced bash timeouts, gitignore preflight, `--list-models`, model banner, per-run `--model` override, no-code-change handling, and required `PILOOP_MODEL`. No code changes — documentation only.
david merged commit 992e7caecf into main 2026-08-21 02:39:00 +00:00
david deleted branch documentation/2026-08-21/console-thinking-indicator-and-implementation-plans 2026-08-21 02:39:00 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
david/pi-loop!299
No description provided.