Sections and pages
Sections and pages are the basic parts of the sitemap.
In CLEA, a section is a folder in the workspace `Sitemap` folder. A page is a markdown file inside that folder. This means the sitemap view is not only a drawing. It is a view of real workspace files.
Use sections to group intent
A section should answer one question: what kind of page belongs here?
If the answer is not clear, the section is probably too broad. Broad sections make page planning harder because every page can fit everywhere.
Better sections are direct:
| Weak section | Clearer section |
|---|---|
| SEO ideas | Problem pages |
| Marketing | Product pages |
| Content | Guides and tutorials |
| Random pages | Backlog pages |
Use pages to hold the real work
A page file can start small.
It can begin with a title, URL, description, and notes. Later it can become a full draft. Page Writer can open the same file, update the body, add JSON-LD data, and run an on-page check when a live URL exists.
Folder is section
Use folders to group page intent.
File is page
Use markdown files for each planned or existing page.
Path stays readable
Keep folder names clear for review and sync.
Page opens for work
Edit the file later in Page Writer.
Keep paths easy to understand
The folder path matters because GitHub sync keeps the path under `/clea-sitemap-expansion`.
That does not mean the folder name must be perfect forever. It means you should keep it readable. A person reviewing the repository should understand what each folder is for.
Sitemap/
Product pages/
ai-visibility-dashboard.md
Problem pages/
why-ai-tools-do-not-mention-my-brand.mdThis shape is simple, but it gives CLEA enough context to help with page writing and internal links.