Build an agent knowledge base

Promptless updates these files automatically as it learns from your feedback. Organization admins can edit them directly, while other members have read-only access.

Access the Agent Knowledge Base

In the left sidebar, open Settings and select Agent Knowledge Base.

Recent updates by Promptless

View recent updates Promptless has made to these files based on your feedback.

Each update includes:

• Date of the update
• Files changed
• Link to the suggestion that triggered the update

This shows how your feedback shapes Promptless’s understanding of your documentation preferences.

Knowledge Base files

File	Purpose
client_instructions.md	Guidelines for how Promptless approaches documentation tasks. Updated when Promptless learns new preferences from your feedback.
default_plan_skeleton.md	Template structure for documentation plans. Updated when you provide feedback on plan organization.
client_style_guide.md	Writing style rules and conventions. If your repo includes a style guide or Vale rules, reference those files here. Promptless updates this file as it learns your style preferences from feedback.

Doc collection analysis

When you connect a docs repository, Promptless studies it as a whole—your existing documentation, the repository’s full commit history, and your public docs site—and records what it learns in a collection_analyses/ folder in the Agent Knowledge Base. Each connected docs repository gets its own subfolder. Promptless reads this analysis at the start of every documentation task, so its suggestions reflect how your product and docs actually work.

Each analysis folder contains:

File	Contents
README.md	An index of the analysis and its headline findings.
product-overview.md	What your product does, its key concepts, and terminology.
audience-and-personas.md	Who your documentation serves and what knowledge each reader is assumed to have.
content-strategy.md	Critical user journeys, where new content belongs, and gaps in your information architecture.
team-workflows.md	Patterns from your commit history, such as update cadence, authorship, and which pages tend to change together.
style-observations.md	Voice, formatting, and terminology patterns observed in your docs.

Note

These files are Promptless’s best inferences from your docs, commit history, and public site—not confirmed facts. Organization admins can edit any of them to correct or refine what Promptless assumes, and Promptless treats those edits as ground truth for future tasks.

How the analysis is generated

Promptless generates the analysis when you connect a docs repository during setup, so it reflects your documentation at that time. You can edit the analysis files anytime to correct or refine them, and Promptless treats your edits as ground truth on future tasks.

If you’ve connected Slack or Microsoft Teams, Promptless notifies you in your configured channel when the analysis finishes. Without a chat integration, the files simply populate in the Agent Knowledge Base when the analysis finishes.

Caution

If you point a collection at a different repository in your collection’s configuration, Promptless re-analyzes from scratch and replaces all six files, including any edits you’ve made. Copy anything you want to keep first.

View files

Click any file in the tree view to open it in the editor. All organization members can view these files to understand how Promptless has been configured.

When you open a file, the URL updates with a ?file=<path> query parameter for that file, so you can bookmark or share a link that opens the editor directly to it. Recipients still need their own access to your organization to open the link. Your browser’s back and forward buttons move between the files you’ve viewed.

Edit files

Note

Only organization admins can edit Agent Knowledge Base files. If you’re not an admin, you’ll see a read-only view with “View only — admins can edit” displayed instead of the Save button.

To edit a file:

1. Make your changes in the editor
2. Click Save
3. Your changes are committed directly to the repository

Caution

Switching files with unsaved changes will discard those changes. This includes switching files with your browser’s back and forward buttons.

Create files

Click the + button next to any folder to create a new file inside it, or click the new-file icon at the root to create a top-level file.

In the dialog:

1. Enter a file name (without the .md extension—Promptless adds it automatically)
2. Click Create

The file opens in the editor immediately. To create nested paths, enter nested/path/filename in the dialog—Promptless creates any intermediate folders automatically.

How Promptless uses these files

Promptless reads these files at the start of every documentation task to understand your documentation approach, product terminology, and writing style.

When you provide feedback on suggestions—through PR comments, the web interface, or Slack—Promptless may update these files to apply what it learned to future tasks.

Need help? Contact us at help@gopromptless.ai.