docs: add AGENTS.md and update SKILL.md with blog post placement convention

Copilot · franciscojavierarceo · web-flow · commit 4d211b3cdfb8 · 2026-03-31T13:52:32.000Z
Agent-Logs-Url: https://github.com/feast-dev/feast/sessions/7e15980c-1caa-4596-acef-3a743989658a Co-authored-by: franciscojavierarceo <4163062+franciscojavierarceo@users.noreply.github.com>
diff --git a/AGENTS.md b/AGENTS.md
@@ -0,0 +1,28 @@
+# Feast - Agent Instructions
+
+This file provides instructions for AI coding agents (GitHub Copilot, Claude Code, OpenAI Codex, etc.) working in this repository.
+
+## Project Overview
+
+Feast is an open source feature store for machine learning. See `CLAUDE.md` for a full project overview and development commands.
+
+## Repository Conventions
+
+### Documentation and Blog Posts
+
+- **Blog posts must be placed in `/infra/website/docs/blog/`** — do NOT create blog posts under `docs/blog/` or any other location.
+- Blog post files must include YAML frontmatter with `title`, `description`, `date`, and `authors` fields, following the format of existing posts in that directory.
+- All other reference documentation goes under `docs/`.
+
+### Code Style
+
+- Use type hints on all Python function signatures.
+- Follow existing patterns in the module you are modifying.
+- PR titles must follow semantic conventions: `feat:`, `fix:`, `ci:`, `chore:`, `docs:`.
+- Sign off commits with `git commit -s` (DCO requirement).
+
+### Testing
+
+- Run `make test-python-unit` for unit tests.
+- Run `make lint-python` before submitting changes.
+- See `skills/feast-dev/SKILL.md` for the full development guide.
diff --git a/skills/feast-dev/SKILL.md b/skills/feast-dev/SKILL.md
@@ -71,6 +71,12 @@ cd sdk/python && python -m mypy feast
 - Add a GitHub label to PRs (e.g. `kind/bug`, `kind/feature`, `kind/housekeeping`)
 - Sign off commits with `git commit -s` (DCO requirement)
 
+## Documentation and Blog Posts
+
+- **Blog posts must be placed in `/infra/website/docs/blog/`** — do NOT place them under `docs/blog/` or elsewhere.
+- Blog post files must include YAML frontmatter with `title`, `description`, `date`, and `authors` fields matching the format of existing posts in that directory.
+- All other reference documentation (concepts, how-tos, reference pages) goes under `docs/`.
+
 ## Project Structure
 
 ```
