Guidelines

The Guidelines page lets you browse guidelines from every Project in the current Workspace. Each repository keeps its own engineering conventions. The page is read-only; the Agent creates and updates guidelines during work through the guidelines tool on fyllo-cortex, and each document keeps its Project ownership.

What guidelines are

Guidelines are a project's architecture boundaries, naming conventions, testing requirements, and similar engineering rules. They live under the repository's guidelines/**/*.md and are committed with the code. FylloCode does not ship these rules. Each Project records its own conventions as the Agent works.

An Agent-assisted evolution loop

Guidelines stay valuable only if they keep matching the real code, and that depends on a small loop the Agent drives:

• At the start of Chat / Apply: FylloCode scans guidelines/**/*.md across Workspace Projects, injects an ownership-qualified index built from each file's frontmatter, and the Agent reads the relevant document in full when needed
• Before creating a Proposal, and after Apply or direct implementation completes: the Agent is asked to consider whether this change should add or update a guideline
• Before Archive: the Agent checks again whether the completed change altered commands, architecture, testing, workflow, or data contracts, and updates the relevant guideline before archiving if so

These checkpoints reduce the need for periodic manual guideline cleanup. When the Agent follows them during each change, project conventions keep pace with real work and are less likely to drift out of date.

Page layout

The left panel groups every Workspace guideline file by Project. The right panel shows the selected document's description and body. If a document is missing valid frontmatter, the page shows a warning icon. The index then cannot tell the Agent whether the file needs to be opened, so fix the document before relying on it.

When to use it

Use this page when you want to know what convention a project has for a given area, or want to confirm whether the relevant guideline was updated after the Agent's last change. For how the guideline index gets injected into a session and the exact maintenance mode fields, see the fyllo-cortex reference.