agent.md: fix the friction a fresh agent hit on its first run

main

Commit

HighnessAtharva11h ago

A sub-agent that had only agent.md audited fastapi/typer and listed 14 friction points. This fixes the ones in the doc and the code.

  • Windows forms of the preflight and the install (py -3.11, WSL docker, Activate.ps1, PowerShell 7 and UTF-8 redirects).
  • doctor retries a network probe once, and its fix text says to rerun. agent.md says when to use --for audit.
  • top_tasks can hold fewer than 10 tasks. The summary keys, ancient, UTC ids, absolute paths and the Jev-off meaning of stale are named.
  • doctor names the env file it read.

Entire-Checkpoint: 01M4NEEKRRHFK8PB8H2F7SNNSZ

Checkpoints

Homepage and Navigation Redesign for Doc-test and Doc-audit

Claude CodeOpus 5.5
View session
Checkpoint 1

FirstRun Audit Website and Agent Integration

Claude CodeSonnet 5.5
View session
Checkpoint 1

Runs and audit pages match the plain landing: no gradient wash, no blur

Claude Code
View session
Checkpoint 1