docs: context boundary, calibration page, runtime exception lifecycle, CLI install lifecycle - #9
Merged
sagnik11 merged 1 commit intoAug 18, 2026
Conversation
…all lifecycle - Code review: new "What Autter reads during a review" section stating the exact context layers (diff, repository index, connected knowledge) and when the isolated review sandbox is used; chat scope note on AI chat page - New Calibration page consolidating feedback signals, acted-on rate, learnings, muting, auto-demotion, verification skepticism, and reviewer training, with cross-links from ai-chat/platform-overview/configuration - New Runtime "Anatomy of an exception" page tracing a Node.js exception through capture, transport, ingest/normalize, fingerprint, storage, and issue/incident - CLI install: "What the installer changes" table, guided onboarding walkthrough, and a full Uninstall section - Runtime quickstart/installation/integrations now say instrument.cjs is created in your own app, not the cloned autter-runtime repo - Disambiguate "Runtime": generic runtime phrasing reworded, terminology note on Runtime introduction, AGENTS.md rules for "review sandbox" Generated-By: PostHog Desktop Task-Id: 6977aa7a-30ea-49a4-820b-c549b1e696ab
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Addresses a round of documentation feedback with six changes across the Documentation, Runtime, and CLI tabs.
What changed
Context boundary is now explicit.
features/code-reviewgains a "What Autter reads during a review" section stating exactly what a review reasons over — the compare diff, the repository index (walked outward from changed files, with files fetched on demand; the standard review does not clone the repo), and connected knowledge (rules, learnings, attached docs as bounded summaries) — plus when the isolated review sandbox with a full checkout is used.features/ai-chatgets a matching "What chat can read" note, andplatform-overviewlinks both.New Calibration page (
features/calibration). Consolidates content that previously lived only in a changelog entry or one-line mentions: the feedback signals Autter records, the acted-on rate on the Health tab, learnings, muting, staged auto-demotion (and how to reverse it), verification skepticism, reviewer training, and the per-repo controls. Cross-linked from ai-chat, code-review, platform-overview, and configuration.New Runtime page: "Anatomy of an exception" (
runtime/error-lifecycle). One Node.js exception traced end to end: SDK capture (handled vs. crash, always-on error pipeline), OTLP transport, ingest and normalization, fingerprinting, ClickHouse storage, and issue/incident grouping with deploy correlation. Added to the Runtime Reference group.CLI install lifecycle.
cli/installnow documents what the installer actually changes (binary, PATH mechanism, config/state files, agent integrations, Git trace2 keys, background service — and what it never touches), a step-by-step walkthrough of the guidedautter onboardflow, and a full Uninstall section including Git-notes and connected-data caveats.instrument.cjsplacement. Runtime quickstart, installation, and integrations now say the file is created in your own application (one per service in a monorepo), not in the clonedautter-runtimerepo. Companion PR: Autter-dev/autter-runtime#15."Runtime" disambiguation. Generic "runtime" phrasing on CLI and scan pages reworded to "performance"/"real behavior", a terminology note added to the Runtime introduction distinguishing the product from the review sandbox, and AGENTS.md now codifies the rule for future edits.
Notes
autter doctorsetup validation command #8 (autter doctordocs) since both touchcli/install.mdx; this PR retargets tomainautomatically when Document theautter doctorsetup validation command #8 merges.Created with PostHog Desktop