docs: Add Guided Onboarding Wizard to January 2026 changelog #192
Conversation
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
Contributor
Author
promptless
bot
requested review from
adit-chandra,
frances720,
mattlink and
prithvi2206
as code owners
Contributor
Author
Contributor
Author
Contributor
Author
Contributor
Author
Contributor
Author
Contributor
Author
Contributor
Author
Contributor
Author
Contributor
Author
![promptless[bot]](https://avatars.githubusercontent.com/in/979718?s=60&v=4){kind=small}
| * **Inline PR Citations:** Citations now appear as review comments on specific lines in your documentation PRs. See the exact source—GitHub PR, Slack message, or Jira ticket—that informed each change directly in the diff view. | ||
| * **Onboarding Wizard Enhancements:** Several improvements throughout the wizard—your docs repository is now automatically excluded when triggering on all repos, monorepo setups prompt you to select specific repositories, help links guide you to documentation when needed, and the calibration card now shows that you'll receive a Slack notification when PR replays complete. If your Slack connection doesn't complete, a recovery flow shows options to try again, continue without Slack, or contact your admin. | ||
| * **Simplified Intercom Connection:** Connecting Intercom is now a one-click OAuth flow for all users. Previously, some organizations had to manually create an app in the Intercom Developer Hub and enter an access token—now everyone connects through standard OAuth authorization. | ||
|
|
Contributor
Author
There was a problem hiding this comment.
Citation: Based on PR #1898 which changes EditProjectModal.tsx and NewProjectModal.tsx to use a <Select> dropdown for Slack notification channel instead of a free text <input>. The PR description explains the workflow when a channel doesn't appear in the dropdown.
View source
Contributor
Author
fern/docs/changelogs/2026-01.md
Outdated
|
|
||
| * **Triggers Page Search:** Search for triggers by PR info, Slack thread topic, task name, or summary text. The default view shows the last 30 days, but search retrieves matching triggers from your full history. | ||
|
|
||
| * **Read-Only GitHub App for Open Source Repos:** Connect Promptless to open source repositories where you can't install GitHub apps. The read-only app only requests read permissions—documentation PRs are created from a fork using a Promptless service account. Select "Use read-only app (for open source repos)" when connecting GitHub. |
Contributor
Author
There was a problem hiding this comment.
Citation: Fixed UI description based on the merged PR implementation. The dashboard code in promptless-dashboard/src/components/IntegrationsList.tsx shows a separate "GitHub (Read-Only)" integration section with its own GithubOssModal, not a checkbox within the standard GitHub flow.
View source
Contributor
Author
Contributor
Author
fern/docs/changelogs/2026-01.md
Outdated
| * **Review Time Estimate Accuracy:** Fixed review time estimates being inflated for repositories with mixed line endings (CRLF and LF). Estimates now accurately reflect the actual scope of documentation changes. | ||
| * **Suggestion Timestamp Display:** Fixed suggestion timestamps showing incorrect times—such as appearing hours in the future—when viewing the Change History page. | ||
| * **Agent Knowledge Base Persistence:** Fixed an issue where edits to Agent Knowledge Base files could be lost between documentation processing runs—your customizations now persist properly. | ||
| * **Fork-Based PR Creation Reliability:** Improved reliability when creating documentation PRs through the GitHub (Read-Only) integration. Promptless now automatically retries when GitHub's eventual consistency causes fork branches to be temporarily invisible during cross-repository PR creation. |
Contributor
Author
There was a problem hiding this comment.
Citation: Updated bug fix entry based on PR #1906 which revealed that the "eventual consistency" theory from PR #1903 was not the real culprit. The actual fix was using GitHub's default fork naming because GitHub's cross-repo PR API doesn't resolve head references correctly when forks have non-default names. See server/utils/sources/github_oss.py changes.
View source
Contributor
Author
| * **Onboarding Wizard Enhancements:** Several improvements throughout the wizard—your docs repository is now automatically excluded when triggering on all repos, monorepo setups prompt you to select specific repositories, help links guide you to documentation when needed, and the calibration card now shows that you'll receive a Slack notification when PR replays complete. If your Slack connection doesn't complete, a recovery flow shows options to try again, continue without Slack, or contact your admin. | ||
| * **Simplified Intercom Connection:** Connecting Intercom is now a one-click OAuth flow for all users. Previously, some organizations had to manually create an app in the Intercom Developer Hub and enter an access token—now everyone connects through standard OAuth authorization. | ||
| * **Slack Notification Channel Picker:** The Slack notification channel setting is now a dropdown showing your workspace's channels instead of a free text field—so you're always selecting a valid channel. If the channel you want doesn't appear, create it in Slack first, then refresh your channels on the Integrations page. | ||
|
|
Contributor
Author
There was a problem hiding this comment.
Citation: Based on the sidebar rename in Sidebar.tsx changing "New Task" to "Manual Trigger"
View source
Contributor
Author
| * **Inline PR Citations:** Citations now appear as review comments on specific lines in your documentation PRs. See the exact source—GitHub PR, Slack message, or Jira ticket—that informed each change directly in the diff view. | ||
| * **Onboarding Wizard Enhancements:** Several improvements throughout the wizard—your docs repository is now automatically excluded when triggering on all repos, monorepo setups prompt you to select specific repositories, help links guide you to documentation when needed, and the calibration card now shows that you'll receive a Slack notification when PR replays complete. If your Slack connection doesn't complete, a recovery flow shows options to try again, continue without Slack, or contact your admin. | ||
| * **Simplified Intercom Connection:** Connecting Intercom is now a one-click OAuth flow for all users. Previously, some organizations had to manually create an app in the Intercom Developer Hub and enter an access token—now everyone connects through standard OAuth authorization. | ||
| * **Slack Notification Channel Picker:** The Slack notification channel setting is now a dropdown showing your workspace's channels instead of a free text field—so you're always selecting a valid channel. If the channel you want doesn't appear, create it in Slack first, then refresh your channels on the Integrations page. |
Contributor
Author
There was a problem hiding this comment.
Citation: Removed the "Manual Trigger Sidebar Label" changelog entry because PR #1923 reverts the sidebar rename from PR #1916. The UI will continue showing "New Task" instead of "Manual Trigger".
View source
Contributor
Author
Contributor
Author
|
I've added new changes to address this Slack mention in commit 7e6186e |
|
|
||
| **Improvements:** | ||
|
|
||
| * **Upgraded to Claude Opus 4.5:** Documentation suggestions now use Claude Opus 4.5 for improved reasoning, analysis, and documentation context understanding. |
Contributor
Author
There was a problem hiding this comment.
Citation: Isaiah reported that Promptless response times improved from "several minutes" to "about a minute" - approximately twice as fast. He provided a screenshot showing the faster response time as evidence.
View source
Contributor
Author
| * **Cleaner Suggestion Diffs:** Fixed suggestion diffs to exclude internal system files—diffs now show only your documentation changes, making them easier to review. | ||
| * **Slack Notification Diff Files:** Fixed diff file attachments in Slack notifications—teams can now see the full diff of documentation changes directly from Slack without needing to open the PR or web interface. | ||
| * **Slack Notification Delivery:** Improved reliability of Slack notifications by automatically retrying on transient errors. Notifications that previously failed due to temporary Slack service issues (5xx errors, connection problems, rate limits) are now retried automatically. | ||
| * **Git Sync Reliability:** Improved reliability of git sync operations when Promptless pushes documentation changes—sync operations now properly wait for concurrent git processes to complete, preventing intermittent failures. |
Contributor
Author
There was a problem hiding this comment.
Citation: Bug fix in server/triggers/slack/routes.py - modified get_thread_messages() to detect bot authors via bot_id field and skip DM channel verification since bots can't DM other bots.
View source
Contributor
Author
| * **Onboarding Wizard Enhancements:** Several improvements throughout the wizard—your docs repository is now automatically excluded when triggering on all repos, monorepo setups prompt you to select specific repositories, help links guide you to documentation when needed, and the calibration card now shows that you'll receive a Slack notification when PR replays complete. If your Slack connection doesn't complete, a recovery flow shows options to try again, continue without Slack, or contact your admin. | ||
| * **Simplified Intercom Connection:** Connecting Intercom is now a one-click OAuth flow for all users. Previously, some organizations had to manually create an app in the Intercom Developer Hub and enter an access token—now everyone connects through standard OAuth authorization. | ||
| * **Slack Notification Channel Picker:** The Slack notification channel setting is now a dropdown showing your workspace's channels instead of a free text field—so you're always selecting a valid channel. If the channel you want doesn't appear, create it in Slack first, then refresh your channels on the Integrations page. | ||
|
|
Contributor
Author
There was a problem hiding this comment.
Citation: PR #1932 restricts auto-merge to commit triggers only in EditProjectModal.tsx and NewProjectModal.tsx.
View source
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.
Open this suggestion in Promptless to view citations and reasoning process
Adds a changelog entry for the new Guided Onboarding Wizard feature to the January 2026 changelog. The entry documents the 6-step wizard that walks new users through Promptless setup (Slack connection, documentation platform, triggers, context sources, agent preferences, and trial activation), including automatic progress saving and team continuity features.
Trigger Events
Help us improve Promptless — If this suggestion missed the mark, please share quick feedback.
If you want Promptless to make further changes on this PR, feel free to leave a comment tagging Promptless (It won't show up in the user drop down but Promptless will get it!)