Skip to content

[codex] Fix SEO agent doc references #653

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
softmarshmallow merged 1 commit into from
Apr 8, 2026
Merged

[codex] Fix SEO agent doc references #653

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions docs/AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,17 @@ We **only actively maintain** the following docs areas:
- `docs/wg/**` — working group docs (design notes, architecture, proposals, WIP)
- `docs/reference/**` — reference docs (glossary, specs, stable technical references)

## SEO frontmatter

For docs SEO/frontmatter cleanup, start with the actively maintained areas:
`docs/wg/**` and `docs/reference/**`. Avoid broad repo-wide churn across
older docs sections unless the task explicitly asks for that migration.

When adding or meaningfully editing an actively maintained doc page, prefer
frontmatter with `title`, `description`, and `keywords`. For most `wg/` and
`reference/` Markdown pages that do not use MDX/JSX features, also include
`format: md` as described below.

## Everything else

Other folders under `/docs` are **not actively managed**.
Expand Down
4 changes: 2 additions & 2 deletions editor/AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ This package is the Next.js app that powers **`grida.co`** and tenant domains (e
- `components/` should remain route-agnostic and override-friendly (see [`components/AGENTS.md`](components/AGENTS.md))
- `kits/` are stateful “drop-in widgets” that must not couple to global editor/workbench state (see [`kits/AGENTS.md`](kits/AGENTS.md))
- `scaffolds/` are feature assemblies and may bind to global/editor state
- **Stable public asset URLs**: put canonical assets under `public/` (e.g. `/brand/...png`) when you need a durable, crawlable, cache-friendly path. (If you care about image search quirks, see [`app/(www)/SEO.md`](<app/(www)/SEO.md>).)
- **Stable public asset URLs**: put canonical assets under `public/` (e.g. `/brand/...png`) when you need a durable, crawlable, cache-friendly path. (If you care about image search quirks, use the repo [`SEO skill`](../.agents/skills/seo/SKILL.md).)

## Multi-tenancy (host-based tenant routing)

Expand Down Expand Up @@ -63,7 +63,7 @@ Tenant sites are primarily accessed via **tenant domains** (e.g. `xyz.grida.site
| `(tools)` | Standalone tools | — | Tools live under `app/(tools)/tools/*`. Some tools include a local `AGENTS.md` (example: [`halftone`](<app/(tools)/tools/halftone/AGENTS.md>)). |
| `(preview)` | Embed/preview surfaces | — | Read-only previews and embed-purpose routes (often consumed by tools/playground). |
| `(library)` | Library (open assets) pages | — | Library browsing/marketing routes. |
| `(www)` | Public marketing / SEO pages | [`app/(www)/SEO.md`](<app/(www)/SEO.md>) | Public `grida.co` landing pages and SEO-first routes. |
| `(www)` | Public marketing / SEO pages | [`SEO skill`](../.agents/skills/seo/SKILL.md) | Public `grida.co` landing pages and SEO-first routes. |
| `(site)` | Public pages not SEO-first | — | Public routes that aren’t primarily marketing/SEO. |
| `(insiders)` | Insider/local-only routes | — | Local-only/internal tooling and flows. Don’t depend on these for production UX. |
| `(canvas)` | Canvas playground & dev tools | — | Canvas playground, examples, experimental canvas features, and canvas-specific dev tools (e.g. I/O, AI). |
Expand Down
Loading