Add AGENTS and CLAUDE project guidance docs

Author: marpisco

AGENTS.MD

@@ -0,0 +1,30 @@
+# AGENTS.MD
+
+## Project
+- Personal website for `marcopisco.com`
+- Stack: TypeScript + Vite + vanilla CSS
+- Entry point: `src/main.ts`
+- Styles: `src/styles.css`
+- Static assets: `public/`
+
+## Local workflow
+- Install: `npm install`
+- Dev server: `npm run dev`
+- Type check + build: `npm run build`
+- Preview build: `npm run preview`
+
+## Deployment
+- GitHub Pages deploy is automated by `.github/workflows/deploy-pages.yml`
+- Push to `main` triggers build and deploy
+- Domain is configured by `CNAME`
+
+## Editing guidelines
+- Make focused, minimal diffs
+- Keep website responsive on desktop/mobile
+- Preserve existing Discord presence + writeups/posts behavior unless asked to change it
+- Prefer updating source files in `src/` and `public/`, not generated output in `dist/`
+
+## Validation
+- Run `npx tsc --noEmit` for quick safety check
+- If build tooling is available, run `npm run build`
+

CLAUDE.MD

@@ -0,0 +1,28 @@
+# CLAUDE.MD
+
+## Context
+- This repository is a personal portfolio site.
+- Main runtime code lives in `src/main.ts`.
+- Main styling lives in `src/styles.css`.
+- Public assets and writeups live in `public/`.
+
+## What to optimize for
+- Clean, direct implementation over overengineering
+- Strong visual consistency and responsive behavior
+- Fast iteration with small, reviewable commits
+
+## Constraints
+- Do not break existing sections: Home, About, Skills, Experience, Education, Posts, Contact
+- Keep Discord presence integration working (Lanyard websocket flow in `src/main.ts`)
+- Keep posts loading from `public/writeups/index.json`
+- Avoid changing deployment workflow unless explicitly requested
+
+## Commands
+- `npm run dev`
+- `npx tsc --noEmit`
+- `npm run build`
+
+## Commit style
+- Use concise imperative commit messages
+- Commit only files related to the requested change
+