Clarify site workflow docs

Author: rgs2151

AGENTS.md

@@ -6,6 +6,14 @@ This repository contains Rudramani Singha's personal academic landing page for `
 
 The site is a Vite-powered static website. GitHub Pages deployment is Actions-only. Do not preserve or reintroduce GitHub Pages "Deploy from a branch" support.
 
+## Communication
+
+- Be professional, concise, and direct.
+- Prefer concrete status, exact commands, and file references over broad explanation.
+- Do not over-explain simple changes.
+- When correcting a mistake, state the correction plainly and move on.
+- Avoid speculative recommendations unless the user asks for options.
+
 ## Source of Truth
 
 - `index.html` is the main page and contains the current homepage content.

README.md

@@ -2,44 +2,96 @@
 
 [![Deploy Static Site](https://github.com/rgs2151/landing/actions/workflows/pages.yml/badge.svg)](https://github.com/rgs2151/landing/actions/workflows/pages.yml)
 
-This repository is a Vite-powered static website with no Jekyll dependency.
+Personal website for [singha.io](https://singha.io/).
 
-## Files
+The site is a static Vite project. Source files live in the repository; GitHub Actions builds them into `dist/` and deploys that artifact to GitHub Pages.
 
-- `index.html`: Main homepage
-- `stylesheet.css`: Main stylesheet
-- `images/`: Hero and work images
-- `scripts/`: Research notebooks and supporting artifacts
-- `tools/`: Small build helpers
-- `favicon.ico`: Site favicon at the repository root
-- `CNAME`: Custom domain mapping (`singha.io`)
+## How Publishing Works
 
-## Local Preview
+`style` is the main branch.
 
-Run from repository root:
+When you push to `style`, GitHub Actions runs:
+
+```bash
+npm ci
+npm run build
+```
+
+That creates `dist/`, uploads it as a Pages artifact, and deploys it to `singha.io`.
+
+Do not commit `dist/`. It is generated by the Action.
+
+## Local Development
+
+Install dependencies once:
 
 ```bash
 npm install
+```
+
+Start the local dev server:
+
+```bash
 npm run dev
 ```
 
-For a production preview:
+Vite will print a local URL, usually:
+
+```text
+http://localhost:5173/
+```
+
+Build locally before pushing:
 
 ```bash
 npm run build
+```
+
+Preview the production build:
+
+```bash
 npm run preview
 ```
 
-## Deployment
+## Common Workflow
 
-GitHub Pages is deployed through GitHub Actions only. Configure Pages with "GitHub Actions" as the build and deployment source.
+```bash
+git switch style
+npm run dev
+npm run build
+git status
+git add .
+git commit -m "Describe the change"
+git push
+```
 
-The workflow at `.github/workflows/pages.yml` builds the Vite site and publishes the generated `dist/` artifact on pushes to `style`. Pull requests into `style` run build validation without deploying.
+After the push, check the deployment here:
 
-## Domain
+[Deploy Static Site workflow](https://github.com/rgs2151/landing/actions/workflows/pages.yml)
 
-Custom domain is configured via `CNAME`:
+## Important Files
 
-```text
-singha.io
-```
+- `index.html`: homepage content and metadata
+- `stylesheet.css`: site styling
+- `images/`: profile and project images
+- `404.html`: custom not-found page
+- `CNAME`: custom domain, `singha.io`
+- `.github/workflows/pages.yml`: GitHub Actions build and deploy workflow
+- `tools/copy-static.mjs`: copies static Pages files into `dist/` after Vite builds
+- `AGENTS.md`: instructions for coding agents working in this repo
+
+## Deployment Settings
+
+GitHub repository settings should be:
+
+- Default branch: `style`
+- Pages source: GitHub Actions
+- Custom domain: `singha.io`
+- Pages environment: allow deployments from `style`
+
+## Notes
+
+- This repo does not use Jekyll.
+- `node_modules/` and `dist/` are ignored.
+- Node is pinned in `.node-version`.
+- The production site is made by GitHub Actions, not by manually uploading local files.