Skip to content

docs: clarify that workspace .md files don't require gateway restart (#1728)#1740

Closed
darrenzeng2025 wants to merge 1 commit intosipeed:mainfrom
darrenzeng2025:fix/1728-doc-restart-note
Closed

docs: clarify that workspace .md files don't require gateway restart (#1728)#1740
darrenzeng2025 wants to merge 1 commit intosipeed:mainfrom
darrenzeng2025:fix/1728-doc-restart-note

Conversation

@darrenzeng2025
Copy link
Contributor

Description

This PR adds documentation to clarify that modifying workspace markdown files does not require a gateway restart.

Problem

Issue #1728 points out that the documentation doesn't mention whether the gateway needs to be restarted after modifying AGENTS.md and other .md files in the workspace.

Solution

Added a note in the Workspace Layout section of the configuration documentation explaining that changes to AGENTS.md, SOUL.md, USER.md, IDENTITY.md, and MEMORY.md are automatically detected at runtime via file modification time tracking. Users do not need to restart the gateway after modifying these files.

Type of Change

  • Documentation update

AI Code Generation

  • 🤖 Fully AI-generated

Related Issue

Fixes #1728

Technical Context

The code in pkg/agent/context.go shows that these files are tracked in sourcePaths() and the system uses file modification time (mtime) to automatically invalidate the system prompt cache when these files change.

Checklist

  • I have read and understood the Contributing Guide
  • My changes generate no new warnings
  • I have linked the related issue

Add a note to the configuration documentation explaining that changes
to AGENTS.md, SOUL.md, USER.md, IDENTITY.md, and MEMORY.md are
automatically detected at runtime and do not require a gateway restart.

Fixes sipeed#1728
@sipeed-bot sipeed-bot bot added type: documentation Improvements or additions to documentation domain: config labels Mar 19, 2026
@afjcjsbx
Copy link
Collaborator

Fixed in: #1747

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

domain: config type: documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Do I need restart picoclaw gateway after update AGENTS.md and other .md file in workspace.

2 participants