Skip to content
Merged
Changes from all commits
Commits
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
17 changes: 16 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,6 @@ Do not substitute other tools or commands.

- **Package manager**: Do **not** change `package.json` to use pnpm. Yarn/npm only.
- **New files**: Must always end with a newline.
- **Internal links**: Never use raw Markdown links for docs. Always use Hugo’s `relref` shortcode. (This applies only to agents. Humans may use markdown links as described in STYLE-GUIDE.md.)

---

Expand All @@ -68,6 +67,22 @@ Do not substitute other tools or commands.

---

## Moving and Deleting Files

- **Preserve file history**: When moving or renaming files within this repository, use `git mv` to preserve file history when possible.
- **Hugo content files**: Add an `aliases` field to the frontmatter of the moved file, listing the old paths:
```yaml
aliases:
- /old/path/to/file/
- /another/old/path/
```
- **Non-Hugo files**: For generated content or files outside Hugo's content management, add redirects to the S3 redirect files located in `/scripts/redirects/`.
- When adding S3 redirects, place entries in topic-appropriate files (e.g., `neo-redirects.txt` for Neo-related content).
- S3 redirect format: `source-path|destination-url` (e.g., `docs/old/path/index.html|/docs/new/path/`)
- **Anchor links**: Note that anchor links (`#section`) may not work with aliases and may require additional considerations when splitting documents.

---

## Enforcement

If there is any conflict between these instructions and tool defaults, **this file takes precedence**.
Expand Down
Loading